エラー
On this page
エラーはJSONであり、重要なHTTPステータスを持ちます。何も静かに失敗しません。拒否されたリクエストは理由を通知します。すべてのレスポンスには X-Curriculo-Request-Id ヘッダーが含まれます。ご連絡の際にはこちらを引用してください。
エラー形式
エッジでの拒否(認証、クレジット、レート制限、リクエストサイズ超過)では、次のようになります:
{"success": false, "error": "...", "message": "..."}処理中に発生したエラーでは、次のようになります:
{"detail": "..."}リストリクエストでは、失敗したアイテムには独自のエラーが results内に含まれ、HTTPステータスは 200のままです。 バッチ処理を参照してください。.
HTTP ステータスコード
| ステータス | 意味 | 対処方法 |
|---|---|---|
400 | 入力は使用できない: 空のファイル、空のテキスト、読み取り不可またはパスワード保護されたドキュメント、不正な job_details、重複したJSONキー。レコーディングタスクの場合、2時間の最大予約に必要なクレジットが不足しています。 | ペイロードを修正するか、クレジットを追加してください。同一のバイトを再試行すると、同一のエラーが発生します。 |
401 | 「欠落したAPIトークン...」、「無効なAPIトークン。」(未知または取り消されたキー)、「APIトークンの有効期限が切れています。」、または「未知のAPIエンドポイント」が、存在しない /public/ のパスに対して発生します。 | Authorization ヘッダー、キー、およびパスを確認してください。 |
403 | キーは有効ですが、アカウントがトラフィックを提供できない: 事前に支払ったクレジットがない(「...コンソールでクレジットを購入してください。」)、アカウントが停止されている、または「アカウントのプロビジョニングが完了していない」です。 | コンソール → 請求でクレジットを追加するか、プロビジョニングが完了するまで待ちます。アカウントが停止されている場合は、当社にご連絡ください。 |
404 | 未知の job_id、または異なるアカウントによって登録されたもの。また、未知のタスクID、または外部のパスです。 /public/. | ジョブを再登録してください。IDは、作成した資格情報のスコープ内で管理されます。ベースURLを確認してください。 |
413 | サイズ上限を超えています: リクエストボディ、ドキュメント、レコーディング、バッチ長、または文字数。 | ワークロードを分割するか、レコーディングをリンクで送信してください。 のリクエストサイズ制限を参照してください。. |
422 | スキーマの検証に失敗しました: 必須フィールドが欠落しているか、名前が間違っています。また、85のサポートコード以外の翻訳言語です。 | OpenAPI の仕様と比較してください。フィールド名は大文字と小文字を区別します。 言語を参照してください。. |
429 | レート制限を超えました。 | バックオフして再試行してください。存在する場合は Retry-After を尊重してください。 |
500 | 私たちの失敗です。 | 1 回再試行してください。続く場合は、以下の情報とともにご連絡ください。 X-Curriculo-Request-Id. |
503 | 依存関係が利用できない、または機能がここでは有効になっていない場合 (たとえば、メディアのトランスクリプション)。 | バックオフを使用して再試行してください。 |
504 | 処理時間が 300 秒の制限を超えました。 | アイテムを少なくしたり、ドキュメントのサイズを小さくしたり、 の非同期レーンを使用してください。. |
[!NOTE] 失敗したリクエストは課金されません。
4xxまたは5xxは無料です。また、失敗したバックグラウンド タスクも無料です。
再試行のガイダンス
- **** 、
400、401、403、404、413、422を変更せずに再試行しないでください。まず、リクエストを修正してください。 - **** でバックオフを使用して
429で再試行し、503. - **** で1回再試行します。
500. 504で、 を使用してアイテムを少なくしたりドキュメントを小さくしたりして再送信してください。リストリクエストの場合、504エントリが返されたアイテムのみを再送信してください。- 単一の失敗したドキュメントを再送信することは常に安全です。重複したレコードや不完全なレコードを作成することはできません。
お問い合わせ
[email protected] に、時刻、操作、および X-Curriculo-Request-Id.
Updated