Dateien & Batch-Jobs

Dateiinhalte abrufen

Lädt den ursprünglichen Inhalt einer hochgeladenen Datei herunter.

GET
/v1/files/{file_id}/content

Übersicht

Dieser Endpunkt dient in erster Linie dem Abruf von Datei-Inhalten in TokenLabs OpenAI-kompatibler Batch-API.

Wenn die Anfrage in den Anthropic-Files-Kompatibilitätsmodus wechselt, kann dieselbe Route außerdem den ursprünglich gespeicherten Dateiinhalte für den gebundenen Workspace durchreichen.

Ohne Anthropic-Header lädt diese Route Batch-Dateiinhalte herunter oder proxyt Inhalte einer gebundenen Bild-/Referenzdatei, wenn der Anbieter Dateiinhalte abrufen kann.

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/content" \
  -H "Authorization: Bearer sk-your-api-key" \
  --output batch-output.jsonl

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.

Inhaltstypen

Batch-Dateiinhalte werden als JSONL oder Klartext zurückgegeben. Inhalte von TokenLab-erstellten Bildreferenzen können als Binärdaten weitergeleitet werden, wenn der zugrunde liegende Dateianbieter den Inhaltsabruf unterstützt.

Antwortbeispiel

Antwort

200 OK
{"custom_id":"request-1","response":{"status_code":200,"body":{"id":"chatcmpl_abc123"}}}
{"custom_id":"request-2","error":{"code":"invalid_request_error","message":"Invalid model"}}

Wichtige Felder

bodybinary|string
Dateiinhalt. Je nach Content-Type speichern oder verarbeiten; JSONL zeilenweise parsen.
custom_idstring
ID zum Zuordnen eines Batch-Eingabeelements zu seinem Ergebnis.

Autorisierung

BearerAuth
AuthorizationBearer <token>

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

Ort: header

Pfadparameter

file_id*string

Antwort

text/plain

application/json