오류 코드 설명
API 호출이나 사이트 사용 중 오류가 발생하면 이 문서를 참조하세요.
401 Unauthorized
의미: API Key가 무효합니다.
확인:
- Key가 완전히 복사되었는지 (
sk-로 시작, 여분의 공백 없음) - Key가 삭제되지 않았는지 API Key 관리에서 확인
- 환경 변수가 적용되었는지 (터미널 재시작)
403 Forbidden
의미: 해당 리소스에 접근 권한이 없습니다.
확인: Key가 비활성화되었거나 IP가 제한되었습니다. API Key 관리에서 Key 상태를 확인하세요.
404 Not Found
의미: 모델이 존재하지 않거나 경로가 잘못되었습니다.
확인:
- 모델명이 모델 광장과 완전히 일치하는지 (대소문자 구분)
- Base URL에
/v1접미사가 있는지
429 Too Many Requests
의미: 요청이 너무 많아 속도 제한에 걸렸습니다.
해결: 몇 초 후 재시도. 고빈도 시나리오에서는 코드에 재시도 로직을 추가하세요.
잔액 부족
의미: 계정 잔액이 이번 호출에 부족합니다.
해결: 충전 페이지에서 충전하세요.
500 / 502 / 503
의미: 서버 일시적 오류입니다.
해결: 나중에 재시도하세요. 지속되면 내 양식에서 티켓을 제출하세요.