Diagnóstico e recuperação
Resolva envios incertos, conflitos de cotação, problemas de upload e fluxos interrompidos.
Guarde informações úteis
Registre horário, endpoint, status HTTP, code de negócio, request_id e qualquer taskId recebido. Diferencie recusa explícita, ausência de resposta de rede e falha após aceitação. Não inclua chaves API, prompts completos ou arquivos originais em logs gerais ou chamados.
Modelo ausente ou indisponível
Atualize o catálogo autenticado e confira enabled, available e o ID exato do modelo da tarefa. Uma página pública não comprova que sua conta pode chamá-lo. Se 50301 persistir, confira a disponibilidade e limite as tentativas. Repetir chamadas não libera um modelo.
Entrada inválida ou conflito de cotação
Para 400, compare tipos, valores e exigências condicionais com o inputSchema atual e remova parâmetros não aceitos. Para 40901, obtenha e confirme outra cotação: entrada, validade ou preço mudaram. O 409 comum depende da operação. Uma chave ligada a outro conteúdo exige corrigir a associação de negócio.
Tempo esgotado sem ID da tarefa
Mantenha o conteúdo e o Idempotency-Key originais. Recupere o mesmo envio dentro da janela válida antes de criar outro. Com taskId, consulte recordInfo. Timeout, fechar a aba ou interromper o fluxo não cancela tarefas aceitas; verifique state, cost e settled.
Upload concluído, arquivo recusado
Depois de PUT, chame files/{fileId}/commit. Use o URI spicy:// retornado no campo aceito pelo modelo, nunca uploadUrl. Confira Content-Type assinado, tamanho, formato, conta proprietária e validade. Uploads duram um dia; uma nova tentativa pode exigir outro upload e atualização da entrada.
Callback ausente ou download expirado
Confira o receptor HTTPS, a assinatura sobre os bytes originais e a resposta de sucesso rápida. Recupere o estado com recordInfo e elimine callbacks duplicados antes de processar o evento. Se o resultado ainda estiver armazenado, solicite outro link. Repita pending mais tarde; unavailable ou resultado expirado não se resolve atualizando a URL antiga.
Fluxo encerrado antes da hora
Confira HTTP e Content-Type antes de interpretar SSE do protocolo escolhido. Fragmentos TCP não são eventos completos e encerrar a conexão não indica sucesso. Verifique eventos finais, erros e prazos da aplicação. Não presuma reembolso nem reenvio gratuito após desconectar; guarde request_id e confira o uso.
Saldo, limites e suporte
Para 40201 confira saldo disponível; para 40202 limites de gasto da conta e da chave; para 429 respeite Retry-After e reduza a frequência. Nunca envie chaves ao suporte. Forneça passos, horário, IDs, estrutura dos campos sem dados sensíveis e resultados esperado e real.
Guias relacionados
Erros e novas tentativas · Idempotência · Upload e download de mídia · Texto e streaming