Berkas & batch

Ambil File

Ambil metadata untuk satu file yang diunggah.

GET
/v1/files/{file_id}

Ikhtisar

Endpoint ini terutama melayani objek file Batch API TokenLab yang kompatibel dengan OpenAI.

Ketika request memakai mode kompatibilitas Anthropic Files, route yang sama juga dapat mengembalikan metadata file bergaya Anthropic untuk workspace yang terikat.

Tanpa header Anthropic, route ini dapat mengembalikan object file batch atau object file gambar/referensi TokenLab.

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/files/file_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

Request / 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 worker menyelesaikan batch.

File Referensi Gambar

Endpoint ini juga dapat mengembalikan metadata untuk file referensi gambar yang dibuat oleh TokenLab. Field status bersifat opsional dan mungkin tidak ada untuk keluarga file yang tidak menyediakannya.

Contoh respons

Respons

200 OK
{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

Field penting

idstring
Identifier file yang dipakai API terkait.
filenamestring
Nama file asli atau yang dihasilkan.
purposestring
Purpose file yang digunakan workflow pemilik, seperti batch, batch_output, user_data, atau vision.

Otorisasi

BearerAuth
AuthorizationBearer <token>

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

Lokasi: header

Parameter path

file_id*string

Header

anthropic-beta?string

Sertakan files-api-2025-04-14 untuk menggunakan mode Anthropic Files API.

Respons

application/json

application/json