O OpenRouter API Explicado

O que é uma API compatível com OpenAI?

É uma API REST que segue a interface de chat-completions da OpenAI. Você envia prompts e recebe saídas de texto usando payloads JSON padrão. Essa compatibilidade significa que seu código de cliente existente funciona sem grandes alterações.

O endpoint principal é POST /v1/chat/completions. Ele aceita mensagens como uma matriz de objetos de papel e conteúdo. Você também pode listar os modelos disponíveis via GET /v1/models. Essa padronização reduz significativamente o tempo de integração.

Nosso serviço oferece exatamente essa interface. Servimos um único modelo sem censura sob o ID "uncensored". Ele roda em nossos próprios servidores. Não faz roteamento para outros fornecedores. Você tem acesso direto ao modelo que precisa.

Janelas de contexto suportam até 100.000 tokens no total. Limites de saída são de 16.000 tokens por solicitação. Streaming está disponível via Server-Sent Events. Chamada de função e modo JSON são totalmente suportados.

Compreendendo URLs Base e Chaves de API

A URL base aponta para o servidor que processa suas solicitações. Você substitui a URL padrão do OpenAI pelo nosso endpoint específico. Nossa URL base é HTTPS://api.openrouterabliterated.com/v1. Essa alteração direciona o tráfego para nossa infraestrutura uncensored.

As chaves de API autenticam suas solicitações. Você gera uma chave por conta. A chave é exibida imediatamente após o cadastro. Você pode substituí-la se necessário. Cada conta mantém uma chave ativa por vez.

Os limites de taxa são aplicados por chave. Você pode enviar 300 solicitações por minuto. Até 8 solicitações podem ser executadas simultaneamente. Os corpos das solicitações são limitados a 8 MB. Esses limites lidam bem com uso de alto volume.

O cadastro requer apenas um e-mail ou conta Google. Não é necessário número de telefone. A chave aparece instantaneamente. Você pode começar a enviar solicitações imediatamente. A privacidade é preservada; as prompts não são usadas para treinamento.

Por que Escolher um Modelo Sem Restrições para Seu Caso de Uso?

Modelos sem censura não recusam tópicos adultos lícitos, fictícios ou controversos. Eles são ideais para escrita criativa, roleplay ou pesquisa. Modelos mainstream frequentemente aplicam guarda-rigidas rigorosas. Essas podem interromper o fluxo de geração.

Nosso modelo é ajustado para responder diretamente. Ele lida com conteúdo NSFW sem resistência. Funciona bem para filosofia política ou gêneros de nicho. Você recebe comportamento consistente sem prompts extras.

O uso de ferramentas é suportado. Você pode definir ferramentas para o seu aplicativo. O modelo respeita as escolhas de ferramentas. Isso o torna adequado para fluxos de trabalho complexos. Erros e recusas são gratuitos. Você paga apenas pelo uso real.

Os limites de conteúdo ainda se aplicam. Conteúdo sexual envolvendo menores é sempre recusado. Este é um limite rígido. Isso garante padrões básicos de segurança. Tudo o mais é permitido para o seu caso de uso.

Preços de Tokens: Como os Custos São Calculados

O preço é baseado no uso de tokens. Tokens de entrada custam $0,15 por 1 milhão de tokens. Tokens de saída custam $0,50 por 1 milhão de tokens. Você paga apenas pelo que usa. Não há taxas ocultas.

O crédito é pré-pago. Você recarrega apenas com criptomoedas. USDT na TRC20 ou USDC na Base são aceitos. Qualquer valor inteiro de $20 a $500 é permitido. Os créditos nunca expiram. Isso evita o bloqueio por assinatura.

Crédito bônus está disponível nas recargas. Você recebe +5% a partir de $50. +10% a partir de $100. +15% a partir de $200. Isso reduz seu custo efetivo. Erros são gratuitos. Recusas são gratuitas. Você paga apenas por tokens com sucesso.

Uma conta de teste recebe $0,50. Ela é válida por 7 dias. Isso permite testar a API em profundidade. Você pode verificar a integração antes de comprometer fundos.

Respostas: Streaming vs. Não Streaming

O streaming envia tokens conforme são gerados. Isso reduz a latência percebida. Os usuários veem o texto aparecer em tempo real. É essencial para interfaces de chat. Sem streaming espera pela resposta completa. Isso pode parecer lento para saídas longas.

Suportamos streaming via SSE. O último chunk inclui o uso de tokens. Isso permite um rastreamento preciso de faturamento. Você pode lidar com respostas parciais com facilidade. Os erros são tratados de forma consistente.

Modo sem streaming também está disponível. Ele retorna a resposta completa de uma vez. Isso é mais simples para processamento em lote. Você escolhe com base nas suas necessidades. Ambos os modos usam o mesmo endpoint.

A chamada de função pode ser transmitida (streamed). As ferramentas são executadas conforme são identificadas. Isso melhora a interatividade. Você pode começar a processar entradas antecipadamente. A API gerencia a complexidade para você.

Chamada de Função e Saída Estruturada

Chamada de função permite que o modelo invoque ferramentas. Você define esquemas de ferramentas na solicitação. O modelo retorna chamadas de função. Seu código as executa. Isso permite fluxos de trabalho complexos. Você pode construir agentes ou assistentes.

O modo JSON força saída estruturada. O modelo retorna JSON válido. Isso é útil para extração de dados. Você obtém formatos consistentes. A análise é mais fácil. Erros são raros.

Parâmetros como temperatura e top_p controlam o comportamento. Sequências de parada limitam a saída. Sementes garantem reprodutibilidade. Penalidades reduzem a repetição. Você tem controle granular.

A escolha da ferramenta pode ser automática ou forçada. Você especifica a preferência do modelo. Isso orienta o processo de geração. Melhora a confiabilidade. Seu aplicativo permanece robusto.

Bibliotecas de Cliente e SDKs Comuns

A maioria dos SDKs funciona com alterações mínimas. Você só atualiza a URL base. O restante do código permanece o mesmo. Isso se aplica a Python, Node.js e outros. A integração é direta.

O SDK OpenAI é o padrão. Ele gerencia autenticação e novas tentativas. Você passa sua chave de API. A URL base aponta para nosso serviço. As solicitações são enviadas normalmente.

O streaming é suportado em todos os SDKs. Você itera sobre os chunks. O uso de tokens está disponível no último chunk. Isso corresponde ao nosso modelo de faturamento. Erros são capturados de forma consistente.

As chamadas de função são integradas aos SDKs modernos. Você passa as definições das ferramentas. O SDK analisa as respostas. Seu código executa as ferramentas. O loop continua até o fim. É eficiente e confiável.

Solução de problemas de Erros Comuns de API

Os limites de taxa retornam erros 429. Você pode enviar 300 solicitações por minuto. Exceder isso aciona uma espera. Implemente backoff exponencial. Isso evita sobrecarregar o servidor.

Chaves inválidas retornam erros 401. Verifique sua chave de API. Certifique-se de que está ativa. Substitua-a se necessário. Cada conta possui uma chave. Gere uma nova se for perdida.

Ocorrem erros de JSON no modo JSON. Certifique-se de que seu esquema seja válido. O modelo deve retornar JSON válido. Se falhar, tente novamente. Ajuste a temperatura para melhor estabilidade.

Os tempos limite ocorrem com gerações longas. Aumente seu valor de tempo limite. O streaming reduz o risco de tempo limite. Respostas parciais são tratadas. Você pode reconstruir a saída completa.

Próximos Passos: Obtendo sua Primeira Chave de API

Acesse a página de cadastro. Use Google ou e-mail. Não é necessário número de telefone. O processo é rápido. Você tem acesso imediato.

Sua chave de API é exibida. Copie-a com segurança. Use-a no seu SDK. Defina a URL base para o nosso endpoint. Comece a enviar requisições.

Recarregue com criptomoeda. USDT ou USDC são aceitos. Receba crédito bônus em valores maiores. Créditos nunca expiram. Use-os no seu ritmo.

Teste com o crédito de teste. Ele dura 7 dias. Verifique o streaming e a chamada de funções. Explore as capacidades do modelo. Integre-o ao seu aplicativo. A API está pronta para produção.