---
title: "Upload-Sitzung erstellen"
description: "Bereite eine temporäre Upload-URL und ausschließlich für den Upload bestimmte Header für ein lokales Dokument vor, einschließlich der Anforderungen an einen MCP-Agenten."
canonical: "https://ai-glot.com/docs/de/api/uploads/create"
updated: "2026-10-02"
---

# Upload-Sitzung erstellen

Erfordert `batches:create`. Das Erstellen einer Sitzung kostet keine Credits und startet keine Übersetzung. Sende einen einfachen Dateinamen mit einer unterstützten Dateiendung und die exakte Größe der Originalbytes:

```json
{ "filename": "catalogue.xlsx", "size_bytes": 4096 }
```

Die Antwort enthält `upload_id`, `upload_url`, `method`, `headers`, `expires_at`, `consume_until` und die menschenlesbaren `instructions`. Verwende die zurückgegebene URL und die Header unverändert mit einem externen HTTP-Client. Erstelle anschließend mit `upload_id` und denselben Zugangsdaten [die Übersetzung](/docs/api/translations/create). Der Dateiname ist der Sitzung bereits zugeordnet.

```javascript
const session = createUploadResponse.data;
const uploaded = await fetch(session.upload_url, {
  method: session.method,
  headers: session.headers,
  body: originalFileBytes,
  redirect: "error",
});
if (!uploaded.ok) throw new Error(`Upload failed: ${uploaded.status}`);
// Use the original workspace credential for POST /v1/batches:
// { upload_id: session.upload_id, instruction: "Translate into French" }
```

Der temporäre `Authorization`-Header erlaubt innerhalb von 10 Minuten genau einen Uploadversuch für dieses Dokument. Die URL allein gewährt keinen Zugriff. Ersetze den Header niemals durch einen Workspace-API-Schlüssel oder ein OAuth-Token, übermittle keine Geheimnisse in einer URL, folge keinen Weiterleitungen und protokolliere die temporären Header nicht. Das Upload-Geheimnis kann keine Dokumente lesen, Übersetzungen erstellen oder Ausgaben genehmigen. Wenn du die Verbindung widerrufst oder ihre Berechtigung entfernst, werden nicht genutzte Upload-Berechtigungen ungültig.

Die empfangene Byte-Anzahl muss mit `size_bytes` übereinstimmen. Das formatspezifische Limit wird geprüft, bevor die Berechtigung ausgestellt wird. Erstelle die Übersetzung innerhalb einer Stunde. Ein Workspace kann 20 ausstehende Uploads haben und 120 Sitzungen pro Stunde erstellen. Nicht verwendete Dateien können nach 24 Stunden bereinigt werden und werden beim täglichen Bereinigungslauf gelöscht. Sobald eine Übersetzung die Datei verwendet, gelten die regulären Aufbewahrungsfristen. 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.

## Anforderungen an Agenten

Die Agentenlaufzeit muss Zugriff auf lokale Dateien und einen HTTP-Client haben, der rohe PUT-Anfragen senden kann. MCP allein kann keine Binärdaten senden, und AI Glot Code Mode hat weder Zugriff auf lokale Dateien noch ausgehenden HTTP-Zugriff. Fehlen diese Möglichkeiten, teile dem Nutzer klar mit, dass der Assistent den Anhang nicht senden kann. Empfiehl den Upload in der AI Glot-Web-App, die Verwendung der CLI oder einen HTTPS-Download-Link für `file_url`. Behaupte niemals, ein Upload sei erfolgreich gewesen, ohne dies überprüft zu haben.

Prüfe nach dem Upload den Übersetzungsplan und die ausgeschlossenen Inhalte, bevor du die Credit-Kosten genehmigst. [Rohe Bytes senden](/docs/api/uploads/send) beschreibt Wiederholungsversuche und Fehler.