AI Glot websiteOpen AI Glot
WorkspaceSolução de problemas
Workspace

Solução de problemas

Resolva problemas comuns de envio, mapeamento, créditos, andamento, download e acesso para desenvolvedores no AI Glot sem perder seu trabalho.

Abra a seção correspondente ao que você está vendo. As soluções abaixo não excluem traduções nem consomem créditos adicionais.

O CSV é rejeitado antes do envio

Exporte novamente como CSV em UTF-8 e verifique se há cabeçalhos vazios ou duplicados, aspas sem fechamento e linhas com números diferentes de colunas. O limite de tamanho varia conforme o formato: 60 MB para CSV e 4 MB para um arquivo de localidade. Consulte Arquivos e formatos.

Uma célula é longa demais para traduzir

Cada célula de origem selecionada para tradução pode conter até 50,000 caracteres Unicode. Divida conteúdos HTML ou editoriais mais longos em várias linhas ou campos menores e envie o CSV revisado. Esse limite se aplica a uma única célula e é diferente do limite menor usado para agrupar células comuns em tarefas de tradução.

O plano inclui as colunas ou os idiomas errados

O plano é uma proposta. Descreva em palavras simples o que quer alterar, como “somente a coluna de descrição” ou “não mexa na coluna de SKU”, e confira a tabela de itens para ver exatamente quais valores serão enviados. Nada é cobrado até você aprovar.

A estimativa de créditos parece alta demais

O custo é calculado com base na contagem de palavras do conteúdo que o plano vai traduzir. Abra a tabela de itens para ver quais valores estão incluídos e ajuste a instrução para excluir IDs, URLs ou metadados desnecessários. Traduzir para vários idiomas multiplica a contagem de origem pelo número de idiomas de destino. Os planos pagos permitem usar Lite em conteúdos em lote elegíveis por cerca de um terço do custo do Standard.

A tradução parece lenta

Mantenha aberta a página do lote para acompanhar a etapa e a porcentagem em tempo real, mas o trabalho continua mesmo que você saia. Vários idiomas de destino, muitas células curtas e novas tentativas podem levar mais tempo do que um arquivo de tamanho semelhante com apenas um idioma de destino. O AI Glot envia um e-mail quando a tradução é concluída.

Se o andamento não mudar por um período prolongado, atualize a página uma vez. O servidor, e não a animação do navegador, é a fonte confiável do status. Em caso de falha definitiva, os créditos reservados são devolvidos automaticamente e uma mensagem de erro segura é exibida.

O arquivo baixado não pode ser importado

Compare-o com a exportação original: mesmo delimitador, cabeçalhos, número de colunas e identificadores de linha. O AI Glot preserva esses elementos, mas o sistema de destino pode exigir campos, limites de tamanho de valores ou códigos de localidade específicos.

A autenticação da API, CLI ou MCP falha

Confira se a credencial está ativa, pertence ao espaço de trabalho esperado e tem o escopo necessário. Para problemas com a CLI, execute aiglot doctor. Se a API retornar falhas estruturadas, siga o docs_url e informe o request_id retornado ao entrar em contato com o suporte.

Uma ferramenta não inicia uma tradução

Confira o escopo, não a ferramenta: a REST API, as ferramentas MCP e a CLI podem iniciar uma tradução. Tanto a criação quanto a aprovação exigem batches:create. A conexão de um membro também precisa desse escopo dentro do limite de permissões do espaço de trabalho: espaços novos já o incluem, mas os criados antes de 31 de agosto de 2026 talvez não. Nesse caso, um administrador pode precisar marcar essa opção na guia Permissions de Ferramentas de desenvolvedor. Tentar aprovar sem planejar antes resulta em no_plan_yet.

Fale com o suporte

Se as etapas acima não resolverem o problema, abra Suporte no aplicativo. Inclua o nome do espaço de trabalho, o ID do lote e o ID da solicitação, quando pertinente, mas nunca informe uma chave de API ou um token de acesso.

Página Ajuda e suporte com um botão de chat ao vivo, um botão de suporte por e-mail e o endereço de suporte

A página Ajuda e suporte oferece chat ao vivo e atendimento por e-mail

O Chat ao vivo abre uma janela de conversa no canto da página. Suporte por e-mail envia uma mensagem para o endereço exibido. Normalmente, você recebe uma resposta em até um dia útil.

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.