uploads

Upload-Sitzung erstellen

Bereiten Sie einen lokalen Datei-Upload für einen Agent vor, der die Dateibytes lesen und außerhalb von MCP HTTP-PUT-Aufrufe senden kann. Gibt upload_url, method, exact headers, upload_id und Anweisungen zurück. Senden Sie die unveränderten Originalbytes mit dem zurückgegebenen temporären Authorization-Header. Verwenden Sie niemals einen Workspace-API-Schlüssel oder ein OAuth-Token. Die Upload-Berechtigung läuft nach 10 Minuten ab und erlaubt einen PUT-Versuch. Senden Sie nach erfolgreichem Upload innerhalb einer Stunde upload_id mit denselben Zugangsdaten, um eine Übersetzung zu erstellen. Kostet keine Credits. Maximal 20 ausstehende Uploads und 120 Sitzungen pro Stunde und Workspace.

POST/v1/uploads

Request

curl --request POST \
  --url 'https://api.ai-glot.com/v1/uploads' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "filename": "document.xlsx",
  "size_bytes": 4096
}'

import json
import requests

url = "https://api.ai-glot.com/v1/uploads"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"filename\":\"document.xlsx\",\"size_bytes\":4096}")

response = requests.request("POST", url, headers=headers, json=payload)
print(response.json())

const response = await fetch("https://api.ai-glot.com/v1/uploads", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "filename": "document.xlsx",
    "size_bytes": 4096
  }),
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.ai-glot.com/v1/uploads");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"filename\":\"document.xlsx\",\"size_bytes\":4096}");
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("POST", "https://api.ai-glot.com/v1/uploads", bytes.NewBuffer([]byte("{\"filename\":\"document.xlsx\",\"size_bytes\":4096}")))
  req.Header.Set("Authorization", "<api-key>")
  req.Header.Set("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.ai-glot.com/v1/uploads"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"filename\":\"document.xlsx\",\"size_bytes\":4096}"))
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.ai-glot.com/v1/uploads")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"filename\":\"document.xlsx\",\"size_bytes\":4096}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "upload_id": "550e8400-e29b-41d4-a716-446655440000",
    "upload_url": "<string>",
    "method": "PUT",
    "headers": {
      "Authorization": "<string>",
      "Content-Type": "application/octet-stream"
    },
    "expires_at": "<string>",
    "consume_until": "<string>",
    "size_bytes": 123,
    "max_upload_bytes": 123,
    "instructions": "<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>"
}

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

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. Der Dateiname ist der Sitzung bereits zugeordnet.

javascriptconst 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 beschreibt Wiederholungsversuche und Fehler.

Antwort

application/json

Temporäre Upload-Sitzung für eine Datei erstellen

dataobjectrequired

Show child attributes

upload_idstringrequired

upload_urlstringrequired

Senden Sie die unveränderten Dateibytes außerhalb von MCP hierher. Die URL allein gewährt keinen Zugriff.

methodstringrequired

headersobjectrequired

Temporäre Zugangsdaten, die ausschließlich für Uploads gelten. Verwenden Sie diese Header exakt wie angegeben. Ersetzen Sie Ihren Workspace-API-Schlüssel oder Ihr OAuth-Token niemals durch diese Zugangsdaten und leiten Sie diese auch niemals weiter.

expires_atstringrequired

consume_untilstringrequired

size_bytesintegerrequired

max_upload_bytesintegerrequired

instructionsstringrequired

Erforderliche externe HTTP-Funktion und was Sie dem Nutzer mitteilen sollen, wenn sie nicht verfügbar ist.

request_idstringrequired

Upload-Sitzung erstellen

Anforderungen an Agenten

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown