Berkas & batch
Daftar File
Daftar file yang diunggah untuk workflow batch dan mode kompatibilitas berbasis file yang didukung.
Ikhtisar
Endpoint ini terutama melayani Batch API TokenLab yang kompatibel dengan OpenAI, termasuk input batch yang diunggah dan file output atau error yang dihasilkan.
Ketika request memakai mode kompatibilitas Anthropic Files, route yang sama juga dapat menampilkan file bergaya Anthropic yang tersedia untuk workspace yang terikat.
Tanpa header Anthropic, daftar dapat berisi file batch dan file gambar/referensi TokenLab. Gunakan purpose=batch, purpose=batch_output, purpose=user_data, atau purpose=vision untuk mempersempit daftar.
Catatan
- File input batch harus menggunakan
purpose=batch. - Gunakan
purpose=batch_outputuntuk fokus pada file output yang dihasilkan. 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?purpose=batch&limit=20" \
-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.
Filter
- Untuk file batch dan referensi gambar,
limitadalah 1–10000 (default 10000), denganafteruntuk paginasi. Dalam mode Anthropic Files, nilainya 1–1000 (default 20); gunakanafter_idataubefore_id, bukan keduanya. purposedapat berupabatch,batch_output,user_data, atauvision.user_datadanvisionmengembalikan file referensi gambar yang dibuat oleh TokenLab jika tersedia.
Respons
{
"object": "list",
"data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }],
"first_id": "file_abc123",
"last_id": "file_abc123",
"has_more": false
}Field penting
has_more bernilai true.Otorisasi
BearerAuth Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Parameter query
1 <= value <= 100020Kursor Anthropic Files. Kembalikan file setelah ID file publik ini. Memerlukan header beta Anthropic Files dan tidak dapat digabungkan dengan before_id.
Kursor Anthropic Files. Kembalikan file sebelum ID file publik ini. Memerlukan header beta Anthropic Files dan tidak dapat digabungkan dengan after_id.
Kursor cakupan Anthropic Files yang dicadangkan. TokenLab saat ini mengembalikan kesalahan tidak didukung secara eksplisit alih-alih mengabaikan nilai ini secara diam-diam.
Filter tujuan file opsional. batch dan batch_output mencakup file Batch API; user_data dan vision mencakup pengikatan file gambar/referensi TokenLab. Mode Anthropic Files API dipilih oleh header Anthropic alih-alih parameter kueri ini.
Nilai yang tersedia
- "batch"
- "batch_output"
- "user_data"
- "vision"
Header
Sertakan files-api-2025-04-14 untuk menggunakan mode Anthropic Files API.
Respons
application/json
application/json