503 No available accounts

이 오류의 의미

503 Service Unavailable은 서버가 일시적으로 요청을 처리할 수 없음을 뜻합니다. AI API 중계 서비스에서 No available accounts가 붙으면 원인이 더 좁아집니다. 게이트웨이가 이용 가능한 업스트림 계정, 프로바이더, 그룹, 모델 라우트를 찾지 못했다는 뜻입니다.

401과는 다릅니다. 401은 인증 실패입니다. 503 No available accounts는 인증은 됐더라도, 그 뒤 라우팅 계층에 쓸 수 있는 출구가 없는 경우가 많습니다.

주요 원인

1. 중계 서비스의 계정 풀이 가득 찼고, 업스트림 계정이 쿨다운 중이거나, 속도 제한 중이거나, 비활성화됐거나, 일시적으로 이용할 수 없습니다.
2. 선택한 모델이 모델 단위 한도에 도달했습니다. 긴 컨텍스트, thinking, opus, 입력 토큰이 많은 요청에서 특히 그렇습니다.
3. API 키가 속한 그룹에 이용 가능한 프로바이더가 없거나, 업스트림 계정이 키와 다른 그룹에 할당되어 있습니다.
4. 서비스가 일부 라우트를 Claude Code 같은 특정 클라이언트만 쓰도록 제한하고, CC Switch, 리버스 프록시, 비공식 클라이언트를 거절합니다.
5. 셀프호스트 게이트웨이 또는 2단 프록시에 라우팅 버그가 있어, 한 업스트림에서 계정을 못 찾아도 스티키 세션이나 오류 처리가 다른 계정으로 장애 조치되지 않습니다.

해결 방법

1. 재시도 전에 30~120초 기다립니다. 503은 일시적 용량 신호로 다루고, 짧은 간격으로 계속 재시도하지 마세요.
2. 같은 Base URL, API 키, 모델로 가능한 한 작은 요청을 보냅니다. 이것도 503이면 서비스 상태, 계정 풀, 그룹, 모델 이용 가능 여부를 확인하세요.
3. 일반적인 모델을 시험합니다. 긴 컨텍스트, thinking, opus, 특수 라우트만 실패하고 일반 모델이 되면, 병목은 모델 단위 용량이나 쿨다운일 가능성이 큽니다.
4. 서비스 대시보드에서 API 키 그룹, 프로바이더 연결, 잔액, 일일 쿼터, 클라이언트 제한을 확인합니다. 키만 다시 발급해서는 이용할 수 없는 업스트림 풀이 보통 복구되지 않습니다.
5. CC Switch, 리버스 프록시, 셀프호스트 게이트웨이를 쓰면 그 계층을 한 번 우회하고 서비스 Base URL을 직접 시험하세요. 2차 라우팅, 스티키 세션, 폴백 실패가 짧은 업스트림 장애를 키울 수 있습니다.

AI API 중계 서비스 이용 시 확인 사항

로컬 도구, 설정한 중계 서비스, 그 뒤의 업스트림 계정 풀 세 층을 나눠 확인합니다.

최소 curl 요청은 성공하고 Claude Code, Codex, Cursor만 실패하면 도구 프로필, 모델 이름, 컨텍스트 길이, 클라이언트 제한을 확인하세요. 화면에 보이는 동시 실행 수가 적어도, 코딩 에이전트 호출 하나에 긴 이전 컨텍스트가 들어갈 수 있습니다.

최소 요청도 실패하면 로컬 설정이 원인이 아닐 가능성이 큽니다. API 키를 반복해 고치지 말고, 서비스 상태 페이지, 공지, 지원 창구, 계정 풀 용량을 확인하세요.

서비스를 바꿀 시점

최소 요청이 계속 503을 반환하거나, 같은 서비스에서 여러 모델을 쓸 수 없거나, 서비스 운영자가 계정 풀 포화를 인정한 경우에 서비스 변경을 검토할 수 있습니다.

한 모델만 실패하면 먼저 다른 모델이나 그룹을 시험하세요. 한 클라이언트만 실패하면 먼저 클라이언트 제한과 Base URL 설정을 확인합니다. 모든 503을 “사이트 전체가 멈췄다”고 보는 것은 성급한 진단이고, 실제 설정이나 컨텍스트 문제를 고치지 않은 채 서비스만 옮기게 될 수 있습니다.