Dúvidas sobre a API

Perguntas frequentes sobre chamadas à API. Encontre o seu sintoma e siga os links para saber mais.

Está retornando 401 Unauthorized?

• Chave errada: confirme que está usando a chave completa salva na criação (o item mascarado na lista não é a chave completa);
• Chave excluída ou expirada: verifique o status dela na página "Chaves de API" e recrie se necessário;
• Cabeçalho malformado: o protocolo compatível com OpenAI espera Authorization: Bearer <key> — não remova o prefixo Bearer ;
• Mais detalhes em Autenticação.

"Model not found"?

• ID do modelo escrito errado — copie o ID exato da vitrine de modelos em vez de digitá-lo;
• O modelo não existe na plataforma ou está indisponível no momento — verifique se o card existe e está disponível na vitrine.

Timeouts ou respostas lentas?

• Requisições com contexto longo / saída longa são naturalmente mais lentas; verifique se o max_tokens não está desnecessariamente alto;
• Defina timeouts e retentativas razoáveis no cliente, com backoff exponencial;
• Para interfaces interativas, use "stream": true — os primeiros bytes chegam antes e a latência percebida cai.

Muitos 429?

Você está atingindo os limites de requisições. Reduza a concorrência e adicione intervalos de backoff; para carga alta sustentada, fale com a plataforma sobre cotas. Veja Códigos de erro.

Respostas vazias ou truncadas?

• finish_reason é length: a resposta atingiu o teto de max_tokens — aumente-o;
• Verifique se nenhum item de messages carrega um content vazio;
• Alguns modelos restringem formatos de entrada (por exemplo, exigências da modalidade imagem) — veja as observações no card do modelo.

Como confirmo que uma chamada realmente teve sucesso?

Dois pontos de checagem: HTTP 200 com choices / usage na resposta; e o registro correspondente (com consumo de tokens e custo) na página de logs do console. Quando os dois batem, o fluxo está saudável.