Dateien & Batch-Jobs

Datei abrufen

Ruft Metadaten für eine einzelne hochgeladene Datei ab.

GET
/v1/files/{file_id}

Übersicht

Dieser Endpunkt dient in erster Linie den Dateiobjekten von TokenLabs OpenAI-kompatibler Batch-API.

Wenn die Anfrage in den Anthropic-Files-Kompatibilitätsmodus wechselt, kann dieselbe Route außerdem Anthropic-ähnliche Datei-Metadaten für den gebundenen Workspace zurückgeben.

Ohne Anthropic-Header kann diese Route entweder ein Batch-Dateiobjekt oder ein TokenLab-Bild-/Referenzdateiobjekt zurückgeben.

Hinweise

  • Batch-Eingabedateien müssen purpose=batch verwenden.
  • Verwenden Sie purpose=batch_output, um sich auf erzeugte Ausgabedateien zu konzentrieren.
  • completion_window beträgt derzeit 24h.
  • Die Ausgabe-Reihenfolge ist nicht garantiert; immer nach custom_id abgleichen.
  • Streaming wird innerhalb von Batch-Elementen nicht unterstützt.

Beispiel

Anfrage

cURL
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

Anfrage / Antwort

Verwenden Sie das interaktive OpenAPI-Panel oben für das genaue Schema.

Betriebliche Tipps

  • Verwenden Sie custom_id für idempotente nachgelagerte Abstimmungen.
  • Erwarten Sie output_file_id und error_file_id erst, nachdem der Worker den Batch abgeschlossen hat.

Bildreferenzdateien

Dieser Endpunkt kann auch Metadaten für von TokenLab erstellte Bildreferenzdateien zurückgeben. Das Feld status ist optional und kann bei Dateifamilien fehlen, die keinen Status bereitstellen.

Antwortbeispiel

Antwort

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

Wichtige Felder

idstring
Dateikennung für verwandte APIs.
filenamestring
Ursprünglicher oder erzeugter Dateiname.
purposestring
Dateizweck des zugehörigen Workflows, z. B. batch, batch_output, user_data oder vision.

Autorisierung

BearerAuth
AuthorizationBearer <token>

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

Ort: header

Pfadparameter

file_id*string

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