ファイルとバッチ
ファイルコンテンツの取得
アップロード済みファイルの元のコンテンツをダウンロードします。
概要
このエンドポイントは主に、TokenLab の OpenAI 互換 Batch API のファイル内容取得を対象としています。
リクエストが Anthropic Files 互換モードを選ぶ場合、同じルートはバインドされたワークスペースに保存された元のファイル内容もプロキシできます。
Anthropic ヘッダーがない場合、このルートはバッチファイル内容をダウンロードします。プロバイダーがファイル内容取得に対応している場合は、紐付いた画像/参照ファイルの内容もプロキシします。
注意事項
- バッチ入力ファイルは
purpose=batchを使用する必要があります。 - 生成された出力ファイルに絞り込むには
purpose=batch_outputを使用してください。 completion_windowは現在24hです。- 出力の順序は保証されていません。常に
custom_idで一致させてください。 - バッチアイテム内でのストリーミングはサポートされていません。
リクエスト
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123/content" \
-H "Authorization: Bearer sk-your-api-key" \
--output batch-output.jsonlリクエスト / レスポンス
正確なスキーマについては、上記のインタラクティブなOpenAPIパネルを使用してください。
操作のヒント
- 冪等性のある下流の調整には
custom_idを使用してください。 - ワーカーがバッチを最終化した後にのみ
output_file_idとerror_file_idを期待してください。
コンテンツタイプ
バッチファイルの内容は JSONL またはプレーンテキストで返されます。TokenLab が作成した画像参照の内容は、背後のファイルプロバイダーが取得をサポートしている場合にバイナリコンテンツとしてプロキシできます。
レスポンス
{"custom_id":"request-1","response":{"status_code":200,"body":{"id":"chatcmpl_abc123"}}}
{"custom_id":"request-2","error":{"code":"invalid_request_error","message":"Invalid model"}}重要フィールド
bodybinary|string
ファイルの内容です。
Content-Type に従って保存または解析し、JSONL は 1 行ずつ解析してください。custom_idstring
バッチ入力項目と結果を対応付ける ID です。
認証
BearerAuth AuthorizationBearer <token>
APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
パスパラメータ
file_id*string
レスポンス
text/plain
application/json