Datei hochladen

Dateizwecke (File Purposes)Copy Anchor Link

• Batch-Dateien: Verwenden Sie purpose=batch für /v1/batches.
• Bild-/Referenzdateien: Verwenden Sie purpose=user_data oder purpose=vision für dateibasierte Bildanfragen.
• Anthropic-Dateien: Fügen Sie den Header anthropic-beta: files-api-2025-04-14 hinzu.

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"

Eingabe von BilddateienCopy Anchor Link

Dieselbe Route /v1/files kann verwendet werden, um Bildreferenzdateien für /v1/images/edits hochzuladen.

• Verwenden Sie purpose=user_data oder purpose=vision.
• Geben Sie optional model an, um das Bildbearbeitungsmodell auszuwählen; der Standardwert ist gpt-image-2.
• Die zurückgegebene file_id ist an die ausgewählte Bildbearbeitungskonfiguration gebunden und kann in images[].file_id wiederverwendet werden.

Anthropic Files API-ModusCopy Anchor Link

• Fügen Sie anthropic-beta: files-api-2025-04-14 hinzu, um Anthropic-Dateien zu verwenden.
• Laden Sie im Anthropic-Modus die Originaldatei direkt hoch und senden Sie kein purpose=batch.
• Die zurückgegebene file_id ist nur im aktuellen Workspace verfügbar und kann in /v1/messages-Anfragen wiederverwendet werden.
• Wenn Sie beabsichtigen, die hochgeladene Datei aus Anthropic-Nachrichteninhalt zu referenzieren, verwenden Sie weiterhin die Anthropic-nativen Header (x-api-key, anthropic-version und bei Bedarf den Beta-Header).

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

Wichtige FelderCopy Anchor Link