Unggah File

Tujuan FileCopy Anchor Link

• File batch: gunakan purpose=batch untuk /v1/batches.
• File gambar/referensi: gunakan purpose=user_data atau purpose=vision untuk permintaan gambar berbasis file.
• File Anthropic: tambahkan header anthropic-beta: files-api-2025-04-14.

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"

Input File GambarCopy Anchor Link

Rute /v1/files yang sama ini dapat mengunggah file referensi gambar untuk /v1/images/edits.

• Gunakan purpose=user_data atau purpose=vision.
• Secara opsional, sertakan model untuk memilih model edit gambar; defaultnya adalah gpt-image-2.
• file_id yang dikembalikan terikat pada konfigurasi edit gambar yang dipilih dan dapat digunakan kembali di images[].file_id.

Mode API File AnthropicCopy Anchor Link

• Tambahkan anthropic-beta: files-api-2025-04-14 untuk menggunakan File Anthropic.
• Dalam mode Anthropic, unggah file asli secara langsung dan jangan kirim purpose=batch.
• file_id yang dikembalikan hanya tersedia di Workspace saat ini dan dapat digunakan kembali dalam permintaan /v1/messages.
• Jika Anda berencana untuk mereferensikan file yang diunggah dari konten pesan Anthropic, terus gunakan header asli Anthropic (x-api-key, anthropic-version, dan header beta jika diperlukan).

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

Bidang pentingCopy Anchor Link