메인 콘텐츠로 건너뛰기

​
에러 응답 구조

{
  "error": {
    "code": "INVALID_INPUT_TYPE",
    "message": "이 API는 TEXT 타입만 지원합니다. IMAGE 타입 데이터가 포함되어 있습니다.",
    "type": "invalid_request_error",
    "param": "messages[0].content"
  }
}

​
에러 코드 목록

HTTPCode원인조치
400INVALID_INPUT_TYPEAPI에 바인딩된 InputType과 데이터 타입 불일치.올바른 타입을 전송하거나, 해당 InputType에 바인딩된 API 사용.
400SETTINGS_VIOLATIONmax_text_length, max_file_size, allowed_file_type 초과.콘텐츠 축소 또는 요청 분할.
400INVALID_REQUESTJSON 형식 오류, messages 누락 등.페이로드 검증.
401UNAUTHORIZEDAuthorization 헤더 누락 또는 유효하지 않음.Bearer Token 확인.
403API_INACTIVEAPI Key가 비활성화 또는 폐기됨.Citadel에서 Key 순환.
404API_NOT_FOUND{api-id}가 존재하지 않음.관리자에게 URL 확인 요청.
500POLICY_NOT_FOUND바인딩된 Guard Policy를 로드할 수 없음.관리자에게 문의.
502GUARDIAN_ERRORGuardian 내부 에러.Exponential Backoff으로 재시도.
503GUARDIAN_UNAVAILABLEGuardian 일시 불가.Exponential Backoff으로 재시도.

​
재시도 전략

Code재시도 여부
400, 401, 403, 404불가 — 요청 또는 Key를 수정.
500, 502, 503가능 — Exponential Backoff, 최대 3회.