Limites de taxa do OpenRouter: guia de início rápido

Compatibilidade com SDK e configuração da URL base

Conecte seu código de cliente existente apontando-o para o nosso endpoint dedicado. Este API compatível com openai aceita cabeçalhos padrão e configurações de SDK sem alterações de código. Você só precisa atualizar a URL base e fornecer sua chave de API no painel.

https://api.openrouterratelimits.com/v1 é o único ponto de entrada para todas as solicitações. A autenticação usa o esquema padrão de token Bearer encontrado na maioria das bibliotecas LLM modernas. Passe sua chave no Authorization Cabeçalho para verificar sua identidade. Esta configuração funciona com qualquer cliente que espere uma interface estilo OpenAI, tornando a migração instantânea para equipes cansadas do vendor lock-in.

• URL Base: https://api.openrouterratelimits.com/v1
• Cabeçalho de Autenticação: Authorization: Bearer YOUR_API_KEY
• ID do Modelo: uncensored

Respostas em streaming com SSE

Ative o streaming definindo stream: true na carga útil da sua solicitação. A API retorna Eventos Enviados pelo Servidor (SSE) para entrega de tokens em tempo real. Cada chunk contém o texto gerado até que o último chunk inclua as estatísticas de uso. Esta abordagem mantém sua UI responsiva mesmo para janelas de contexto longas.

O streaming é ideal para interfaces de chat ou cenários de roleplay onde a latência é importante. Você não precisa esperar pela conclusão completa para renderizar o texto. O último chunk sempre contém as contagens de tokens para faturamento preciso. Erros durante o streaming ainda retornam códigos de status HTTP adequados para manipulação imediata.

Chamada de função e modo JSON

Use saídas estruturadas para extração confiável de dados ou integração de ferramentas. Ative response_format com {"type": "json_object"} para forçar a conformidade com JSON. Este modo é essencial para analisar estruturas aninhadas complexas sem lógica extra de limpeza. A chamada de funções funciona junto com a geração de texto padrão para fluxos de trabalho de agentes dinâmicos.

Defina suas ferramentas no tools array e especificar tool_choice para aplicação estrita. O modelo retorna chamadas de função no formato padrão da OpenAI. Esse recurso suporta chamadas de ferramenta únicas e múltiplas dentro de uma única interação. Use isso para construir agentes que interagem com APIs ou bancos de dados externos de forma confiável.

Gerenciamento de tokens e parâmetros

Controle o comportamento da geração com parâmetros padrão como temperature, top_p, e stop. A janela de contexto suporta até 100.000 tokens para prompt e combinação combinados. Isso permite um contexto histórico extenso ou processamento de documentos grandes em uma única solicitação.

Definir max_tokens limitar o comprimento da saída, com padrão de 2.048 se omitido. O modelo lida com presence_penalty e frequency_penalty para controle estilístico. O uso de tokens é cobrado com base nas contagens reais de entrada e saída. Erros não consomem tokens, garantindo cobrança justa para solicitações falhas.

Compreendendo os limites de taxa por chave

Cada chave de API suporta 300 requisições por minuto com um limite de concorrência de 8 requisições simultâneas. Esse limite aplica-se por chave, então criar várias chaves escala sua capacidade de processamento linearmente. O tamanho máximo do corpo da requisição é de 8 MB, o que se encaixa na janela de contexto para a maioria dos casos de uso.

Os limites de taxa são redefinidos continuamente com base em uma janela deslizante. Se você exceder o limite, a API retornará um erro 429. Faça upgrade do seu crédito pré-pago para manter o acesso prioritário. Ao contrário dos planos compartilhados, nossos servidores dedicados não sofrem com interferência de outros usuários. Monitore seu painel de uso para permanecer dentro desses limites para um desempenho consistente.

Solução de problemas de erros comuns

Lide com erros verificando o código de status HTTP e o corpo da resposta. Um erro 401 indica uma chave de API inválida ou ausente. Regere sua chave no painel se a autenticação falhar. Um erro 402 significa que seu crédito pré-pago está esgotado; recarregue via criptomoeda para retomar o serviço.

Um erro 429 sinaliza que você excedeu os limites de taxa. Reduza a frequência de suas solicitações ou divida as cargas de trabalho entre várias chaves. A API não cobra tokens por esses erros, então você não perde crédito por tentativas. Certifique-se de que sua biblioteca cliente lide com tentativas com backoff exponencial para maior robustez.

cURL

Copycurl https://api.openrouterratelimits.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Process one million logs"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openrouterratelimits.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openrouterratelimits.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Streaming

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)