ファイルとバッチ
バッチの作成
アップロードされたJSONLファイルからバッチを作成します。
概要
purpose=batch を指定してJSONLファイルをアップロードし、そのIDを input_file_id として使用します。バッチが完了すると、出力ファイルIDとエラーファイルIDが返されます。
注意事項
- バッチ入力ファイルには
purpose=batchを使用する必要があります。 completion_windowは現在24hです。- 出力順序は入力順序と異なる場合があります。各結果は
custom_idで照合してください。 - バッチアイテム内でのストリーミングはサポートされていません。
- サポートされているアイテムのエンドポイントは
/v1/chat/completionsおよび/v1/embeddingsです。/v1/responsesはサポートされていません。
例
リクエスト
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"
}'バッチの料金は、同期リクエストと異なる場合があります。バッチ作成時に表示される価格と最終的な請求額を確認してください。
レスポンス
{
"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