Comandos de la CLI

Ejecute aiglot help --json para obtener una descripción legible por máquina generada a partir del árbol de comandos instalado.

Cuenta y uso

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

Sin fechas, usage devuelve los últimos 30 días. Las fechas aceptan el formato YYYY-MM-DD o marcas de tiempo ISO completas.

languages es el único comando que funciona sin credenciales, permitiendo que un agente valide una etiqueta de idioma frente al catálogo antes de autenticarse o escribir un glosario.

Iniciar una traducción

Iniciar una traducción requiere tres llamadas, no una, ya que el plan debe leerse antes de pagarse. create lee el archivo, plan convierte su instrucción en un plan con precio y approve confirma la operación.

aiglot batches create ./products.csv --instruction "Translate the descriptions into German"
aiglot batches create ./book.xlsx
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>

Al pasar --instruction a create, se devuelve el archivo y su plan completo en una sola llamada. Sin esto, obtendrá el archivo y un conjunto de sugerencias para elegir. plan --instruction escribe un plan donde no existe; plan --refine edita el ya existente, por lo que debe pasar uno u otro, nunca ambos.

--url trata el argumento como una URL HTTPS que la API obtiene en el servidor. --name establece el nombre del archivo que registra la API cuando el archivo local tiene un nombre temporal.

Traducciones existentes

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

Las traducciones archivadas se excluyen a menos que se pase --archived. --search coincide con el nombre de la traducción o el nombre del archivo subido, y --quality-tier solo acepta standard o lite. --created-after y --created-before aceptan YYYY-MM-DD o una marca de tiempo ISO completa.

Use --cursor con el next_cursor de la respuesta de lista anterior, o --all para seguir el cursor hasta el final. Consulte paginación. download --output - escribe el CSV en la salida estándar.

Glosarios

Los pares de idiomas utilizan etiquetas compatibles unidas, como 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

La entrada puede ser un CSV de dos columnas o un mapa de términos JSON. Add y remove son operaciones quirúrgicas. Replace elimina cada término ausente en el archivo; delete elimina el glosario completo. Los comandos destructivos solicitan confirmación en una terminal interactiva y requieren --force en uso no interactivo.

--expand-terms incluye los términos de cada glosario en el listado y limita la página a 10.

Autenticación

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

Logout olvida la credencial almacenada y la revoca en el servidor cuando el tipo de credencial admite la revocación.

Alternativas y utilidades

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 realiza una solicitud autenticada directa, permitiendo usar un nuevo endpoint REST antes de que exista un comando dedicado. --data acepta JSON en línea, @archivo o - para leer la entrada estándar. --header "Name: value" es repetible pero no puede establecer Authorization, ya que la CLI suministra la credencial por sí misma. aiglot mcp conecta clientes MCP locales que solo usan stdio con el servidor HTTP remoto de AI Glot.