バッチタスクの管理
非同期の一括リクエストを送信し、バッチ実行状態を確認します。
OpenAI 互換の Batch API を使用して、サポートされているモデルエンドポイント全体で非同期一括リクエストを送信します。
POST
/openai/v1/batchesリクエストボディ
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
input_file_id | string | はい | 目的が batch に設定されたアップロード済みファイルの識別子。 |
endpoint | string | はい | ターゲットエンドポイント(/v1/chat/completions、/v1/completions、/v1/responses、または /v1/embeddings)。 |
completion_window | string | はい | 完了ウィンドウ。現在は 24h に固定されています。 |
metadata | object | いいえ | 追跡および監査用の任意のキーと値のペア。 |
入力ファイルは最大 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}/cancelvalidating:入力ファイル形式、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を推奨します。