Berkas & batch
Daftar Batch
Mendaftar pekerjaan batch untuk organisasi kunci API saat ini.
Ikhtisar
Endpoint ini adalah bagian dari Batch API yang kompatibel dengan OpenAI dari TokenLab. Pekerjaan batch menggunakan file JSONL yang diunggah, dijalankan secara asinkron, dan dapat mengembalikan file output/error nanti.
Catatan
- File input batch harus menggunakan
purpose=batch. completion_windowsaat ini adalah24h.- Urutan output tidak dijamin; selalu cocokkan dengan
custom_id. - Streaming tidak didukung di dalam item batch.
Permintaan
curl -X GET "https://api.tokenlab.sh/v1/batches?limit=20" \
-H "Authorization: Bearer sk-your-api-key"Permintaan / 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 pekerja menyelesaikan batch.
Respons
{
"object": "list",
"data": [{ "id": "batch_abc123", "object": "batch", "status": "completed" }],
"first_id": "batch_abc123",
"last_id": "batch_abc123",
"has_more": false
}Field penting
objectstring
Tipe object respons.
dataarray
Daftar atau payload yang dikembalikan respons ini.
statusstring
Status lifecycle saat ini untuk resource ini.
has_moreboolean
Hasil tambahan tersedia jika
has_more bernilai true.Otorisasi
BearerAuth AuthorizationBearer <token>
Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Parameter query
limit?integer
Rentang
1 <= value <= 100after?string
Respons
application/json
application/json