概念
エラーレスポンス
一般的なHTTPステータスコード、OpenAI互換エラー、非同期タスクエラー。
TENSORAXISは、使用しているAPIスタイルに合わせたエラー形式を返そうとします。OpenAI互換APIは通常errorオブジェクトを返し、非同期タスクAPIは通常code、message、dataを返します。
OpenAI互換エラー
{
"error": {
"message": "invalid request",
"type": "invalid_request_error",
"param": "",
"code": "invalid_request"
}
}フィールド:
| フィールド | 説明 |
|---|---|
error.message | 人間が読めるエラーメッセージ |
error.type | TENSORAXISまたはアップストリームプロバイダーからのエラータイプ |
error.param | 関連するリクエストパラメータ(利用可能な場合) |
error.code | エラーコード。通常messageより安定しています |
非同期タスクエラー
動画、音楽、画像生成などの非同期タスクAPIは、以下を返す場合があります:
{
"code": "invalid_request",
"message": "prompt is required",
"data": null
}動画生成では、promptが欠落していることが一般的なリクエストエラーです。アップストリームのVolcengineスタイルのトップレベルcontent[]ボディを直接/v1/video/generationsに送信すると、TENSORAXISはpromptフィールドを読み取れず、400 prompt is requiredを返します。
一般的なHTTPステータスコード
| ステータス | 意味 | 一般的な対処法 |
|---|---|---|
400 | 無効なボディ、パラメータ、またはモデル形式 | JSON、必須フィールド、モデル名を確認してください |
401 | 認証に失敗 | トークンと認証ヘッダーを確認してください |
403 | 権限またはクォータの問題 | トークンのスコープ、アカウントのクォータ、グループのアクセス権を確認してください |
404 | リソースが見つかりません | モデル名、タスクID、パスを確認してください |
429 | レート制限を超過 | 同時実行数を減らす、後で再試行する、またはトークン/グループの制限を調整してください |
5xx | サーバーまたはアップストリームのエラー | 後で再試行してください。問題が続く場合はサポートにお問い合わせください |
自動化されたクライアントの場合、完全なmessageテキストを照合するのではなく、HTTPステータスコードとcodeの値で分岐処理してください。メッセージはアップストリームプロバイダー、言語、デプロイ設定によって異なる場合があります。