Skip to content

ステータスコード

エンドポイントは、リクエストの成功または失敗に応じてHTTPステータス行(例: HTTP/1.1 200 OKHTTP/1.1 400 Bad Request)で適切なHTTPステータスコードを返します。一般的なステータスコードは以下の通りです:

  • 200: 成功
  • 400: 不正なリクエスト(パラメータ不足、無効なJSONなど)
  • 404: 見つかりません(モデルが存在しないなど)
  • 429: リクエストが多すぎます(例: レート制限を超えた場合)
  • 500: 内部サーバーエラー
  • 502: 不正なゲートウェイ(例: クラウドモデルに到達できない場合)

エラーメッセージ

エラーは application/json 形式で以下の構造で返され、エラーメッセージは error プロパティに含まれます:

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

ストリーミング中に発生するエラー

ストリーミング中にエラーが発生した場合、エラーは application/x-ndjson 形式で error プロパティを持つオブジェクトとして返されます。レスポンスはすでに開始されているため、ステータスコードは変更されません。

json
{"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"}