Dateien & Batch-Jobs
Datei abrufen
Ruft Metadaten für eine einzelne hochgeladene Datei ab.
Ü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=batchverwenden. - Verwenden Sie
purpose=batch_output, um sich auf erzeugte Ausgabedateien zu konzentrieren. completion_windowbeträgt derzeit24h.- Die Ausgabe-Reihenfolge ist nicht garantiert; immer nach
custom_idabgleichen. - Streaming wird innerhalb von Batch-Elementen nicht unterstützt.
Anfrage
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_idfür idempotente nachgelagerte Abstimmungen. - Erwarten Sie
output_file_idunderror_file_iderst, 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.
Antwort
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}Wichtige Felder
batch, batch_output, user_data oder vision.Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Pfadparameter
Header
Fügen Sie files-api-2025-04-14 hinzu, um den Anthropic Files API-Modus zu verwenden.
Antwort
application/json
application/json