CLI-Befehle
Nutzen Sie alle AI Glot-CLI-Befehle, um Übersetzungen zu starten, bestehende Übersetzungen zu verwalten und Konten, Nutzung, Glossare, Sprachsuche, direkten API-Zugriff und MCP-Bridging zu handhaben.
Führen Sie aiglot help --json aus, um eine maschinenlesbare Beschreibung der installierten Befehlsstruktur zu erhalten.
Konto und Nutzung
aiglot account
aiglot credits
aiglot usage --from 2026-07-01 --to 2026-07-31 --granularity day
aiglot languagesOhne Datumsangaben gibt usage die letzten 30 Tage zurück. Als Datum können Sie YYYY-MM-DD oder einen vollständigen ISO-Zeitstempel angeben.
languages ist der einzige Befehl, der ganz ohne Zugangsdaten funktioniert. So kann ein Agent ein Sprach-Tag anhand des Katalogs überprüfen, bevor er sich authentifiziert oder ein Glossar erstellt.
Übersetzung starten
Zum Starten einer Übersetzung sind drei Aufrufe nötig, nicht einer. So kann der Plan geprüft werden, bevor Kosten anfallen. create liest die Datei ein, plan erstellt aus Ihrer Anweisung einen kostenpflichtigen Plan und approve gibt ihn zur Ausführung frei.
aiglot batches create ./products.csv --instruction "Translate the descriptions into German"
aiglot batches create ./book.xlsx
aiglot batches create ./annual-report.pdf
aiglot batches create https://example.com/strings.json --url
aiglot batches create ./products.csv --name catalogue.csv
aiglot batches create ./products.csv --idempotency-key import-2026-10-16
aiglot batches plan <id> --instruction "Translate the name column into Spanish"
aiglot batches plan <id> --refine "Leave the SKUs untouched"
aiglot batches approve <id>
aiglot batches approve <id> --yes
aiglot batches approve <id> --quality lite
aiglot batches approve <id> --instructions "Keep {count} placeholders exactly as written"
aiglot batches cancel <id>Wenn Sie create die Option --instruction mitgeben, erhalten Sie die Datei und den vollständigen Plan in einem Aufruf. Ohne diese Option bekommen Sie die Datei und mehrere Vorschläge zur Auswahl. plan --instruction erstellt einen Plan, falls noch keiner vorhanden ist. plan --refine bearbeitet den bestehenden Plan. Verwenden Sie daher entweder die eine oder die andere Option, niemals beide.
Textformate werden direkt übermittelt. Binärformate (Excel, OpenDocument, Word, PowerPoint, EPUB, PDF, InDesign IDML und ZIP) werden automatisch als multipart-Formulardaten hochgeladen. Für PDF ist Version 0.3.4 oder höher erforderlich, für .idml Version 0.3.5 oder höher. Mit --url wird das Argument als HTTPS-URL behandelt, die die API serverseitig abruft. Mit --name legen Sie den Dateinamen fest, unter dem die API die Datei speichert, etwa wenn die lokale Datei einen temporären Namen hat. --idempotency-key (ab Version 0.4.0) kennzeichnet den Auftrag: Geht die Antwort verloren und führen Sie denselben Befehl mit demselben Schlüssel erneut aus, erhalten Sie den ersten Batch zurück statt eines zweiten. Wird derselbe Schlüssel mit einer anderen Datei verwendet, erscheint idempotency_key_reused.
Bestehende Übersetzungen
aiglot batches list --status completed --limit 50
aiglot batches list --archived --search "product catalogue"
aiglot batches list --quality-tier lite --created-after 2026-07-01 --created-before 2026-07-31
aiglot batches list --status completed --all
aiglot batches get <id>
aiglot batches rename <id> "French product catalogue"
aiglot batches archive <id>
aiglot batches archive <id> --undo
aiglot batches download <id> --output ./translated.csvArchivierte Übersetzungen werden nur angezeigt, wenn Sie --archived angeben. --search durchsucht den Übersetzungsnamen und den Namen der hochgeladenen Datei. Für --quality-tier sind nur standard oder lite zulässig. --created-after und --created-before akzeptieren YYYY-MM-DD oder einen vollständigen ISO-Zeitstempel.
Verwenden Sie --cursor mit dem Wert next_cursor aus der vorherigen Listenantwort oder --all, um alle Ergebnisse über den Cursor abzurufen. Siehe Paginierung. download --output - schreibt die CSV-Datei in die Standardausgabe.
Glossare
Sprachpaare bestehen aus aneinandergefügten unterstützten Sprach-Tags, zum Beispiel en-US-fr.
aiglot glossaries list --limit 25 --cursor <cursor>
aiglot glossaries list --expand-terms
aiglot glossaries list --all
aiglot glossaries get en-US-fr
aiglot glossaries create en-US-fr --from terms.csv
aiglot glossaries add en-US-fr --term "checkout=commande"
aiglot glossaries add en-US-fr --from additions.json
aiglot glossaries remove en-US-fr --term checkout
aiglot glossaries replace en-US-fr --from complete.csv --dry-run
aiglot glossaries replace en-US-fr --from complete.csv
aiglot glossaries delete en-US-frAls Eingabe sind eine CSV-Datei mit zwei Spalten oder eine JSON-Begriffstabelle möglich. Mit „Hinzufügen“ und „Entfernen“ ändern Sie gezielt einzelne Einträge. „Ersetzen“ löscht alle Begriffe, die nicht in der Datei enthalten sind. „Löschen“ entfernt das gesamte Glossar. Bei destruktiven Befehlen ist in einem interaktiven Terminal eine Bestätigung erforderlich. Bei nicht-interaktiver Nutzung müssen Sie --force angeben.
--expand-terms zeigt die Begriffe der einzelnen Glossare in der Liste an und begrenzt die Anzahl pro Seite auf 10.
Feedback
Melden Sie ein Problem oder schlagen Sie eine Verbesserung vor, während Sie AI Glot verwenden:
aiglot feedback send \
--problem "The tool returned an empty result" \
--situation "I called the MCP translation tool with a valid file" \
--expected-solution "The response should explain what happened" \
--action create_translation \
--model claude-sonnet-4.5 \
--harness "Claude Desktop"Die drei Hauptfelder sind Freitextfelder. Die Felder für Aktion, Modell und Harness sind optional. Geben Sie keine API-Schlüssel, Tokens, signierten URLs oder vollständigen Dateiinhalte an. Der Befehl übermittelt lediglich Feedback und verbraucht keine Credits.
Authentifizierung
aiglot auth login
aiglot auth login --device
aiglot auth login --key "$AIGLOT_API_KEY"
aiglot auth status
aiglot auth logoutBeim Abmelden werden die gespeicherten Zugangsdaten gelöscht und serverseitig widerrufen, sofern dieser Zugangsdaten-Typ einen Widerruf unterstützt.
Erweiterte Optionen und Dienstprogramme
aiglot api GET /v1/account
aiglot api PATCH /v1/batches/<id> --data '{"archived":true}'
aiglot api PUT /v1/glossaries/en-fr --data @terms.json
echo '{"upsert":{"cart":"panier"}}' | aiglot api PATCH /v1/glossaries/en-fr --data -
aiglot api GET /v1/account --header "X-Request-Source: ci"
aiglot mcp
aiglot doctor
aiglot completion zshaiglot api sendet eine authentifizierte Anfrage direkt an die API. Dadurch können Sie neue REST-Endpunkte nutzen, bevor es dafür einen eigenen Befehl gibt. --data akzeptiert inline angegebenes JSON, @file oder -, um Daten aus der Standardeingabe zu lesen. --header "Name: value" kann mehrfach verwendet werden, aber nicht mit Authorization, da die CLI die Zugangsdaten selbst übermittelt. aiglot mcp verbindet lokale MCP-Clients, die ausschließlich stdio unterstützen, mit dem entfernten HTTP-Server von AI Glot.