バッチタスクの管理

非同期の一括リクエストを送信し、バッチ実行状態を確認します。

OpenAI 互換の Batch API を使用して、サポートされているモデルエンドポイント全体で非同期一括リクエストを送信します。

POST/openai/v1/batches

リクエストボディ

フィールド型必須説明
input_file_idstringはい目的が batch に設定されたアップロード済みファイルの識別子。
endpointstringはいターゲットエンドポイント(/v1/chat/completions、/v1/completions、/v1/responses、または /v1/embeddings)。
completion_windowstringはい完了ウィンドウ。現在は 24h に固定されています。
metadataobjectいいえ追跡および監査用の任意のキーと値のペア。

入力ファイルは最大 50,000 項目、ファイルサイズ 200 MiB 以下の UTF-8 JSONL 形式である必要があります。各行は一意の非空 custom_id、POST メソッド、バッチの endpoint と一致する url、およびオブジェクト型の body(厳格な前払いバッチでは model が必須)を含む有効な JSON オブジェクトである必要があります。ネイティブの前払いバッチでは、資金受付前に保存ファイルのチェックサムと実行ポリシーを検証し、プロバイダーへの送信前にすべての項目引当がアトミックに確定されます。合計残高が不足している場合は部分送信を行わず HTTP 402 を返します。互換性のないプロバイダー構成を同一バッチ内で分割することはできず、項目レベルのプロバイダー間フェイルオーバーは行われません。

バッチのライフサイクル

GET/openai/v1/batches/{batch_id}
POST/openai/v1/batches/{batch_id}/cancel
  • validating:入力ファイル形式、JSONL 構文、および項目スキーマへの準拠を検証します。
  • in_progress:割り当てられたプロバイダー認証情報に対してバッチ推論を実行します。
  • finalizing:推論出力を集計し、使用量決済を記録します。
  • completed:処理が正常に完了し、output_file_id および任意の error_file_id を生成します。
  • failed:ファイル検証またはバッチ調整が完全に失敗した場合の終了エラー状態。
  • cancelling:リクエストに応じて処理を安全に停止し、キャンセル状態へ移行します。
  • cancelled:バッチ処理が完了前に停止された状態。失敗、キャンセル、または欠落した結果項目はプロバイダーコストゼロを証明するものではなく、決済ではプロバイダー記録との照合のために引当資金が保持されます。AnyInt における標準ステータスは cancelled です。
  • expired:24 時間の完了ウィンドウを超過した場合にトリガーされます。未確認の実行は照合が必要であり、プロバイダー費用ゼロを保証するものではありません。

バッチ操作と成果物のダウンロード

GET/openai/v1/batches
  • バッチ一覧表示:GET /openai/v1/batches で認可された組織またはプロジェクトのアクティブおよび過去のバッチジョブを照会します。
  • オブジェクトストレージとダウンロード:purpose: "batch" のファイル受付とバッチ実行には共有オブジェクトストレージ(OBJECT_STORE_MODE)が必要です。処理完了後、出力結果およびエラー JSONL ファイルは GET /openai/v1/files/{file_id}/content からダウンロードできます。

互換エイリアス

  • ゲートウェイは下位互換性のため /v1/batches を受け入れます。新規統合には /openai/v1/batches を推奨します。