AI Glot websiteOpen AI Glot
ArbeitsbereichFehlerbehebung
Arbeitsbereich

Fehlerbehebung

Behebe häufige Probleme beim Upload, bei der Zuordnung, mit Credits, beim Fortschritt, beim Herunterladen und beim Entwicklerzugriff in AI Glot, ohne deine Arbeit zu verlieren.

Öffne den Abschnitt, der zu deinem Problem passt. Die folgenden Schritte löschen keine Übersetzung und verbrauchen keine zusätzlichen Credits.

Die CSV-Datei wird vor dem Upload abgelehnt

Exportiere die Datei erneut als UTF-8-CSV und prüfe, ob Spaltenüberschriften fehlen oder doppelt vorkommen, Anführungszeichen nicht geschlossen sind oder Zeilen unterschiedlich viele Spalten enthalten. Die Uploadgrößenlimits richten sich nach dem Format: 60 MB für CSV und 4 MB für eine Lokalisierungsdatei. Weitere Informationen findest du unter Dateien und Formate.

Eine Zelle ist zu lang für die Übersetzung

Jede einzelne ausgewählte Quellzelle darf bis zu 50,000 Unicode-Zeichen enthalten. Teile längere HTML- oder redaktionelle Inhalte auf mehrere Zeilen oder kleinere Felder auf und lade anschließend die überarbeitete CSV-Datei hoch. Dieses Limit gilt pro Zelle und unterscheidet sich vom niedrigeren Limit, mit dem gewöhnliche Zellen zu Übersetzungsaufgaben zusammengefasst werden.

Der Plan umfasst die falschen Spalten oder Sprachen

Der Plan ist ein Vorschlag. Beschreibe in eigenen Worten, was geändert werden soll, etwa „nur die Beschreibungsspalte“ oder „die SKU-Spalte unverändert lassen“. Prüfe dann in der Elementtabelle genau, welche Werte übermittelt werden. Kosten fallen erst an, wenn du den Plan genehmigst.

Die geschätzten Credit-Kosten erscheinen zu hoch

Die Kosten richten sich nach der ermittelten Wortzahl der Inhalte, die laut Plan übersetzt werden. Öffne die Elementtabelle, um zu sehen, welche Werte enthalten sind. Passe die Anweisung an, damit nicht benötigte IDs, URLs oder Metadaten ausgeschlossen werden. Bei mehreren Zielsprachen vervielfacht sich die Quellwortzahl entsprechend der Anzahl der Ziele. In kostenpflichtigen Tarifen kannst du Lite für geeignete umfangreiche Inhalte zu etwa einem Drittel der Standard-Kosten verwenden.

Die Übersetzung scheint langsam zu sein

Lass die Seite des Vorgangs geöffnet, um den aktuellen Verarbeitungsschritt und den Fortschritt in Prozent zu sehen. Der Vorgang läuft aber auch weiter, wenn du die Seite verlässt. Mehrere Zielsprachen, viele kurze Zellen und Wiederholungsversuche können länger dauern als eine ähnlich große Datei mit nur einer Zielsprache. AI Glot schickt dir nach Abschluss eine E-Mail.

Wenn sich der Fortschritt längere Zeit nicht ändert, lade die Seite einmal neu. Maßgeblich ist der Status auf dem Server, nicht die Animation im Browser. Bei einem endgültigen Fehler werden reservierte Credits automatisch zurückgebucht und eine unbedenkliche Fehlermeldung angezeigt.

Die heruntergeladene Datei lässt sich nicht importieren

Vergleiche sie mit dem Originalexport: Trennzeichen, Überschriften, Spaltenanzahl und Zeilenkennungen müssen übereinstimmen. AI Glot erhält diese Merkmale. Das Zielsystem kann jedoch eigene Pflichtfelder, Längenbeschränkungen für Werte oder Gebietsschemacodes voraussetzen.

Die Authentifizierung über API, CLI oder MCP schlägt fehl

Prüfe, ob die Zugangsdaten aktiv sind, zum erwarteten Arbeitsbereich gehören und über den erforderlichen Geltungsbereich verfügen. Bei Problemen mit der CLI führe aiglot doctor aus. Bei strukturierten API-Fehlern folge dem Link docs_url und gib bei einer Supportanfrage die zurückgegebene request_id an.

Ein Tool kann keine Übersetzung starten

Prüfe den Geltungsbereich, nicht das Tool: Mit der REST API, den MCP-Tools und der CLI kannst du Übersetzungen starten. Sowohl das Erstellen als auch das Genehmigen erfordert batches:create. Auch die Verbindung eines Mitglieds muss diesen Geltungsbereich innerhalb des Mitgliederlimits des Arbeitsbereichs haben. Bei neuen Arbeitsbereichen ist er enthalten, bei Arbeitsbereichen, die vor dem 31. August 2026 erstellt wurden, möglicherweise nicht. Dann muss ein Admin ihn unter Umständen im Tab Permissions der Entwicklertools aktivieren. Wenn du ohne vorherige Planung genehmigen möchtest, schlägt der Vorgang mit no_plan_yet fehl.

Support kontaktieren

Wenn sich das Problem mit den obigen Schritten nicht beheben lässt, öffne in der App Support. Gib bei Bedarf den Namen des Arbeitsbereichs, die Batch-ID und die Request-ID an. Teile niemals einen API-Schlüssel oder ein Zugriffstoken mit.

Seite Hilfe und Support mit Schaltflächen für den Live-Chat und den E-Mail-Support sowie der Supportadresse

Auf der Seite Hilfe und Support kannst du den Live-Chat oder den E-Mail-Support nutzen

Über Live-Chat öffnest du eine Chatblase in der Ecke der Seite. Mit E-Mail-Support schreibst du an die angezeigte Adresse. Antworten treffen in der Regel innerhalb eines Werktags ein.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search AI Glot Docs documentation and read it in full, instead of answering from memory.

https://ai-glot.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://ai-glot.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.