uploads

Datei-Bytes senden

Binärer HTTP-Transport außerhalb von MCP. Verwenden Sie ausschließlich den temporären Authorization-Header, der von createUploadSession zurückgegeben wird, sowie Content-Type: application/octet-stream. Senden Sie unveränderte Bytes, kein JSON, Base64 oder Multipart. Pro Sitzung ist ein PUT-Versuch zulässig. Die Anzahl der empfangenen Bytes muss mit size_bytes übereinstimmen, auch wenn kein Content-Length angegeben ist. Folgen Sie niemals Weiterleitungen und leiten Sie Ihre Workspace-Zugangsdaten niemals weiter. Wenn die PUT-Antwort verloren geht, versuchen Sie, mit upload_id die Übersetzung zu erstellen. Gibt es keinen vollständigen Upload, fordern Sie eine neue Sitzung an. Dieser Endpunkt kann nicht innerhalb von AI Glot Code Mode aufgerufen werden. Er erstellt keine Übersetzung und verbraucht keine Credits.

PUT/v1/uploads/{upload_id}/bytes

Request

curl --fail-with-body --request PUT \
  --url 'https://api.ai-glot.com/v1/uploads/<upload_id>/bytes' \
  --header 'Authorization: Bearer <temporary-upload-token>' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@document.xlsx'

import { readFile } from "node:fs/promises";

const response = await fetch("https://api.ai-glot.com/v1/uploads/<upload_id>/bytes", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer <temporary-upload-token>",
    "Content-Type": "application/octet-stream"
  },
  body: await readFile("document.xlsx"),
  redirect: "error",
});
if (!response.ok) throw new Error(`Upload failed: ${response.status}`);
const data = await response.json();
console.log(data);

application/json

{
  "data": {
    "upload_id": "550e8400-e29b-41d4-a716-446655440000",
    "uploaded": true,
    "size_bytes": 123
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

Verwende upload_url, method und headers, die du beim Erstellen einer Upload-Sitzung 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 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.

Antwort

application/json

Unveränderte Bytes an eine temporäre Upload-Sitzung senden

dataobjectrequired

Show child attributes

upload_idstringrequired

uploadedbooleanrequired

size_bytesintegerrequired

request_idstringrequired

Datei-Bytes senden

Sicher fortfahren

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown