오류 코드 설명

오류 코드 설명

API 호출이나 사이트 사용 중 오류가 발생하면 이 문서를 참조하세요.

401 Unauthorized

의미: API Key가 무효합니다.

확인:

  1. Key가 완전히 복사되었는지 (sk-로 시작, 여분의 공백 없음)
  2. Key가 삭제되지 않았는지 API Key 관리에서 확인
  3. 환경 변수가 적용되었는지 (터미널 재시작)

403 Forbidden

의미: 해당 리소스에 접근 권한이 없습니다.

확인: Key가 비활성화되었거나 IP가 제한되었습니다. API Key 관리에서 Key 상태를 확인하세요.

404 Not Found

의미: 모델이 존재하지 않거나 경로가 잘못되었습니다.

확인:

  1. 모델명이 모델 광장과 완전히 일치하는지 (대소문자 구분)
  2. Base URL에 /v1 접미사가 있는지

429 Too Many Requests

의미: 요청이 너무 많아 속도 제한에 걸렸습니다.

해결: 몇 초 후 재시도. 고빈도 시나리오에서는 코드에 재시도 로직을 추가하세요.

잔액 부족

의미: 계정 잔액이 이번 호출에 부족합니다.

해결: 충전 페이지에서 충전하세요.

500 / 502 / 503

의미: 서버 일시적 오류입니다.

해결: 나중에 재시도하세요. 지속되면 내 양식에서 티켓을 제출하세요.