usando o base_url incorreto
Usar a URL base padrão da OpenAI faz com que suas solicitações falhem ou sejam roteadas para um modelo diferente. Nossa API exige que você altere o base_url para https://api.whatisopenrouterai.com/v1. Esta única linha de configuração garante que seu SDK se conecte aos nossos servidores em vez da infraestrutura global do OpenAI.
Muitos desenvolvedores copiam e colam seu código existente sem atualizar essa variável. Se você deixar a URL padrão, receberá um erro 404 ou atingirá um modelo que não é sem censura. Sempre verifique a conexão verificando o /v1/models endpoint. Você deve ver nosso ID de modelo específico listado lá. Isso confirma que o roteamento está correto antes de enviar sua primeira solicitação de conclusão.
esquecendo de definir o id do modelo
Mesmo com a URL base correta, omitir o ID do modelo padrão para um modelo genérico ou mais antigo. Você deve definir explicitamente o model parâmetro para "uncensored" em cada solicitação. Isso diz à nossa camada de roteamento para servir o modelo open-weight específico ajustado para conteúdo irrestrito.
Sem essa instrução explícita, você pode receber um modelo diferente com regras de alinhamento diferentes. Alguns modelos recusam tópicos adultos lícitos por padrão. Ao forçar o uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.
ignorando limites de tokens e erros
Exceder a janela de contexto de 100.000 tokens ou o limite de saída de 16.000 tokens causa falhas imediatas na solicitação. Nossa API impõe um máximo de saída de 16.000 tokens por solicitação. Se você não definir max_tokens, o padrão é apenas 2.048 tokens. Isso é frequentemente muito curto para tarefas de raciocínio complexo.
Erros e recusas não consomem seu crédito pré-pago. No entanto, solicitações malformadas que atingem os limites de taxa ou excedem o tamanho do corpo (8 MB) ainda contam contra sua cota. Monitore os cabeçalhos de resposta para o uso de tokens. Ajuste sua engenharia de prompt para caber dentro da janela de contexto. Isso evita retentativas custosas e garante um fluxo de dados suave.
compreensão incorreta do faturamento pré-pago
O saldo da sua conta está vinculado a crédito pré-pago, não a uma assinatura mensal. Cobramos $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. Erros são gratuitos, mas as conclusões bem-sucedidas consomem crédito. Você deve recarregar via cripto para manter a disponibilidade do serviço.
Aceitamos USDT (TRC20) ou USDC (Base) para recarregamentos. Depósitos mínimos começam em $20. Bônus aplicam-se em patamares mais altos: +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. O crédito nunca expira. Certifique-se de que seu saldo esteja positivo antes de executar lotes grandes. Verifique o painel para confirmar seu saldo atual e transações recentes.
confundir streaming com respostas padrão
O streaming via SSE altera a forma como você faz o parse do stream de resposta. Respostas padrão retornam um único objeto JSON. O streaming retorna vários chunks. Você deve processar o último chunk para obter estatísticas precisas de uso de tokens.
Nossa implementação de streaming inclui o uso de tokens no último chunk. Se você interromper a leitura do stream antecipadamente, poderá perder esses dados. Certifique-se de que sua biblioteca cliente suporte SSE corretamente. Isso é crucial para aplicativos em tempo real onde você exibe tokens conforme são gerados. O streaming mal configurado pode levar a texto incompleto ou estados de UI quebrados.
erros de configuração de tool_choice
Incorreto tool_choice configurações podem impedir que a chamada de funções funcione como esperado. Você pode forçar uma ferramenta específica ou deixar o modelo decidir. A má configuração frequentemente resulta no modelo ignorando as funções disponíveis.
Usar tool_choice para controlar se o modelo chama ferramentas automaticamente. Defina para "auto" para flexibilidade ou especifique um ID de ferramenta para comportamento estrito. Certifique-se de que suas definições de função correspondam ao esquema esperado. Isso evita erros de tempo de execução quando o modelo tenta chamar uma função inexistente. Teste suas definições de ferramenta minuciosamente antes de implantar em produção.
modo json_object ausente
Sem response_format: {"type": "json_object"}, o modelo pode gerar markdown ou texto simples. Isso quebra analisadores que esperam JSON estrito. Ative o modo JSON para garantir uma saída consistente e analisável.
Este recurso é essencial para integração com sistemas downstream que exigem dados estruturados. Reduz significativamente a sobrecarga de pós-processamento. Sempre valide o esquema de saída no código do cliente. Isso garante robustez contra alucinações ocasionais do modelo. Use este modo ao extrair entidades ou gerar arquivos de configuração.
surpresas de limite de taxa
Nossa API permite 300 solicitações por minuto por chave. Exceder esse limite resulta em uma resposta 429 Too Many Errors. As solicitações simultâneas são limitadas a 8 por chave. Planeje suas configurações de concorrência de acordo.
Se você executar vários processos, certifique-se de que eles compartilhem a mesma chave ou gerem chaves separadas. Cada conta suporta uma chave ativa. Uma nova chave substitui a antiga. Monitore os cabeçalhos de limite de taxa na resposta. Implemente backoff exponencial na lógica de retry. Isso evita falhas em cascata durante períodos de alto tráfego.
atrasos no recarga via cripto
Transações cripto podem levar tempo para serem confirmadas na blockchain. Seu crédito pode não aparecer instantaneamente após o envio de fundos. Use a rede correta: TRC20 para USDT ou Base para USDC. Enviar para a rede errada causa perda de fundos.
As recargas variam de $20 a $500. Certifique-se de enviar o valor exato ou considere as taxas de rede. Verifique o hash da transação no explorador de blockchain. Se o crédito estiver atrasado, entre em contato com o suporte com o ID da transação. Não assuma que o pagamento falhou imediatamente. Paciência durante a congestão da rede é fundamental para operações suaves.
