에러 응답 형식
모든 에러는 다음 형식으로 반환됩니다:HTTP 상태 코드
| 코드 | 의미 | 설명 |
|---|---|---|
| 200 | OK | 성공 |
| 400 | Bad Request | 요청 형식 오류, 필수 필드 누락 |
| 401 | Unauthorized | API 키 누락, 유효하지 않은 키, 만료된 키 |
| 402 | Payment Required | 크레딧 부족 |
| 403 | Forbidden | Open API 비활성화 테넌트, 스코프 부족, 테넌트 비활성 |
| 404 | Not Found | 모델을 찾을 수 없음 |
| 409 | Conflict | 중복 리소스 (동일 이름의 키 등) |
| 429 | Too Many Requests | Rate limit 초과 |
| 500 | Internal Server Error | 서버 내부 오류 |
| 502 | Bad Gateway | RAG 서비스 연결 실패 |
인증 에러 (401)
Authorization: Bearer {KEY}헤더가 올바른지 확인- 키가 폐기 또는 만료되지 않았는지 확인
- 테넌트 관리자에게 새 키 발급 요청
권한 에러 (403)
- 어드민에서 해당 테넌트의 Open API 활성화 여부 확인
- 키의 스코프에 필요한 권한이 포함되어 있는지 확인
크레딧 에러 (402)
- 어드민에서 테넌트 크레딧 잔액 확인
- 크레딧 충전 요청
문제 해결 체크리스트
API 키가 작동하지 않습니다
API 키가 작동하지 않습니다
- 키가 만료되지 않았는지 확인 (Open API 페이지에서 상태 확인)
- 키가 폐기되지 않았는지 확인
- 어드민에서 테넌트 Open API가 활성화되어 있는지 확인
Authorization: Bearer형식이 올바른지 확인 (Bearer 뒤에 공백 필수)
모델을 찾을 수 없습니다
모델을 찾을 수 없습니다
- 어드민에서 해당 테넌트에
Open API타입 모델이 생성되어 있는지 확인 - 모델 이름이 정확한지 확인 (대소문자 구분)
- 모델이 활성 상태인지 확인
스트리밍이 동작하지 않습니다
스트리밍이 동작하지 않습니다
"stream": true가 요청 본문에 포함되어 있는지 확인- 클라이언트가 SSE (Server-Sent Events) 파싱을 지원하는지 확인
Accept: text/event-stream헤더 추가 시도