Ler a resposta completa
Para um estado sem êxito, conserve o código HTTP, os cabeçalhos, o corpo do erro e o ID do pedido depois de remover os segredos. Estes elementos permitem distinguir um pedido inválido de uma recusa de acesso ou de um problema temporário.
Não exponha uma resposta bruta do serviço como única mensagem ao utilizador: explique a ação e conserve os detalhes de diagnóstico para um operador.
curl --include --request POST https://cicora.ai/api/v1/chat/completions \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"model":"openai/gpt-5.6-sol","messages":[]}'Classificar a falha
- Um erro 4xx exige normalmente corrigir uma chave, os dados de entrada ou o acesso.
- Um erro 429 exige respeitar a janela do limite e evitar novas tentativas agressivas.
- Os erros 5xx e de rede exigem novas tentativas limitadas, com recuo exponencial e variação aleatória.
Repetir com segurança
Repita apenas falhas transitórias e apenas se a operação for idempotente no seu produto. Para geração, conserve um ID de pedido do cliente para evitar uma cobrança em duplicado ou um artefacto duplicado.
Na transmissão, distinga um erro anterior ao primeiro incremento de uma interrupção após uma saída parcial: esta última não pode ser substituída silenciosamente por uma nova resposta.