Quando algo dá errado

Perguntas frequentes e suporte

#Perguntas frequentes

Qual modelo devo usar?

Comece pelo modelo que cada página de recurso recomenda; ele tem o melhor custo-benefício entre os modelos online hoje. Modelos e preços lista todos os modelos com o preço atualizado, e trocar de modelo é mudar um campo da requisição.

O gateway suporta tool calling / function calling?

Sim, para todos os modelos no formato da OpenAI, além de Claude e Gemini. Envie o array tools padrão; o gateway o repassa e retorna tool_calls na resposta. Deltas de chamadas de ferramentas em streaming são suportados.

Posso usar no Cursor, no Cherry Studio ou em outros apps?

Sim. Abra “Usar em um app” em Primeiros passos, escolha o seu app e copie as configurações — o endereço, sua chave e o nome de um modelo. Sem código.

Como a cota é descontada?

Pré-reservada no início da requisição (estimativa do pior caso para modelos por token, preço de tabela para modelos de tarefa) e conciliada com o uso real informado pelo provedor quando a resposta termina. Se a requisição falhar, a reserva é reembolsada automaticamente.

E se eu receber 401 ou 402?

401 significa que o bearer token está errado ou que a chave foi excluída / desativada. 402 significa que o saldo da carteira não cobre a estimativa pré-reservada — recarregue e tente novamente. Nenhum dos dois é um bug do modelo.

Posso usar geração de imagem / vídeo / música do mesmo jeito?

A geração de imagens usa o fluxo assíncrono /v1/images/tasks. O vídeo usa POST /v1/videos, e a música usa POST /v1/music/generations. Todas as rotas de tarefas assíncronas suportam envio → consulta → conteúdo e podem, opcionalmente, entregar um webhook quando a tarefa chega a um estado final.

Meus prompts são registrados?

Chamadas de chat: só quando uma chamada falha guardamos uma cópia resumida da requisição e da resposta (15 dias, para investigar a falha), a menos que você ative “Registrar conteúdo das requisições” em uma chave. Requisições de imagem, vídeo e música guardam uma cópia resumida por 15 dias. Os metadados (modelo, tokens, custo, horário, ID da requisição) são mantidos por 30 dias. Só a nossa equipe de operações pode ver esses dados.

Por quanto tempo meus dados são mantidos?

Os registros de cobrança — todas as recargas, cobranças e reembolsos — são mantidos para sempre. A página Cobrança lista os últimos 90 dias; Exportar CSV baixa todos eles. Os registros de requisições da página Uso e as tarefas de imagem, vídeo e música são mantidos por 30 dias; os totais diários continuam depois disso, mas uma tarefa com mais de 30 dias não pode mais ser consultada.

Posso limitar a taxa ou o escopo de uma chave por projeto?

Sim. Cada chave pode ter os próprios limites de RPM, RPD, teto de cota, lista de modelos permitidos, lista de IPs permitidos e grupo. Troque qualquer coisa em Console → Chaves de API sem mexer no código.

#Suporte

Algo não está funcionando, ou há um modelo que você quer que a gente adicione? Há duas formas de falar com a gente.

Ainda com problemas?

Envie para nós o ID da requisição ou a mensagem de erro e vamos investigar.