Referência da API
Antes de entrar em produção
Use esta checklist antes do tráfego de produção. Ela reúne segurança das chaves, novas tentativas, durabilidade das tarefas assíncronas, observabilidade e cobrança em um único critério de lançamento.
#Checklist de produção
Segurança
- Mantenha as chaves de API em servidores confiáveis; nunca distribua uma chave permanente em um navegador ou em um binário mobile.
- Use uma chave com escopo por projeto e configure limites de modelo, IP, RPM, RPD e cota.
- Troque as chaves sem mudar o código de integração com os modelos.
Confiabilidade
- Defina timeouts de conexão e de resposta em todas as requisições.
- Respeite o Retry-After e use backoff exponencial com jitter.
- Use Idempotency-Key nos envios assíncronos cobrados e persista o task_id.
Observabilidade
- Registre em log o ID da requisição, o modelo, o endpoint, a latência, o status HTTP e o task_id.
- Mantenha o conteúdo dos prompts fora dos logs, a menos que a depuração esteja explicitamente ativada.
- Vincule as falhas visíveis para o cliente à linha correspondente no log de requisições.
Controle de custos
- Leia preços e opções suportadas dos metadados atualizados dos modelos.
- Defina tetos de cota por projeto e alerte antes de a carteira se esgotar.
- Faça a conciliação com o consumo final de seis casas decimais no log de requisições.
#Critério de lançamento
- 1
Teste a requisição mínima
Execute exatamente o modelo e o endpoint no Workbench e depois copie a requisição gerada.
- 2
Teste os caminhos de falha
Verifique o tratamento de 401, 402, 429, timeout, mídia inválida e falha final de tarefa.
- 3
Verifique a cobrança
Associe uma requisição bem-sucedida ao consumo de seis casas decimais e ao ID da requisição.
- 4
Ative o monitoramento
Alerte sobre taxa de erros, latência, tarefas travadas, falhas de webhook e saldo baixo.
#Atalhos operacionais
Ainda com problemas?
Envie para nós o ID da requisição ou a mensagem de erro e vamos investigar.