AI Glot websiteOpen AI Glot
CLI und MCPCLI-Automatisierung und Ausgabe

CLI-Automatisierung und Ausgabe

Führen Sie die AI Glot CLI sicher in Skripten und CI aus. Nutzen Sie JSON oder NDJSON, Anmeldedaten aus der Umgebung, Profile, Exit-Codes und begrenzte Wiederholungsversuche.

Die CLI gibt im Terminal gut lesbare Tabellen aus und bei Weiterleitung JSON. So funktioniert derselbe Befehl interaktiv und in der Automatisierung.

Terminal
aiglot batches list                    # Tabelle im Terminal
aiglot batches list | jq '.data[0].id' # JSON bei Weiterleitung
aiglot batches list --output ndjson    # ein Objekt pro Zeile
aiglot account --json                  # explizite JSON-Ausgabe

Fehler werden auf die Standardfehlerausgabe geschrieben. Dort erscheinen auch Warnungen, die der aufrufende Prozess sehen muss, etwa wenn eine Ergebnisseite abgeschnitten wurde. Die Standardausgabe kann daher sicher an ein anderes Programm weitergeleitet werden.

Warten, bis eine Übersetzung abgeschlossen ist

Erstellen Sie zuerst den Plan und prüfen Sie seinen Umfang, die Ausschlüsse und die ermittelten Kosten. Die CLI gibt einzelne Objekte direkt zurück: Lesen Sie .id, .status und .plan, nicht .data.id oder .data.status. Bei Listenbefehlen wird weiterhin ein data-Array verwendet.

Terminal
set -euo pipefail

batch=$(aiglot batches create catalogue.csv --instruction "Translate into French" --json)
id=$(printf '%s' "$batch" | jq -er '.id')
printf '%s\n' "$batch" | jq '.plan'

Führen Sie den nächsten Block erst aus, wenn der Plan, die gewählte Qualität Standard und die ermittelten Kosten freigegeben sind. Eine bereits vorliegende Freigabe genügt, sofern sie diese Punkte abdeckt. Die Wartezeit ist auf 60 Abfragen begrenzt. Beendet wird das Warten bei completed, failed oder cancelled. Wird der Vorgang unterbrochen oder läuft die Wartezeit ab, behalten Sie die Batch-ID und setzen Sie den Vorgang fort, ohne eine weitere Übersetzung anzulegen.

Terminal
aiglot batches approve "$id" --quality standard --yes --json

for ((attempt = 0; attempt < 60; attempt++)); do
  status=$(aiglot batches get "$id" --timeout 15 --json | jq -er '.status')
  case "$status" in
    completed)
      aiglot batches download "$id" --output result.csv
      break
      ;;
    failed|cancelled)
      printf 'Batch %s ended with status %s.\n' "$id" "$status" >&2
      exit 1
      ;;
    awaiting_instructions|awaiting_approval)
      printf 'Batch %s needs a decision; inspect its plan before continuing.\n' "$id" >&2
      exit 2
      ;;
  esac
  if ((attempt == 59)); then
    printf 'Wait limit reached. Resume batch %s; do not create a duplicate.\n' "$id" >&2
    exit 1
  fi
  sleep 5
done

Dies sind alle Status, die eine Übersetzung melden kann, einschließlich der drei Endstatus. Jeder beantwortet dieselbe Frage: Wer wartet und worauf?

StatusBedeutungWer wartetEndstatus
analyzingDie Dateistruktur wird eingelesenwir, einige Sekunden lang
awaiting_instructionsDie Datei ist eingelesen; es wurde noch kein Auftrag erteiltSie
awaiting_approvalEin Plan liegt vor und die Kosten sind berechnetSie
translatingLäuft; nur in diesem Status werden Guthabenpunkte verbrauchtwir
completedAbgeschlossen; eine Ergebnisdatei steht bereitniemand✓
failedOhne Ergebnis beendet; lesen Sie error.codeSie, um es erneut zu versuchen✓
cancelledBewusst gestoppt; berechnet wird nur die ausgeführte Arbeitniemand✓

Seitennummerierung

batches list und glossaries list verwenden cursorbasierte Seitennummerierung. Übergeben Sie den next_cursor aus der vorherigen Antwort unverändert mit --cursor oder lassen Sie --all die Seiten automatisch abrufen, bis has_more den Wert false hat. Als zusätzliche Begrenzung werden höchstens 200 Seiten abgerufen:

Terminal
aiglot batches list --status completed --all
aiglot glossaries list --all --output ndjson

Bei --output ndjson gibt --all jede Zeile aus jeder Seite aus, sobald sie eintrifft. Im table- und json-Modus wird ein zusammengeführtes Ergebnis mit has_more: false, next_cursor: null und der Anzahl pages_fetched anstelle von request_id ausgegeben. Sobald mehrere Anfragen ausgeführt wurden, lässt sich keine einzelne Anfrage mehr angeben.

Authentifizierung in CI

Erstellen Sie einen dedizierten API-Schlüssel mit minimalem Berechtigungsumfang und hinterlegen Sie ihn im Secret-Manager Ihres CI-Anbieters:

Terminal
export AIGLOT_API_KEY="aig_live_…"
aiglot account --json

Die CLI prüft die Anmeldedaten in dieser Reihenfolge: AIGLOT_API_KEY, OS-Schlüsselbund und anschließend die geschützte Konfigurationsdatei.

Exit-Codes

CodeBedeutung
0Erfolg
1API- oder Serverfehler
2Ungültiger Befehl oder ungültige Argumente
3Authentifizierungs- oder Berechtigungsfehler
4Ressource nicht gefunden
5Ratenbegrenzung erreicht
6Konflikt mit dem Ressourcenstatus

Skripte sollten anhand des Exit-Codes oder des strukturierten Werts error.code verzweigen, nicht anhand des Fehlertextes.

Wiederholungsversuche

Wiederholungsversuche erfolgen automatisch, aber nur, wenn sie sicher sind. Bei jedem Befehl wird 429 erneut versucht; dabei wird Retry-After beachtet und eine begrenzte Backoff-Strategie verwendet. 408 und 5xx werden nur bei idempotenten Anfragen erneut versucht (RFC 9110 §9.2.2): Lesezugriffe sowie glossaries replace und glossaries delete.

glossaries create, glossaries add, glossaries remove, batches rename und batches archive werden nach einem 5xx nicht erneut versucht. Die Änderung könnte bereits übernommen worden sein und ein zweiter Versuch würde sie doppelt ausführen. Solche Fehler werden Ihrem Skript mit Exit-Code 1 gemeldet. Lesen Sie die Ressource erneut ein und entscheiden Sie selbst, ob ein weiterer Versuch sinnvoll ist, statt blind erneut zu versuchen.

Verwenden Sie --no-retry, wenn der aufrufende Prozess die Wiederholungsstrategie steuert, und --timeout <seconds> (Standardwert 60), um die Dauer einer einzelnen Anfrage zu begrenzen. Bei destruktiven Befehlen wird nie unbegrenzt auf eine interaktive Eingabe gewartet: Bei nicht interaktiver Verwendung muss --force angegeben werden.

Profile

Mit benannten Profilen können Sie Anmeldedaten für verschiedene Arbeitsbereiche oder Umgebungen getrennt verwalten:

Terminal
aiglot --profile client-a auth login --key "$CLIENT_A_KEY"
aiglot --profile client-a account
export AIGLOT_PROFILE=client-a

Umgebungsvariablen

VariableZweck
AIGLOT_API_KEYAPI-Schlüssel; hat Vorrang vor gespeicherten Anmeldedaten
AIGLOT_PROFILEBenanntes Anmeldeprofil
AIGLOT_NO_TUIErzwingt ein maschinenlesbares Ausgabeformat
AIGLOT_NO_KEYCHAINÜberspringt den Schlüsselbund des Betriebssystems
NO_COLORStandard (no-color.org). Deaktiviert nur Farben, nicht das Ausgabeformat

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.