ステータスコード
エンドポイントは、リクエストの成功または失敗に応じてHTTPステータス行(例: HTTP/1.1 200 OK や HTTP/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"}