Berkas & batch

Membuat Batch

Membuat batch dari file JSONL yang telah diunggah.

POST
/v1/batches

Gambaran Umum

Unggah file JSONL dengan purpose=batch, lalu gunakan ID-nya sebagai input_file_id. Batch yang telah selesai akan mengembalikan ID file output dan error.

Catatan

  • File input batch harus menggunakan purpose=batch.
  • completion_window saat ini adalah 24h.
  • Urutan output mungkin berbeda dari urutan input. Cocokkan setiap hasil berdasarkan custom_id.
  • Streaming tidak didukung di dalam item batch.
  • Endpoint item yang didukung adalah /v1/chat/completions dan /v1/embeddings. /v1/responses tidak didukung.

Contoh

Permintaan

cURL
curl -X POST "https://api.tokenlab.sh/v1/batches" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "input_file_id": "file_abc123",
    "endpoint": "/v1/chat/completions",
    "completion_window": "24h"
  }'

Harga batch mungkin berbeda dari permintaan sinkron. Gunakan harga yang ditampilkan saat membuat batch dan tagihan akhir.

Contoh respons

Respons

200 OK
{
  "id": "batch_abc123",
  "object": "batch",
  "endpoint": "/v1/chat/completions",
  "input_file_id": "file_abc123",
  "completion_window": "24h",
  "status": "validating",
  "output_file_id": null,
  "error_file_id": null,
  "created_at": 1706000000
}

Bidang penting

idstring
ID Batch.
statusstring
Status batch.
output_file_idstring|null
ID file output setelah selesai.

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Header

X-TokenLab-Delivery-Policy?string

Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.

Nilai yang tersedia

  • "auto"
  • "verified"
  • "official"

Body permintaan

application/json

Respons

application/json

application/json

application/json

application/json

application/json