Início rápido para usuários do OpenRouter

Instalação e Configuração

Nossa API é totalmente compatível com SDKs padrão da OpenAI. Para migrar do OpenRouter, você só precisa atualizar dois valores de configuração: o base_url e o api_key. Aponte seu cliente para https://api.openrouterapi.cc/v1 e use a chave gerada no nosso painel. Não são necessários cabeçalhos personalizados ou lógica de roteamento complexa. O ID do modelo a solicitar é uncensored.

Certifique-se de que a versão do seu SDK suporte o parâmetro base_url. Se você estiver usando um cliente HTTP bruto, basta atualizar a URL de destino. Esta configuração garante que seu código de cliente existente funcione sem modificações, desde que você esteja enviando apenas solicitações de conclusão de texto.

Autenticação

A autenticação é feita via cabeçalho Authorization padrão. Passe sua chave de API como um token Bearer. Se a chave for inválida ou expirada, a API retorna um erro 401. Ao contrário de alguns provedores, não cobramos por solicitações falhas; erros e recusas são gratuitos, então você pode testar a autenticação sem consumir crédito.

Cada conta suporta uma chave ativa por vez. Gerar uma nova chave invalida imediatamente a anterior. Mantenha sua chave segura e faça a rotação se suspeitar de exposição. A chave é exibida imediatamente após o cadastro, então copie-a antes de sair da página.

Conclusão de Chat Básica

A funcionalidade principal é o endpoint POST /v1/chat/completions. Envie seu prompt como uma lista de mensagens e receba uma resposta de texto. O modelo é ajustado para responder sem recusas de conteúdo para uso adulto lícito, sendo adequado para tópicos criativos, controversos ou de pesquisa de segurança.

Defina o campo model como uncensored. Você pode controlar o comportamento usando parâmetros como temperature, top_p e stop. A API suporta modo JSON via response_format e chamada de funções via tools. Todas as solicitações são processadas de forma assíncrona e você recebe a conclusão completa assim que o modelo termina.

Respostas em Streaming

Ative o streaming definindo stream: true em sua solicitação. A API retorna Eventos Enviados pelo Servidor (SSE) com respostas parciais. Você recebe pedaços de texto conforme são gerados, permitindo exibição em tempo real no seu aplicativo.

As informações de uso de tokens são fornecidas no último chunk do streaming. Isso permite que você acompanhe os custos com precisão sem analisar cada token individual. O streaming é ideal para interfaces de chat onde a latência é importante. Certifique-se de que seu cliente lide corretamente com SSE e feche a conexão quando o streaming terminar.

Chamada de Funções

A API suporta chamada de funções via parâmetro tools. Defina suas funções no array tools e defina tool_choice como auto ou um nome de função específico. O modelo retornará argumentos JSON estruturados se uma função for acionada.

Este recurso é útil para integrar o LLM com APIs ou bancos de dados externos. Certifique-se de que as definições das suas funções estejam precisas, pois o modelo depende delas para gerar argumentos válidos. A API não executa as funções; você deve lidar com a lógica de execução no código do seu aplicativo.

Modo JSON

Para saídas estruturadas, use response_format: {"type": "json_object"}. Isso força o modelo a retornar JSON válido, o que é essencial para analisar dados em etapas seguintes. O modo JSON é frequentemente mais confiável do que a chamada de funções para tarefas simples de extração de dados.

Certifique-se de que seus prompts instruem claramente o modelo a retornar JSON. Respostas JSON inválidas podem ocorrer se o prompt for ambíguo. O modo JSON é suportado nos modos padrão e de streaming. Use-o quando precisar de saídas previsíveis e legíveis por máquina.

Limites, Erros e Contexto

A janela de contexto é de 100.000 tokens para o prompt e a resposta combinados. A saída máxima é de 32.000 tokens por requisição (2.048 se max_tokens não for definido). Os limites de taxa são de 300 requisições por minuto e 8 requisições simultâneas por chave. Os corpos das requisições são limitados a 8 MB.

Os erros retornam códigos HTTP padrão: 401 para chaves inválidas, 402 para crédito insuficiente e 429 para limites de taxa. O crédito é pré-pago, então um erro 402 significa que você precisa recarregar. Erros e recusas são gratuitos, então você pode tentar novamente sem custo. O limite rígido de conteúdo bloqueia conteúdo sexual envolvendo menores.

cURL

Copycurl https://api.openrouterapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openrouterapi.cc/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.openrouterapi.cc/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)