Dateien & Batch-Jobs

Datei hochladen

Laden Sie eine Batch-Datei, eine Bildreferenz oder eine Datei im Anthropic-Format hoch.

POST
/v1/files

Dateizwecke

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

Grenzwerte

ZweckMaximale Größe
batch200 MiB
user_data, vision50 MiB
Anthropic-Dateien500 MB

Eine größere Datei führt zu 413 request_too_large. Ein anderer purpose als batch, user_data oder vision führt zu 400 unsupported_purpose. Eine Anfrage ohne file führt zu 400.

Eine batch-Datei läuft 24 Stunden nach dem Hochladen ab. Um dies zu ändern, senden Sie die Formularfelder expires_after[anchor]=created_at und expires_after[seconds] mit einem Wert von 3600 bis 2592000 (30 Tage). Das Feld expires_at in der Antwort zeigt den Zeitpunkt an.

Beispiel

Anfrage

cURL
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"

Eingaben für Bilddateien

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

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

  • Fügen Sie anthropic-beta: files-api-2025-04-14 hinzu, um Anthropic Files zu verwenden.
  • Laden Sie im Anthropic-Modus die Originaldatei direkt hoch und senden Sie nicht 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).

Antwortbeispiel

Antwort

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

Wichtige Felder

idstring
Datei-ID.
purposestring
Der der Datei zugewiesene Zweck. Uploads akzeptieren batch, user_data oder vision.
bytesinteger
Dateigröße in Bytes.

Autorisierung

BearerAuth
AuthorizationBearer <token>

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

Ort: header

Header

anthropic-beta?string

Fügen Sie files-api-2025-04-14 hinzu, um den Anthropic Files API-Modus zu verwenden.

Anfragekörper

multipart/form-data

Antwort

application/json

application/json

application/json

application/json