상태 코드

엔드포인트는 요청의 성공 또는 실패에 따라 HTTP 상태 라인(예: HTTP/1.1 200 OK 또는 HTTP/1.1 400 Bad Request)에 적절한 HTTP 상태 코드를 반환합니다. 일반적인 상태 코드는 다음과 같습니다:

• 200: 성공
• 400: 잘못된 요청 (누락된 매개변수, 유효하지 않은 JSON 등)
• 404: 찾을 수 없음 (모델이 존재하지 않음 등)
• 429: 요청이 너무 많음 (예: 속도 제한을 초과한 경우)
• 500: 내부 서버 오류
• 502: 불량 게이트웨이 (예: 클라우드 모델에 연결할 수 없는 경우)

오류 메시지

오류는 다음과 같은 구조의 application/json 형식으로 반환되며, 오류 메시지는 error 속성에 포함됩니다:

{
  "error": "the model failed to generate a response"
}

스트리밍 중 발생하는 오류

스트리밍 중에 오류가 발생하면 해당 오류는 error 속성이 포함된 application/x-ndjson 형식의 객체로 반환됩니다. 응답이 이미 시작되었기 때문에 응답의 상태 코드는 변경되지 않습니다.

{"model":"gemma4","created_at":"2025-10-26T17:21:21.196249Z","response":" Yes","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:21:21.207235Z","response":".","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:21:21.219166Z","response":"I","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:21:21.231094Z","response":"can","done":false}
{"error":"an error was encountered while running the model"}