Erros — Retrace

Erros indicam que algo deu errado no processamento da requisição, seja por uma falha nos serviços da Retrace ou no provedor responsável por processá-la. Eles seguem o formato:

{
  "error": {
    "message": "...",
    "type": "invalid_request_error",
    "code": "..."
  }
}

Status	`code`	Quando acontece
401	`invalid_api_key`	Chave de API ausente, inválida, expirada ou revogada.
402	`credit_limit_exceeded`	A chave de API atingiu o teto de gasto configurado.
403	`model_not_allowed`	O modelo solicitado não está na allowlist de modelos do roteamento do workspace.
403	`model_zdr_conflict`	O modelo solicitado não é compatível com a exigência de zero data retention do workspace.
404	`model_not_found`	A chave de modelo enviada não existe ou não está ativa.
404	`preset_not_found`	O preset referenciado em `@preset/<slug>` não existe nesse workspace.
503	`model_unavailable`	Modelo em strict mode (`:strict`) falhou e nenhum fallback foi tentado.
503	`no_available_model`	Modo com fallback (ou preset) esgotou as tentativas sem sucesso.

Uma requisição que termina em erro 503 não gera cobrança, mesmo que a Retrace tenha tentado um ou mais modelos antes de desistir — apenas requisições bem-sucedidas são cobradas.