---
title: "Datei-Bytes senden"
description: "Sende die rohen Originalbytes der Datei mit dem ausschließlich für Uploads bestimmten Geheimnis an eine temporäre Upload-URL und stelle unterbrochene Anfragen sicher wieder her."
canonical: "https://ai-glot.com/docs/de/api/uploads/send"
updated: "2026-10-02"
---

# Datei-Bytes senden

Verwende `upload_url`, `method` und `headers`, die du beim [Erstellen einer Upload-Sitzung](/docs/api/uploads/create) erhalten hast. Für diesen Endpunkt ist der temporäre `Authorization`-Header erforderlich, der ausschließlich für Uploads gilt. Ein Workspace-API-Schlüssel oder OAuth-Zugriffstoken kann diese Anfrage nicht autorisieren.

Sende die Datei selbst als HTTP-Body mit `Content-Type: application/octet-stream`. Verpacke sie nicht in JSON, Base64 oder Multipart. Falls du `Content-Length` mitsendest, muss der Wert der `size_bytes` der Sitzung entsprechen. Anfragen ohne diesen Header sind ebenfalls auf die erwartete Größe begrenzt. Komprimierte HTTP-Bodies werden abgelehnt. Sende die ursprünglichen Dokumentbytes.

Eine erfolgreiche Antwort enthält `upload_id`, `uploaded: true` und `size_bytes`. Fahre fort, indem du `upload_id` mit denselben Workspace-Zugangsdaten, mit denen du die Sitzung erstellt hast, an [Übersetzung erstellen](/docs/api/translations/create) sendest. Erst die Genehmigung startet die Übersetzung und verbraucht Credits.

## Sicher fortfahren

Eine Sitzung erlaubt genau einen PUT-Versuch. Gleichzeitige und wiederholte PUT-Anfragen können die Datei nicht ersetzen. Für einen fehlgeschlagenen oder unterbrochenen Versuch brauchst du eine neue Sitzung.

Falls die Upload-Antwort verloren gegangen ist, versuche zuerst, die Übersetzung mit der vorhandenen `upload_id` zu erstellen. Ein vollständiger Upload bleibt erhalten, auch wenn der Client die Erfolgsantwort nicht erhalten hat. Wenn kein vollständiger Upload vorliegt, fordere eine neue Sitzung an und sende die Datei erneut. Sende niemals Bytes erneut, um die alte Sitzung zu überschreiben. Die Wiederherstellung anhand der upload\_id ist bis zur Bereinigung der Sitzung möglich, frühestens 24 Stunden nach der Ausstellung. Bewahre die Batch-ID auf, um die Übersetzung später aus deinem Verlauf abzurufen.

Ein abgelaufener Upload liefert `file_expired`. Ein PUT nach Verwendung der Berechtigung liefert `batch_not_editable`. Eine andere Verbindung oder ein anderer Workspace kann den Upload nicht übernehmen. Unvollständige Bytes oder eine falsche Größe liefern `invalid_parameter`. Bytes über der Sitzungsgröße hinaus liefern `file_too_large`.

Dieser Binärdaten-Endpunkt wird von einem externen HTTP-Client aufgerufen, nicht von einem MCP-Tool oder einem AI Glot Code Mode-Skript. Kann dein Assistent nicht auf die Originaldatei zugreifen oder keine PUT-Anfrage senden, teile dies dem Nutzer mit und biete die Web-App, die CLI oder einen HTTPS-Download-Link an. Gib das temporäre Geheimnis in deiner Erklärung niemals preis.