Unggah File

IkhtisarCopy Anchor Link

Endpoint ini adalah bagian dari Batch API TokenLab yang kompatibel dengan OpenAI. Pekerjaan batch menggunakan file JSONL yang diunggah, dijalankan secara asinkron, dan dapat mengembalikan file output/error di kemudian hari.

Mode File yang DidukungCopy Anchor Link

TokenLab memperlakukan /v1/files sebagai tiga mode eksplisit:

• File batch: gunakan purpose=batch untuk /v1/batches.
• File gambar/referensi: gunakan purpose=user_data atau purpose=vision untuk request gambar berbasis file.
• Mode Anthropic Files API: tambahkan anthropic-beta: files-api-2025-04-14 untuk penyimpanan file native Anthropic.

CatatanCopy Anchor Link

• File input batch harus menggunakan purpose=batch.
• completion_window saat ini adalah 24h.
• Urutan output tidak dijamin; selalu cocokkan dengan custom_id.
• Streaming tidak didukung di dalam item batch.

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"

Permintaan / ResponsCopy Anchor Link

Gunakan panel OpenAPI interaktif di atas untuk skema yang tepat.

Tips OperasionalCopy Anchor Link

• Gunakan custom_id untuk rekonsiliasi downstream yang idempotent.
• Harapkan output_file_id dan error_file_id hanya setelah pekerja menyelesaikan batch.

Input file gambarCopy Anchor Link

Route /v1/files yang sama juga dapat mengunggah file gambar referensi untuk /v1/images/edits.

• Gunakan purpose=user_data atau purpose=vision.
• Opsional, sertakan model untuk memilih model edit gambar; default-nya adalah gpt-image-2.
• file_id yang dikembalikan diikat ke konfigurasi edit gambar yang dipilih dan dapat digunakan ulang di images[].file_id.

Mode Anthropic Files APICopy Anchor Link

Rute /v1/files yang sama ini juga mendukung jalur Anthropic Files API.

• Tambahkan header anthropic-beta: files-api-2025-04-14 untuk beralih ke mode Anthropic.
• Dalam mode Anthropic, unggah file asli secara langsung dan jangan kirim purpose=batch.
• file_id yang dikembalikan akan terikat ke workspace kompatibel Anthropic yang sama dan harus digunakan kembali dalam permintaan /v1/messages.
• Jika Anda berencana merujuk file yang diunggah ini dalam konten pesan Anthropic, tetap gunakan header native Anthropic (x-api-key, anthropic-version, dan beta header bila diperlukan).

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

Field pentingCopy Anchor Link