시작하기
오류
Modelflare가 반환한 HTTP 상태 코드와 JSON 오류 개체를 읽습니다.
실패한 요청은 error 객체와 함께 JSON을 반환합니다. HTTP 상태는 첫 번째 신호입니다. message 및 code 필드는 실제 실패를 나타냅니다.
{ "error": { "message": "Invalid API key provided.", "type": "authentication_error", "code": "invalid_api_key" }}공통 상태 코드
섹션 제목: “공통 상태 코드”| 상태 | 일반적인 원인 |
|---|---|
400 |
잘못된 JSON, 지원되지 않는 필드 또는 모델의 잘못된 엔드포인트 |
401 |
API 키가 누락되었거나 유효하지 않습니다. |
403 |
키가 이 모델 또는 그룹을 사용할 수 없거나, 계정이 요청 비용을 지불할 수 없습니다 |
404 |
알 수 없는 경로 또는 누락된 작업 |
429 |
비율 제한 |
499 |
클라이언트가 요청을 취소했습니다. |
5xx |
서비스 제공업체 또는 게이트웨이 오류 |
잘못된 프로토콜로 전송된 이미지 및 비디오 요청은 unsupported_endpoint과 함께 400을 반환하고 필요한 API의 이름을 지정합니다. 자동 프로토콜 변환은 텍스트 모델에만 적용됩니다.
잔액과 예산
섹션 제목: “잔액과 예산”계정이 요청 비용을 지불할 수 없으면 게이트웨이는 모델을 호출하기 전에 403를 반환합니다. 원인이 해결될 때까지는 재시도해도 소용없습니다.
code |
원인 |
|---|---|
insufficient_user_quota |
잔액이나 구독으로 요청의 예상 비용을 충당할 수 없습니다. 기업 멤버의 경우 공유 기업 잔액이 해당됩니다. |
enterprise_member_budget_exhausted |
기업 멤버가 기업이 할당한 예산을 모두 사용했습니다. 기업 계정을 참고하세요. |
더 긴 진단, 재시도 및 대체는 AI API 오류 문제 해결부터 시작하여 기본 사이트의 기술 문서에 속합니다.