Datei hochladen

ÜbersichtCopy Anchor Link

Dieser Endpunkt ist Teil von TokenLabs OpenAI-kompatibler Batch-API. Batch-Jobs verwenden hochgeladene JSONL-Dateien, laufen asynchron und können später Ausgabedateien/Fehlerdateien zurückgeben.

Unterstützte DateimodiCopy Anchor Link

TokenLab behandelt /v1/files als drei explizite Modi:

• Batch-Dateien: verwende purpose=batch für /v1/batches.
• Bild-/Referenzdateien: verwende purpose=user_data oder purpose=vision für dateibasierte Bildanfragen.
• Anthropic-Files-API-Modus: füge anthropic-beta: files-api-2025-04-14 für native Anthropic-Dateispeicherung hinzu.

HinweiseCopy Anchor Link

• Batch-Eingabedateien müssen purpose=batch verwenden.
• completion_window beträgt derzeit 24h.
• Die Ausgabereihenfolge ist nicht garantiert; immer nach custom_id abgleichen.
• Streaming wird innerhalb von Batch-Elementen nicht unterstützt.

curl -X POST "https://api.tokenlab.sh/v1/files" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "purpose=batch" \
  -F "file=@batch-input.jsonl;type=application/jsonl"

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 das Batch abgeschlossen hat.

Bilddatei-EingabenCopy Anchor Link

Dieselbe Route /v1/files kann auch Bildreferenzdateien für /v1/images/edits hochladen.

• Verwende purpose=user_data oder purpose=vision.
• Gib optional model an, um das Image-Edit-Modell auszuwählen; Standard ist gpt-image-2.
• Die zurückgegebene file_id gilt für das ausgewählte Bildbearbeitungsmodell und kann in images[].file_id wiederverwendet werden.

Anthropic Files API-ModusCopy Anchor Link

Dieselbe Route /v1/files unterstützt auch den Anthropic-Files-API-Pfad.

• Füge den Header anthropic-beta: files-api-2025-04-14 hinzu, um in den Anthropic-Modus zu wechseln.
• Im Anthropic-Modus lädst du die Originaldatei direkt hoch und sendest kein purpose=batch.
• Die zurückgegebene file_id gilt für denselben Anthropic-kompatiblen Workspace und sollte in /v1/messages-Requests wiederverwendet werden.
• Wenn du die hochgeladene Datei in Anthropic-Nachrichteninhalten referenzieren willst, verwende weiterhin die nativen Anthropic-Header (x-api-key, anthropic-version und bei Bedarf den Beta-Header).

DateiablaufCopy Anchor Link

Für Batch-Eingabedateien können Sie optional mit expires_after[anchor]=created_at und expires_after[seconds] ein Ablaufzeitfenster setzen. Der Sekundenwert muss zwischen 3600 und 2592000 liegen.

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

Wichtige FelderCopy Anchor Link