Documentação da API

URL Base e Autenticação

O endpoint da API está localizado em https://api.openrouteraiapi.com/v1. Passe sua chave API no Authorization cabeçalho como um token bearer. Esta é a única alteração necessária para redirecionar o tráfego do seu provedor atual para nosso modelo sem censura.

A autenticação é rigorosa. Se a chave estiver ausente ou for inválida, o servidor retorna um erro 401 imediatamente. Você pode gerar uma chave instantaneamente via Google ou e-mail no painel. Mantenha a chave segura, pois ela concede acesso ao seu crédito pré-pago.

Endpoint Chat Completions

Envie solicitações POST para /v1/chat/completions com uma matriz de mensagens. O identificador do modelo é uncensored. Este modelo único lida com todas as suas necessidades de geração de texto sem lógica complexa de roteamento.

Aqui está uma solicitação padrão usando cURL para verificar a conectividade e o formato da resposta.

Copycurl https://api.openrouteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
  }'

A resposta inclui o texto gerado no choices[0].message.content campo. Você pode analisar isso diretamente no fluxo de trabalho da sua aplicação.

Integração do SDK Python

Use o cliente oficial do Python do OpenAI para conectar-se sem esforço. Defina o base_url e api_key variáveis para apontar para nossa infraestrutura. Essa abordagem minimiza as alterações de código ao mudar de provedor.

Copyfrom openai import OpenAI

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

O cliente lida com serialização e retentativas automaticamente. Você recebe um objeto de conclusão contendo o texto e as estatísticas de uso de tokens. Este método é ideal para serviços de backend e scripts.

Uso do SDK Node.js

Inicialize o cliente Node.js OpenAI com sua URL base personalizada. Isso permite que aplicações JavaScript interajam com o modelo uncensored usando métodos familiares. O SDK gerencia as solicitações HTTP de forma eficiente.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openrouteraiapi.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);

Chamar chat.completions.create() com suas mensagens. O objeto de resposta fornece acesso ao conteúdo gerado e aos dados de uso. Esta integração funciona bem para servidores web e funções de borda.

Respostas em Streaming

Ative o streaming definindo stream: true na sua solicitação. O servidor retorna Server-Sent Events (SSE) para entrega de tokens em tempo real. Este recurso reduz a latência percebida para usuários finais.

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)

Cada chunk contém conteúdo parcial. O último chunk inclui as estatísticas completas de uso de tokens. Manipule esses eventos no seu cliente para atualizar a interface do usuário incrementalmente.

Limites, Erros e Janela de Contexto

A janela de contexto suporta 100.000 tokens para entrada e saída combinadas. Cada solicitação pode gerar até 16.000 tokens, ou 2.048 se max_tokens está indefinido. Os limites de taxa permitem 300 solicitações por minuto por chave.

Os erros são códigos HTTP padrão. Um 401 indica uma chave inválida. Um 402 significa que seu crédito pré-pago se esgotou. Um 429 sinaliza que você excedeu o limite de taxa. Solicitações que falham não consomem crédito. Erros são gratuitos.