TokenLab
API-Schlüssel erhalten
DokumentationAPI-ReferenzIntegrationen

Dateien & Batch-Jobs

Dateien auflisten

Listet hochgeladene Batch- und Bildreferenzdateien auf.

GET
/v1/files

Listet Batch- und Bildreferenzdateien auf. Filtern Sie mit purpose=batch, purpose=batch_output, purpose=user_data oder purpose=vision.

Mit Anthropic Files-Headern listet dieselbe API Dateien im Anthropic-Format im aktuellen Workspace auf.

Beispiel

Anfrage

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

Filter

  • Für Batch- und Bildreferenzdateien liegt limit zwischen 1 und 10000 (Standardwert 10000), wobei after für die Paginierung verwendet wird. Im Anthropic Files-Modus liegt limit zwischen 1 und 1000 (Standardwert 20); verwenden Sie entweder after_id oder before_id, nicht beide gleichzeitig.
  • purpose kann batch, batch_output, user_data oder vision sein.
  • user_data und vision geben von TokenLab erstellte Bildreferenzdateien zurück, sofern verfügbar.

Antwortbeispiel

Antwort

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

Wichtige Felder

objectstring
Immer list.
dataarray
Dateien.
has_moreboolean
Weitere Ergebnisse sind verfügbar, wenn has_more auf true gesetzt ist.

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Abfrageparameter

limit?integer
Bereich1 <= value <= 1000
Standard20
after?string
after_id?string

Anthropic Files-Cursor. Gibt Dateien nach dieser öffentlichen Datei-ID zurück. Erfordert den Anthropic Files Beta-Header und kann nicht mit before_id kombiniert werden.

before_id?string

Anthropic Files-Cursor. Gibt Dateien vor dieser öffentlichen Datei-ID zurück. Erfordert den Anthropic Files Beta-Header und kann nicht mit after_id kombiniert werden.

scope_id?string

Reservierter Anthropic Files-Bereichscursor. TokenLab gibt derzeit einen expliziten Fehler für nicht unterstützte Werte zurück, anstatt diesen Wert stillschweigend zu ignorieren.

purpose?string

Optionaler Filter für den Dateizweck. batch und batch_output decken Batch API-Dateien ab; user_data und vision decken TokenLab-Bild-/Referenzdateibindungen ab. Der Anthropic Files API-Modus wird durch Anthropic-Header ausgewählt, nicht durch diesen Abfrageparameter.

Zulässige Werte

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

Header

anthropic-beta?string

Fügen Sie files-api-2025-04-14 hinzu, um den Anthropic Files API-Modus zu verwenden.

Antwort

application/json

application/json

Datei hochladen

Zurück

Datei abrufen

Weiter