Berkas & batch

Daftar File

Daftar file yang diunggah untuk workflow batch dan mode kompatibilitas berbasis file yang didukung.

GET
/v1/files

Ikhtisar

Endpoint ini terutama melayani Batch API TokenLab yang kompatibel dengan OpenAI, termasuk input batch yang diunggah dan file output atau error yang dihasilkan.

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

Tanpa header Anthropic, daftar dapat berisi file batch dan file gambar/referensi TokenLab. Gunakan purpose=batch, purpose=batch_output, purpose=user_data, atau purpose=vision untuk mempersempit daftar.

Catatan

  • File input batch harus menggunakan purpose=batch.
  • Gunakan purpose=batch_output untuk fokus pada file output yang dihasilkan.
  • 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?purpose=batch&limit=20" \
  -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.

Filter

  • Untuk file batch dan referensi gambar, limit adalah 1–10000 (default 10000), dengan after untuk paginasi. Dalam mode Anthropic Files, nilainya 1–1000 (default 20); gunakan after_id atau before_id, bukan keduanya.
  • purpose dapat berupa batch, batch_output, user_data, atau vision.
  • user_data dan vision mengembalikan file referensi gambar yang dibuat oleh TokenLab jika tersedia.

Contoh respons

Respons

200 OK
{
  "object": "list",
  "data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }],
  "first_id": "file_abc123",
  "last_id": "file_abc123",
  "has_more": false
}

Field penting

objectstring
Tipe object respons.
dataarray
Daftar atau payload yang dikembalikan respons 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
Rentang1 <= value <= 1000
bawaan20
after?string
after_id?string

Kursor Anthropic Files. Kembalikan file setelah ID file publik ini. Memerlukan header beta Anthropic Files dan tidak dapat digabungkan dengan before_id.

before_id?string

Kursor Anthropic Files. Kembalikan file sebelum ID file publik ini. Memerlukan header beta Anthropic Files dan tidak dapat digabungkan dengan after_id.

scope_id?string

Kursor cakupan Anthropic Files yang dicadangkan. TokenLab saat ini mengembalikan kesalahan tidak didukung secara eksplisit alih-alih mengabaikan nilai ini secara diam-diam.

purpose?string

Filter tujuan file opsional. batch dan batch_output mencakup file Batch API; user_data dan vision mencakup pengikatan file gambar/referensi TokenLab. Mode Anthropic Files API dipilih oleh header Anthropic alih-alih parameter kueri ini.

Nilai yang tersedia

  • "batch"
  • "batch_output"
  • "user_data"
  • "vision"

Header

anthropic-beta?string

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

Respons

application/json

application/json