에러 코드

빌링AI API가 반환하는 HTTP 에러 코드와 해결 방법입니다. 모든 에러 응답은 JSON 형식으로 상세 메시지를 포함합니다.

에러 응답 형식

{
  "error": {
    "code": 401,
    "type": "authentication_error",
    "message": "유효하지 않은 API Key입니다."
  }
}

400

요청 파라미터가 잘못되었습니다. 필수 파라미터 누락, 잘못된 타입, 유효하지 않은 값 등이 원인입니다.

해결 방법

요청 본문의 JSON 형식과 파라미터 값을 확인하세요. 특히 model, messages 등 필수 파라미터가 올바르게 포함되어 있는지 확인합니다.

401

인증에 실패했습니다. API Key가 없거나, 유효하지 않거나, 만료되었습니다.

해결 방법

Authorization 헤더에 유효한 API Key가 "Bearer sk-proj-..." 형식으로 포함되어 있는지 확인하세요. API Key가 대시보드에서 활성 상태인지도 확인합니다.

402

크레딧이 부족합니다. 요청을 처리하기 위한 잔여 크레딧이 없습니다.

해결 방법

대시보드에서 크레딧 잔액을 확인하고 충전하세요. 구독 플랜 업그레이드도 고려해볼 수 있습니다.

403

접근 권한이 없습니다. 해당 리소스에 대한 접근이 차단되었습니다.

해결 방법

API Key의 권한 범위를 확인하세요. 프로젝트 단위 Key인 경우 해당 프로젝트의 모델 접근 권한을 확인합니다.

404

요청한 리소스를 찾을 수 없습니다. 존재하지 않는 모델 ID, 작업 ID 등이 원인입니다.

해결 방법

모델 ID가 올바른지 확인하세요. 지원 모델 목록은 API 문서의 각 카테고리 페이지에서 확인할 수 있습니다.

429

요청 제한을 초과했습니다. 짧은 시간에 너무 많은 요청을 보냈습니다.

해결 방법

요청 간격을 늘리거나, 지수 백오프(exponential backoff) 전략을 적용하세요. 구독 플랜에 따라 요청 한도가 다릅니다.

500

서버 내부 오류가 발생했습니다. 빌링AI 또는 업스트림 AI 제공자의 일시적 문제입니다.

해결 방법

잠시 후 다시 시도하세요. 문제가 지속되면 support@billing-ai.kr로 문의해주세요.

문서에서 해결되지 않는 문제가 있다면 doublezero332@gmail.com으로 문의해주세요. 에러 응답의 전체 JSON과 요청 정보를 함께 보내주시면 더 빠른 지원이 가능합니다.