Dateien & Batch-Jobs

Datei abrufen

Ruft Metadaten für eine einzelne hochgeladene Datei ab.

GET
/v1/files/{file_id}

Gibt den Namen, die Größe, den Verwendungszweck und den Erstellungszeitpunkt einer Datei zurück. Ohne Anthropic-Header deckt dies Batch- und Bildreferenzdateien ab. Mit Anthropic Files-Headern deckt es Dateien im Anthropic-Format ab.

Beispiel

Anfrage

cURL
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

Bildreferenzdateien

Dieser Endpunkt kann auch Metadaten für von TokenLab erstellte Bildreferenzdateien zurückgeben. Das Feld status ist optional und kann bei Dateifamilien, die keinen Status bereitstellen, fehlen.

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.
filenamestring
Ursprünglicher oder generierter Dateiname.
purposestring
Verwendungszweck der Datei, wie z. B. batch, batch_output, user_data oder vision.

Autorisierung

BearerAuth
AuthorizationBearer <token>

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

Ort: header

Pfadparameter

file_id*string

Header

anthropic-beta?string

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

Antwort

application/json

application/json