TokenLab
Dapatkan kunci API
DokumentasiReferensi APIIntegrasi

Berkas & batch

Mencantumkan File

Mencantumkan file batch dan referensi gambar yang diunggah.

GET
/v1/files

Mencantumkan file batch dan referensi gambar. Lakukan filter dengan purpose=batch, purpose=batch_output, purpose=user_data, atau purpose=vision.

Dengan header Anthropic Files, API yang sama mencantumkan file berformat Anthropic di Workspace saat ini.

Contoh

Permintaan

cURL
curl -X GET "https://api.tokenlab.sh/v1/files?purpose=batch&limit=20" \
  -H "Authorization: Bearer sk-your-api-key"

Filter

  • Untuk file batch dan referensi gambar, limit adalah 1–10000 (default 10000), dengan after untuk penomoran halaman (pagination). Dalam mode Anthropic Files, limit adalah 1–1000 (default 20); gunakan after_id atau before_id, jangan 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
}

Bidang penting

objectstring
Selalu list.
dataarray
File.
has_moreboolean
Hasil lebih lanjut 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

Unggah File

Sebelumnya

Mengambil File

Berikutnya