メインコンテンツへスキップ

​
概要

このエンドポイントは主に、TokenLab の OpenAI 互換 Batch API ファイルオブジェクトを対象としています。 リクエストが Anthropic Files 互換モードを選ぶ場合、同じルートはバインドされたワークスペース向けの Anthropic スタイルのファイルメタデータも返せます。 Anthropic ヘッダーがない場合、このルートはバッチファイルオブジェクトまたは TokenLab の画像/参照ファイルオブジェクトを返します。

​
注意事項

  • バッチ入力ファイルはpurpose=batchを使用する必要があります。
  • 生成された出力ファイルに絞り込むには purpose=batch_output を使用してください。
  • completion_windowは現在24hです。
  • 出力の順序は保証されていません。常にcustom_idで一致させてください。
  • バッチアイテム内でのストリーミングはサポートされていません。

​
例

curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

​
リクエスト / レスポンス

正確なスキーマについては、上記のインタラクティブなOpenAPIパネルを使用してください。

​
操作のヒント

  • 冪等性のある下流の調整にはcustom_idを使用してください。
  • ワーカーがバッチを最終化した後にのみoutput_file_idとerror_file_idを期待してください。
  • バッチの価格は、isBatchRequest=trueの割引ルールが適用されるため、同期価格とは異なる場合があります。

​
レスポンス例

{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

​
重要フィールド

​
id
string
関連 API で使う file identifier です。
​
filename
string
元のファイル名または生成されたファイル名です。
​
purpose
string
所有するワークフローで使われるファイル purpose です。例: batch、batch_output、user_data、vision。