--- title: "CLI-opdrachten" description: "Gebruik alle AI Glot CLI-opdrachten om een vertaling te starten, bestaande vertalingen te beheren en accounts, gebruik, woordenlijsten, taalopzoekingen, rechtstreekse API-toegang en MCP-koppelingen af te handelen." canonical: "https://ai-glot.com/docs/nl/cli/commands" updated: "2026-10-12" --- # CLI-opdrachten Voer `aiglot help --json` uit voor een machineleesbare beschrijving die is gegenereerd op basis van de geïnstalleerde opdrachtenstructuur. ## Account en gebruik ```bash 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. ```bash 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 --instruction "Translate the name column into Spanish" aiglot batches plan --refine "Leave the SKUs untouched" aiglot batches approve aiglot batches approve --quality lite aiglot batches approve --instructions "Keep {count} placeholders exactly as written" aiglot batches cancel ``` 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. > **Warning: Alleen de opdracht approve kost credits** > > `create` en `plan` zijn gratis en kun je zo vaak herhalen als je wilt. Een agent kan de instructie dus kosteloos verfijnen. `approve` reserveert het gemeten aantal woorden van het plan en start de vertaling. `--quality lite` kost één credit per drie woorden en vereist een betaald abonnement; standaard is de instelling `standard`. `--instructions` wordt opgenomen in elke afzonderlijke tekenreeks tijdens het schrijven en kan daarom alleen beschrijven wat er binnen een tekenreeks zichtbaar is, niet welke kolommen of velden moeten worden aangepast. Dat hoort in de planningsinstructie. > **Warning: Annuleren brengt nog steeds kosten met zich mee** > > `batches cancel` stopt een vertaling die wordt uitgevoerd, maar het werk dat al is gedaan, wordt in rekening gebracht en kan niet worden teruggedraaid. ## Bestaande vertalingen ```bash 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 aiglot batches rename "French product catalogue" aiglot batches archive aiglot batches archive --undo aiglot batches download --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](/docs/cli/automation#pagination). 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`. ```bash aiglot glossaries list --limit 25 --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: ```bash 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. > **Warning: Bekijk eerst een voorbeeld van replace** > > `glossaries replace --dry-run` leest de woordenlijst in, vergelijkt deze lokaal met je bestand en toont wat er zou veranderen zonder iets te verzenden. Onder `removed_terms` staan precies de termen die zouden worden verwijderd omdat ze niet in je bestand voorkomen. Dit is de enige beveiliging bij de opdracht die termen verwijdert die de gebruiker niet zelf heeft genoemd. Voer deze opdracht dus eerst uit en ga niet verder als de lijst langer is dan verwacht. ## Verificatie ```bash 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 ```bash aiglot api GET /v1/account aiglot api PATCH /v1/batches/ --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.