Berkas & batch

Ambil Batch

Mengambil status terkini, jumlah, dan file hasil untuk sebuah batch.

GET
/v1/batches/{batch_id}

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_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/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_id untuk rekonsiliasi downstream yang idempotent.
  • Harapkan output_file_id dan error_file_id hanya setelah pekerja menyelesaikan batch.

Contoh respons

Respons

200 OK
{
  "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