Erros

Todas as falhas da API usam o mesmo formato. Use error.code para tomar decisões, nunca a mensagem legível por humanos.

{
  "error": {
    "type": "permission_error",
    "code": "insufficient_scope",
    "message": "This credential is missing the batches:write scope.",
    "docs_url": "https://ai-glot.com/docs/api/errors#insufficient_scope"
  },
  "request_id": "req_example"
}

Códigos de status

Códigos de autenticação e permissão

authentication_required

Nenhuma credencial bearer foi enviada. Adicione o cabeçalho Authorization.

invalid_api_key

A chave está malformada ou não é conhecida. Confira se o valor completo aig_live_… foi copiado.

api_key_expired

A chave atingiu a data de expiração configurada. Crie ou use uma chave substituta.

api_key_revoked

Um administrador revogou ou substituiu esta chave. Atualize a integração com uma credencial ativa.

insufficient_scope

A credencial foi autenticada, mas não tem o escopo exigido por esta operação.

feature_not_available

O plano do workspace ou a versão atual da plataforma não inclui o recurso solicitado.

admin_required

Somente um administrador do workspace pode realizar esta operação.

Códigos de solicitação

invalid_request

Não foi possível interpretar a solicitação ou ela não corresponde ao contrato do endpoint.

unknown_field

Uma propriedade do corpo JSON não é reconhecida. Corrija a grafia em vez de remover a validação. Parâmetros de consulta não reconhecidos nunca geram este erro: eles são ignorados, então um filtro digitado incorretamente retorna um 200 sem filtro.

invalid_parameter

Um parâmetro tem tipo, intervalo ou formato incorreto.

invalid_cursor

O cursor de paginação é inválido. Reutilize next_cursor exatamente como foi retornado.

request_too_large

O corpo da solicitação excede o limite máximo do endpoint.

Códigos de recurso e estado

batch_not_found

Nenhuma tradução visível tem esse ID. Recursos de outro workspace retornam intencionalmente o mesmo erro.

glossary_not_found

Não existe glossário para esse par de idiomas.

resource_not_found

O recurso ou a rota solicitada não existe.

glossary_already_exists

Já existe um glossário para esse par de idiomas. Atualize-o em vez de criar outro.

result_not_ready

A tradução ainda não foi concluída, portanto o resultado ainda não pode ser baixado.

batch_not_editable

O estado atual da tradução não permite a alteração solicitada.

Códigos de arquivo e formato

unsupported_format

A extensão do arquivo não é aceita pelo AI Glot. Consulte Arquivos e formatos para ver todos os formatos e suas extensões.

file_too_large

O arquivo excede o limite para o formato. Os limites variam por formato, não são globais (60 MB para CSV e 4 MB para um catálogo PO). Por isso, um arquivo com tamanho aceito em uma extensão pode ser recusado em outra.

file_fetch_failed

Não foi possível acessar file_url. O URL precisa usar HTTPS e apontar para o destino final: os redirecionamentos não são seguidos, então um link encurtado ou assinado que depois redireciona falha aqui.

file_retention_expired

O período de retenção do arquivo enviado terminou, e ele já não está armazenado. Crie a tradução novamente a partir do arquivo de origem.

file_expired

O arquivo que dá suporte a esta tradução não está mais disponível, então não é possível prosseguir com a operação.

result_too_large

A tradução concluída excede o tamanho máximo permitido para resposta. Divida o arquivo de origem e traduza-o em partes.

Códigos de plano e aprovação

plan_invalid

Não foi possível transformar a instrução ou o refinamento em um plano utilizável. Reformule: indicar os campos ou as colunas que devem ser traduzidos costuma funcionar melhor do que descrevê-los.

no_plan_yet

A aprovação foi solicitada antes da criação de um plano. Chame primeiro POST /v1/batches/{batch_id}/plan. Essa proteção impede que uma integração cobre do workspace por uma tradução que ninguém especificou.

batch_not_awaiting_approval

A tradução não está em um estado que permita aprovação. Em geral, ela já está em andamento ou foi concluída. Consulte GET /v1/batches/{batch_id} em vez de aprová-la novamente.

insufficient_credits

O saldo do workspace não cobre o custo calculado do plano. Nenhum crédito é reservado, então será possível aprovar a tradução após adicionar créditos.

Códigos de idioma e glossário

language_not_supported

A etiqueta não consta no catálogo de idiomas aceitos. Consulte GET /v1/languages.

invalid_language_pair

Não é possível dividir o identificador do par de idiomas em duas etiquetas BCP 47 aceitas.

glossary_term_limit_reached

A quantidade final de termos excederia o limite permitido pelo plano do workspace. A atualização é atômica; nada foi alterado.

glossary_limit_reached

O workspace atingiu o limite de glossários do plano atual.

invalid_glossary_terms

Uma ou mais entradas do glossário estão vazias, incompletas ou são inválidas por outro motivo.

Códigos de serviço

rate_limited

A credencial excedeu o limite de solicitações no período. Aguarde Retry-After e tente novamente com variação aleatória nos intervalos.

internal_error

O AI Glot falhou inesperadamente. Tente novamente com intervalos crescentes e mantenha o request_id.

service_unavailable

Um serviço necessário está temporariamente indisponível. Tente novamente com intervalos crescentes.