ファイルとバッチ

バッチの作成

アップロードされたJSONLファイルからバッチを作成します。

POST
/v1/batches

概要

purpose=batch を指定してJSONLファイルをアップロードし、そのIDを input_file_id として使用します。バッチが完了すると、出力ファイルIDとエラーファイルIDが返されます。

注意事項

  • バッチ入力ファイルには purpose=batch を使用する必要があります。
  • completion_window は現在 24h です。
  • 出力順序は入力順序と異なる場合があります。各結果は custom_id で照合してください。
  • バッチアイテム内でのストリーミングはサポートされていません。
  • サポートされているアイテムのエンドポイントは /v1/chat/completions および /v1/embeddings です。/v1/responses はサポートされていません。

例

リクエスト

cURL
curl -X POST "https://api.tokenlab.sh/v1/batches" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "input_file_id": "file_abc123",
    "endpoint": "/v1/chat/completions",
    "completion_window": "24h"
  }'

バッチの料金は、同期リクエストと異なる場合があります。バッチ作成時に表示される価格と最終的な請求額を確認してください。

レスポンス例

レスポンス

200 OK
{
  "id": "batch_abc123",
  "object": "batch",
  "endpoint": "/v1/chat/completions",
  "input_file_id": "file_abc123",
  "completion_window": "24h",
  "status": "validating",
  "output_file_id": null,
  "error_file_id": null,
  "created_at": 1706000000
}

重要なフィールド

idstring
バッチID。
statusstring
バッチのステータス。
output_file_idstring|null
完了後の出力ファイルID。

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

ヘッダー

X-TokenLab-Delivery-Policy?string

リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。自動的にまず TokenLab Verified を試行し、出力、リクエストの受け入れ、または永続的なリソース作成の前に、一度だけ Official に切り替える場合があります。

指定できる値

  • "auto"
  • "verified"
  • "official"

リクエストボディ

application/json

レスポンス

application/json

application/json

application/json

application/json

application/json