Berkas & batch
Ambil Batch
Mengambil status terkini, jumlah, dan file hasil untuk sebuah batch.
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 berdasarkan
custom_id. - Streaming tidak didukung di dalam item batch.
Permintaan
curl -X GET "https://api.tokenlab.sh/v1/batches/batch_abc123" \
-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
{
"id": "batch_abc123",
"object": "batch",
"status": "completed",
"input_file_id": "file_abc123",
"output_file_id": "file_out123",
"error_file_id": "file_err123",
"request_counts": { "total": 100, "completed": 98, "failed": 2 }
}Field penting
request_countsobject
Jumlah permintaan total, selesai, gagal, dan dibatalkan.
output_file_idstring|null
Identifier file yang dipakai API terkait.
error_file_idstring|null
Identifier file yang dipakai API terkait.
Otorisasi
BearerAuth AuthorizationBearer <token>
Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Parameter path
batch_id*string
Respons
application/json
application/json