Dateien & Batch-Jobs
Datei hochladen
Laden Sie eine Batch-Datei, eine Bildreferenz oder eine Datei im Anthropic-Format hoch.
Dateizwecke
- Batch-Dateien: Verwenden Sie
purpose=batchfür/v1/batches. - Bild-/Referenzdateien: Verwenden Sie
purpose=user_dataoderpurpose=visionfür dateibasierte Bildanfragen. - Anthropic-Dateien: Fügen Sie den Header
anthropic-beta: files-api-2025-04-14hinzu.
Grenzwerte
| Zweck | Maximale Größe |
|---|---|
batch | 200 MiB |
user_data, vision | 50 MiB |
| Anthropic-Dateien | 500 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.
Anfrage
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_dataoderpurpose=vision. - Geben Sie optional
modelan, um das Bildbearbeitungsmodell auszuwählen; der Standardwert istgpt-image-2. - Die zurückgegebene
file_idist an die ausgewählte Bildbearbeitungskonfiguration gebunden und kann inimages[].file_idwiederverwendet werden.
Anthropic Files API-Modus
- Fügen Sie
anthropic-beta: files-api-2025-04-14hinzu, um Anthropic Files zu verwenden. - Laden Sie im Anthropic-Modus die Originaldatei direkt hoch und senden Sie nicht
purpose=batch. - Die zurückgegebene
file_idist 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-versionund bei Bedarf den Beta-Header).
Antwort
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}Wichtige Felder
batch, user_data oder vision.Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Header
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