# エラー (/ja/docs/concepts/errors)

HTTPステータスコード、エラーレスポンスの形式、再試行すべきエラー。



エラーは2xx以外のステータスと、OpenAI形式のJSON本文で返されます。

```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`が含まれます。

## ステータスコード [#status-codes]

| ステータス                                            | 意味                                                                                                                                                                              | 対処                                                                                                                                     |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `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`にしてください。[サンプリングパラメーターの制限](/ja/docs/concepts/models#sampling-limits)を参照してください。 |
| `401`                                            | キーがないか、無効、期限切れ、または利用上限に達しています。                                                                                                                                                  | コンソールでキーを確認してください。                                                                                                                     |
| `403`                                            | キーの許可リスト（モデルまたはIPアドレス）で許可されていないか、残高が不足しています。                                                                                                                                    | キーの設定を見直すか、チャージしてください。                                                                                                                 |
| `429`                                            | リクエストが多すぎます。                                                                                                                                                                    | 指数バックオフで再試行してください。[レート制限](/ja/docs/concepts/rate-limits)を参照してください。                                                                     |
| `503`（`code: model_not_found`）                   | このモデルIDを提供しているアップストリームがありません。                                                                                                                                                   | [カタログ](/ja/models)でモデルIDを確認してください。                                                                                                     |
| `500`、`502`、`503`、`504`                          | ゲートウェイまたはアップストリームのプロバイダーで障害が発生しました。                                                                                                                                             | バックオフしながら再試行してください。                                                                                                                    |

モデルに届く前に`4xx`で拒否されたリクエストには課金されません。

## リクエストID [#request-ids]

すべてのレスポンスに`X-Oneapi-Request-Id`ヘッダーが含まれ、エラーメッセージにも同じIDが記載されます。[サポート](/ja/docs/support)へお問い合わせの際は、このIDをお知らせください。