CLI-opdrachten

Voer aiglot help --json uit voor een machineleesbare beschrijving die is gegenereerd op basis van de geïnstalleerde opdrachtenstructuur.

Account en gebruik

aiglot account
aiglot credits
aiglot usage --from 2026-07-01 --to 2026-07-31 --granularity day
aiglot languages

Zonder datums geeft usage de afgelopen 30 dagen weer. Datums kunnen de notatie YYYY-MM-DD of volledige ISO-tijdstempels hebben.

languages is de enige opdracht die helemaal geen inloggegevens nodig heeft. Zo kan een agent een taalcode controleren aan de hand van de catalogus voordat die zich aanmeldt of een woordenlijst schrijft.

Een vertaling starten

Een vertaling starten vereist drie aanroepen, geen één, omdat je het plan eerst moet kunnen bekijken voordat je ervoor betaalt. create leest het bestand in, plan zet je instructie om in een plan met prijsopgave en approve bevestigt de opdracht.

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 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> --quality lite
aiglot batches approve <id> --instructions "Keep {count} placeholders exactly as written"
aiglot batches cancel <id>

Als je --instruction meegeeft aan create, worden het bestand en het volledige plan in één aanroep teruggegeven. Zonder deze optie krijg je het bestand en een aantal suggesties waaruit je kunt kiezen. plan --instruction maakt een plan als er nog geen is; met plan --refine pas je het bestaande plan aan. Geef dus de ene of de andere optie mee, nooit allebei.

Tekstbestanden worden rechtstreeks meegestuurd. Binaire bestanden (Excel, OpenDocument, Word, PowerPoint, EPUB, PDF, InDesign IDML en ZIP) worden automatisch geüpload als multipart-formuliergegevens. Voor PDF is versie 0.3.4 of hoger vereist; voor .idml versie 0.3.5 of hoger. Met --url wordt het argument behandeld als een HTTPS-URL die de API aan de serverzijde ophaalt. Met --name stel je in welke bestandsnaam de API registreert, bijvoorbeeld als het lokale bestand een tijdelijke naam heeft.

Bestaande vertalingen

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.csv

Gearchiveerde vertalingen worden niet getoond, tenzij je --archived opgeeft. --search zoekt in de naam van de vertaling of de naam van het geüploade bestand. --quality-tier accepteert alleen standard of lite. Voor --created-after en --created-before kun je YYYY-MM-DD of een volledige ISO-tijdstempel gebruiken.

Gebruik --cursor met de next_cursor uit het vorige lijstresultaat, of --all om alle pagina’s op te halen. Zie paginering. Met download --output - wordt de CSV naar de standaarduitvoer geschreven.

Woordenlijsten

Taalparen bestaan uit ondersteunde codes die aan elkaar zijn gekoppeld, zoals 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-fr

Als invoer kun je een CSV met twee kolommen of een JSON-termenkaart gebruiken. Met add en remove pas je alleen de opgegeven termen aan. Replace verwijdert alle termen die niet in het bestand staan; delete verwijdert de volledige woordenlijst. Destructieve opdrachten vragen om bevestiging in een interactieve terminal en vereisen --force bij niet-interactief gebruik.

--expand-terms neemt de termen van elke woordenlijst op in de lijst en beperkt het aantal resultaten per pagina tot 10.

Feedback

Meld een probleem of stel een verbetering voor tijdens het gebruik van AI Glot:

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"

De drie belangrijkste velden zijn vrije tekst. De velden action, model en harness zijn optioneel. Vermeld geen API-sleutels, tokens, ondertekende URL’s of volledige bestandsinhoud. De opdracht registreert alleen feedback en kost geen credits.

Verificatie

aiglot auth login
aiglot auth login --device
aiglot auth login --key "$AIGLOT_API_KEY"
aiglot auth status
aiglot auth logout

Bij het uitloggen worden de opgeslagen inloggegevens gewist en, als het type inloggegevens intrekking ondersteunt, ook aan de serverzijde ingetrokken.

Alternatieven en hulpprogramma’s

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 zsh

aiglot api voert een geauthenticeerd verzoek rechtstreeks uit. Zo kun je een nieuw REST-eindpunt gebruiken voordat er een speciale opdracht voor bestaat. --data accepteert inline JSON, @file of - om van de standaardinvoer te lezen. Je kunt --header "Name: value" meerdere keren gebruiken, maar niet voor Authorization, omdat de CLI zelf de inloggegevens toevoegt. aiglot mcp koppelt lokale MCP-clients die alleen stdio ondersteunen aan de externe HTTP-server van AI Glot.