Berkas & batch

Ambil Isi File

Unduh konten asli dari file yang diunggah.

GET
/v1/files/{file_id}/content

Ikhtisar

Endpoint ini terutama melayani pengambilan konten file Batch API TokenLab yang kompatibel dengan OpenAI.

Ketika request memakai mode kompatibilitas Anthropic Files, route yang sama juga dapat memproksi konten file asli yang tersimpan untuk workspace yang terikat.

Tanpa header Anthropic, route ini mengunduh konten file batch atau mem-proxy konten file gambar/referensi yang terikat jika provider mendukung pengambilan konten file.

Catatan

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

Contoh

Permintaan

cURL
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123/content" \
  -H "Authorization: Bearer sk-your-api-key" \
  --output batch-output.jsonl

Request / 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 worker menyelesaikan batch.

Jenis Konten

Konten file batch dikembalikan sebagai JSONL atau teks biasa. Konten referensi gambar yang dibuat oleh TokenLab dapat diproksikan sebagai konten biner ketika penyedia file pendukung mendukung pengambilan konten.

Contoh respons

Respons

200 OK
{"custom_id":"request-1","response":{"status_code":200,"body":{"id":"chatcmpl_abc123"}}}
{"custom_id":"request-2","error":{"code":"invalid_request_error","message":"Invalid model"}}

Field penting

bodybinary|string
Konten file. Simpan atau uraikan sesuai Content-Type; uraikan JSONL baris demi baris.
custom_idstring
ID yang mencocokkan item input batch dengan hasilnya.

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Parameter path

file_id*string

Respons

text/plain

application/json