Compreendendo a URL base
A URL base define para onde seu cliente envia as solicitações. Uma incompatibilidade aqui causa falhas imediatas de conexão ou respostas inesperadas do modelo. Muitos desenvolvedores assumem que a URL padrão do OpenAI funciona universalmente, mas provedores sem censura frequentemente usam endpoints distintos para rotear o tráfego para pools de modelos específicos.
Verifique se sua configuração aponta para https://api.openrouterabliteratedmodels.com/v1 para nosso serviço. Se você estiver usando um agregador de terceiros, certifique-se de que a URL base corresponda exatamente à documentação deles. URLs incorretas frequentemente resultam em erros 404 ou respostas de modelos padrão em vez da variante sem censura pretendida.
- Verifique suas variáveis de ambiente para
BASE_URLouAPI_HOST. - Certifique-se de que o caminho inclua
/v1para compatibilidade padrão. - Teste a conectividade com uma solicitação simples de lista de modelos antes de um uso intensivo.
Lidando com Limites de Taxa
Os limites de taxa restringem a quantidade de solicitações que você pode enviar dentro de um período específico. Nossa API impõe um limite de 300 solicitações por minuto por chave. Exceder esse limite resulta em erros HTTP 429, bloqueando temporariamente novas solicitações até que a janela seja reiniciada.
Além disso, há um limite de solicitações simultâneas de 8 solicitações ao mesmo tempo por chave. Se você enviar mais de 8 solicitações simultâneas, o excesso será colocado em fila ou falhará, dependendo da sua biblioteca cliente. Monitore a concorrência de sua aplicação para evitar atingir esses limites rígidos. Use estratégias de backoff exponencial em seu código para lidar com erros 429 sem sobrecarregar o servidor.
Lembre-se de que cada chave é exclusiva para sua conta. Compartilhar chaves entre vários serviços pode acelerar o atingimento desses limites. Gere uma nova chave se precisar de pools de limite de taxa separados para diferentes partes de sua aplicação.
Respostas: Streaming vs. Não Streaming
O streaming retorna dados incrementalmente conforme os tokens são gerados, enquanto o modo sem streaming aguarda a resposta completa. O streaming é essencial para experiências de usuário em tempo real, mas requer o processamento cuidadoso de Server-Sent Events (SSE).
Ao fazer streaming, o último chunk contém as estatísticas de uso de tokens. Se você interromper o processamento antecipadamente, poderá perder esses dados. Certifique-se de que seu cliente analise a última mensagem SSE para recuperar as contagens de tokens de entrada e saída com precisão. Respostas sem streaming são mais simples, mas podem causar alta latência para saídas longas.
Escolha streaming para interfaces de chat onde os usuários veem o texto aparecer caractere por caractere. Use não-streaming para processamento em lote ou quando precisar da resposta completa antes de prosseguir. Nossa API suporta ambos os modos via stream parâmetro no corpo da solicitação.
Erros do Modo JSON
O modo JSON garante que o modelo emita JSON válido, o que é crítico para integração programática. Erros aqui geralmente decorrem de cabeçalhos incorretos ou incompatibilidade de schema. A API requer response_format: {"type": "json_object"} para impor saída JSON estrita.
Se você receber JSON malformado, verifique a definição do seu esquema. O modelo pode incluir blocos de código markdown ou texto explicativo fora da estrutura JSON. Use um analisador robusto que possa remover as marcações de código ou validar a saída contra seu esquema esperado. Evite esquemas muito complexos que confundem o modelo.
Teste com estruturas simples primeiro. Adicione complexidade gradualmente para identificar onde o modelo tem dificuldades. Garanta que sua temperatura esteja definida adequadamente, pois temperaturas mais altas podem aumentar a aleatoriedade e reduzir a validade do JSON.
Erros de Cálculo na Contagem de Tokens
As contagens de tokens determinam sua faturação e o uso da janela de contexto. Cálculos errados podem levar a cobranças inesperadas ou respostas truncadas. Nossa API cobra $0.15 por 1M de tokens de entrada e $0.50 por 1M de tokens de saída.
Use uma biblioteca de tokenização confiável que corresponda ao esquema de tokenização do modelo. Modelos diferentes podem tokenizar espaços em branco ou pontuação de maneira distinta, levando a discrepâncias entre sua contagem local e a contagem da API. Sempre confie no uso de tokens retornado na resposta para faturamento preciso.
Mantenha o controle da sua janela de contexto, que é de 100.000 tokens no total. Exceder esse limite causará erros. Trunque mensagens ou resumos mais antigos para permanecer dentro dos limites. Monitore o uso de tokens ao longo do tempo para otimizar a estrutura do seu prompt e reduzir custos.
Atrasos no Pagamento Cripto
Recargas com criptomoedas via USDT (TRC20) ou USDC (Base) são processadas instantaneamente em nosso lado. No entanto, a congestionamento da rede às vezes pode causar pequenos atrasos na confirmação. Certifique-se de enviar o valor e a rede corretos para evitar perdas.
Recargas variam de $20 a $500 em valores inteiros. Créditos bônus se aplicam automaticamente: +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. Verifique o hash da transação para confirmar o pagamento. Se os créditos não aparecerem dentro de alguns minutos, verifique o explorador de blockchain para o status da transação.
O crédito nunca expira, então não há urgência para usá-lo imediatamente. Erros como cobranças duplas são resolvidos pela página de Suporte. Mantenha seus registros de transação para fácil referência caso surjam problemas.
Configuração do ID do Modelo
O ID do modelo identifica qual versão do modelo uncensored você está usando. Para nosso serviço, o ID do modelo é uncensored. Usar um ID incorreto pode resultar em erros ou comportamento inesperado.
Garanta que suas solicitações especifiquem model: "uncensored" no corpo da solicitação. Este ID aponta para nosso modelo open-weight específico ajustado para respostas irrestritas. Não é um identificador genérico, mas um ponteiro específico para nossa instância hospedada.
Verifique a documentação da biblioteca do seu cliente para saber como definir o ID do modelo. Algumas bibliotecas usam um model campo, enquanto outros podem usar um parâmetro diferente. A consistência no uso do ID do modelo em toda a sua aplicação evita confusão e garante que você esteja sempre chamando o modelo sem censura pretendido.
Excedências da Janela de Contexto
A janela de contexto limita o número total de tokens que você pode enviar em uma única solicitação. Nossa API suporta uma janela de 100.000 tokens, incluindo prompt e conclusão. Exceder esse limite resulta em um erro.
Para gerenciar o contexto, implemente uma estratégia de janela deslizante. Remova mensagens mais antigas ou resuma-as para liberar espaço. Monitore a contagem de tokens da sua entrada para garantir que ela permaneça dentro do limite de 100,000 tokens. Se você exceder o limite, a API rejeitará a solicitação.
Use o max_tokens parâmetro para controlar o comprimento da saída. A saída máxima por solicitação é de 16.000 tokens. Definir esse parâmetro ajuda a evitar uso excessivo de tokens e mantém as respostas dentro de limites gerenciáveis para seu aplicativo.
Política de Suporte e Reembolso
O crédito não é reembolsado após ser usado, mas nunca expira. Se encontrar problemas com pagamentos ou serviço, entre em contato com o Suporte através da página designada. Erros como cobranças duplicadas são resolvidos pela equipe de Suporte.
Para problemas técnicos, consulte a documentação primeiro. Nossa API é direta, mas podem surgir casos extremos. Forneça sua chave de API e os detalhes da solicitação ao buscar ajuda. Os tempos de resposta variam, mas buscamos resolver problemas rapidamente.
Lembre-se de que o crédito é pré-pago. Você paga pelo que consome, com erros e recusas sendo gratuitos. Este modelo garante transparência na faturamento. Use a página de Suporte para quaisquer discrepâncias ou dúvidas sobre sua conta.
