Langsung ke konten utama

​
Ikhtisar

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 Didukung

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.

​
Catatan

  • 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.

​
Contoh

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 / Respons

Gunakan panel OpenAPI interaktif di atas untuk skema yang tepat.

​
Tips Operasional

  • Gunakan custom_id untuk rekonsiliasi downstream yang idempotent.
  • Harapkan output_file_id dan error_file_id hanya setelah pekerja menyelesaikan batch.
  • Harga batch mungkin berbeda dari harga sinkron karena aturan diskon isBatchRequest=true berlaku.

​
Input file gambar

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 API

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 channel/workspace Anthropic resmi 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).

​
Contoh respons

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

​
Field penting

​
id
string
Identifier file yang dipakai API terkait.
​
purpose
string
Purpose yang diberikan ke file. Upload menerima batch, user_data, atau vision.
​
bytes
integer
Ukuran file dalam byte.