Códigos de erro

Chat Completions usa o objeto padrão error abaixo. Erros de voz e catálogo incluem code, message e request_id. Ao relatar problemas, informe o cabeçalho X-Request-Id e o horário da solicitação.

Pedidos que falham devolvem um estado HTTP fora de 2xx e um objeto de erro:

{"error":{"message":"Invalid request parameter.","type":"invalid_request_error","param":"messages","code":"invalid_request"}}

Use code na lógica do programa e message como informação de diagnóstico.

HTTP	Código	Significado
400	invalid_request	Modelo, array de mensagens ou parâmetros de geração inválidos
400	content_policy_violation	Texto de voz recusado pela política de conteúdo
401	invalid_api_key	Chave inválida, expirada ou desativada
402	insufficient_balance	Créditos insuficientes
403	forbidden	Acesso da conta ou do IP restringido
429	rate_limited	Limite de pedidos por minuto ultrapassado
500	internal_error	Erro do servidor
503	upstream_unavailable	Serviço de chat ou voz indisponível
400	content_policy_violation	O conteúdo não passou na análise de políticas
413	payload_too_large	Corpo do pedido demasiado grande
504	timeout	Tempo de espera excedido

Verifique o pedido e as credenciais antes de repetir. Aguarde em caso de erros temporários. Reenviar mensagens pode gerar outra resposta e novos custos. Se o conteúdo for recusado, não repita automaticamente o mesmo texto; adapte-o à política.

O streaming aguarda até 90 segundos pelo primeiro texto e termina após 60 segundos sem texto novo. A saída contínua não tem um limite fixo de duração total e continua sujeita a max_tokens.