Berkas & batch
Ambil File
Ambil metadata untuk satu file yang diunggah.
Ikhtisar
Endpoint ini terutama melayani objek file Batch API TokenLab yang kompatibel dengan OpenAI.
Ketika request memakai mode kompatibilitas Anthropic Files, route yang sama juga dapat mengembalikan metadata file bergaya Anthropic untuk workspace yang terikat.
Tanpa header Anthropic, route ini dapat mengembalikan object file batch atau object file gambar/referensi TokenLab.
Catatan
- File input batch harus menggunakan
purpose=batch. completion_windowsaat ini adalah24h.- Urutan output tidak dijamin; selalu cocokkan berdasarkan
custom_id. - Streaming tidak didukung di dalam item batch.
Permintaan
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
-H "Authorization: Bearer sk-your-api-key"Request / Respons
Gunakan panel OpenAPI interaktif di atas untuk skema yang tepat.
Tips Operasional
- Gunakan
custom_iduntuk rekonsiliasi downstream yang idempotent. - Harapkan
output_file_iddanerror_file_idhanya setelah worker menyelesaikan batch.
File Referensi Gambar
Endpoint ini juga dapat mengembalikan metadata untuk file referensi gambar yang dibuat oleh TokenLab. Field status bersifat opsional dan mungkin tidak ada untuk keluarga file yang tidak menyediakannya.
Respons
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}Field penting
batch, batch_output, user_data, atau vision.Otorisasi
BearerAuth Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Parameter path
Header
Sertakan files-api-2025-04-14 untuk menggunakan mode Anthropic Files API.
Respons
application/json
application/json