ファイルとバッチ
ファイルのアップロード
バッチファイル、画像参照、またはAnthropic形式のファイルをアップロードします。
ファイルの用途 (File Purposes)
- バッチファイル:
/v1/batchesにはpurpose=batchを使用します。 - 画像/参照ファイル: ファイルベースの画像リクエストには
purpose=user_dataまたはpurpose=visionを使用します。 - Anthropic Files:
anthropic-beta: files-api-2025-04-14ヘッダーを追加します。
制限事項
| 用途 | 最大サイズ |
|---|---|
batch | 200 MiB |
user_data, vision | 50 MiB |
| Anthropic Files | 500 MB |
これより大きいファイルは 413 request_too_large を返します。batch、user_data、vision 以外の purpose は 400 unsupported_purpose を返します。file を含まないリクエストは 400 を返します。
batch ファイルはアップロードから24時間後に期限切れとなります。これを変更するには、フォームフィールド expires_after[anchor]=created_at および expires_after[seconds] を 3600 から 2592000 (30日間) の間で送信してください。レスポンスの expires_at フィールドに時刻が表示されます。
リクエスト
curl -X POST "https://api.tokenlab.sh/v1/files" \
-H "Authorization: Bearer sk-your-api-key" \
-F "purpose=batch" \
-F "file=@batch-input.jsonl;type=application/jsonl"画像ファイルの入力
この同じ /v1/files ルートを使用して、/v1/images/edits 用の画像参照ファイルをアップロードできます。
purpose=user_dataまたはpurpose=visionを使用してください。- オプションで
modelを含めて画像編集モデルを選択できます。デフォルトはgpt-image-2です。 - 返される
file_idは選択した画像編集設定に紐付けられ、images[].file_idで再利用可能です。
Anthropic Files API モード
- Anthropic Files を使用するには
anthropic-beta: files-api-2025-04-14を追加してください。 - Anthropic モードでは、元のファイルを直接アップロードし、
purpose=batchは送信しないでください。 - 返される
file_idは現在の Workspace 内でのみ有効であり、/v1/messagesリクエストで再利用できます。 - アップロードしたファイルを Anthropic メッセージコンテンツから参照する場合は、引き続き Anthropic ネイティブのヘッダー (
x-api-key、anthropic-version、および必要な場合はベータヘッダー) を使用してください。
レスポンス
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}重要なフィールド
batch、user_data、または vision を受け付けます。認証
BearerAuth APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
ヘッダー
Anthropic Files APIモードを使用するにはfiles-api-2025-04-14を含めてください。
リクエストボディ
multipart/form-data
レスポンス
application/json
application/json
application/json
application/json