エラーとレート制限の処理

記載されているエラーは、いずれも同じ 3 フィールドの JSON 構造で返ります。

{
  "code": "invalid_param",
  "message": "user is required",
  "status": 400
}

status は HTTP ステータスと同じ値です。code は分岐処理に使える安定した識別子で、message は人間が読むための詳細です。各エンドポイントページには、返る可能性のある code がすべて記載されています。

ステータスクラスの概要

ステータス	意味	主な `code`
400	リクエストまたはアプリの設定が無効	`invalid_param`、`bad_request`、`app_unavailable`、プロバイダーエラー（後述）
401	API キーの欠落または無効	`unauthorized`
403	このキーでは実行できない操作（アクセス制限）	`forbidden`
404	リソースが存在しないか、このキーまたは `user` からは見えない	`not_found`
413 / 415	ファイルが大きすぎるか、サポート外のタイプ	`file_too_large`、`unsupported_file_type`
429	このアプリへの同時リクエストが多すぎる	`too_many_requests`
500	Dify 側での失敗	`internal_server_error`

よくある 2 つの 400 code は、リクエストではなくアプリのモデル設定の問題を示します。

これらのエラーは再試行しても解決しません。Dify でアプリのモデル設定を修正してください。

429 の code は too_many_requests で、同時実行数の上限を示します。このアプリへの同時リクエストが今は多すぎる状態です。バックオフして再試行してください。

ストリームが開いた時点で、HTTP ステータスはすでに 200 です。失敗は error イベントとして届き、ストリームを終了させます。イベントの code の値はこのページに記載のものと同じで、同じルールで分類できます。詳細はストリーミングレスポンスの処理を参照してください。