Dateien auflisten

ÜbersichtCopy Anchor Link

Dieser Endpunkt dient in erster Linie TokenLabs OpenAI-kompatibler Batch-API, einschließlich hochgeladener Batch-Eingaben sowie generierter Ausgabe- oder Fehlerdateien.

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

Ohne Anthropic-Header kann die Liste sowohl Batch-Dateien als auch TokenLab-Bild-/Referenzdateien enthalten. Nutze purpose=batch, purpose=batch_output, purpose=user_data oder purpose=vision, um die Liste einzugrenzen.

HinweiseCopy Anchor Link

• 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.

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

Anfrage / AntwortCopy Anchor Link

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

Betriebliche TippsCopy Anchor Link

• 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.

FilterCopy Anchor Link

• Für Batch- und Bildreferenzdateien liegt limit zwischen 1 und 10000 (Standard 10000); after dient zur Seitennavigation. Im Anthropic-Files-Modus gilt 1–1000 (Standard 20). Verwenden Sie dort entweder after_id oder before_id, nicht beide.
• purpose kann batch, batch_output, user_data oder vision sein.
• user_data und vision geben verfügbare von TokenLab erstellte Bildreferenzdateien zurück.

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

Wichtige FelderCopy Anchor Link