エラー
HTTPステータスコード、エラーレスポンスの形式、再試行すべきエラー。
エラーは2xx以外のステータスと、OpenAI形式のJSON本文で返されます。
{
"error": {
"message": "Invalid token (request id: 2026100912391754811973...)",
"type": "new_api_error",
"code": ""
}
}エラー処理の分岐にはHTTPステータスを使ってください（error.codeが空でない場合は併用できます）。messageは表示用のテキストで、内容が変わることがあります。
リクエストの受け付け後にアップストリームのプロバイダーが返したエラーは、そのプロバイダー独自の形式で返されることがあります。/v1/messagesではAnthropic形式の{ "type": "error", "error": { "type": "...", "message": "..." } }です。どちらの形式にもerror.messageが含まれます。
ステータスコード
| ステータス | 意味 | 対処 |
|---|---|---|
400 | リクエストの形式が正しくありません。 | リクエスト本文を修正してください。 |
kimi-k3で400（code: invalid_parameter_error） | このモデルは決まったサンプリング値しか受け付けませんが、クライアントがほかの値を送っています。よくあるのはtemperature 0.7やtop_p 0.9といったデフォルト値です。メッセージにパラメーター名が出ます：Parameter 'temperature'=0.7 is not supported for kimi-k3 model. | temperatureとtop_pを送らないか、temperatureを1、top_pを0.95にしてください。サンプリングパラメーターの制限を参照してください。 |
401 | キーがないか、無効、期限切れ、または利用上限に達しています。 | コンソールでキーを確認してください。 |
403 | キーの許可リスト（モデルまたはIPアドレス）で許可されていないか、残高が不足しています。 | キーの設定を見直すか、チャージしてください。 |
429 | リクエストが多すぎます。 | 指数バックオフで再試行してください。レート制限を参照してください。 |
503（code: model_not_found） | このモデルIDを提供しているアップストリームがありません。 | カタログでモデルIDを確認してください。 |
500、502、503、504 | ゲートウェイまたはアップストリームのプロバイダーで障害が発生しました。 | バックオフしながら再試行してください。 |
モデルに届く前に4xxで拒否されたリクエストには課金されません。
リクエストID
すべてのレスポンスにX-Oneapi-Request-Idヘッダーが含まれ、エラーメッセージにも同じIDが記載されます。サポートへお問い合わせの際は、このIDをお知らせください。