Guia da API OpenRouter: uma API para IA de ponta

Uma chave de API, um endpoint, centenas de modelos de linguagem. Essa é a proposta da API do OpenRouter — e como ela fala o esquema da OpenAI, a maioria dos apps pode adotá-la trocando apenas a base URL. Este guia leva você do zero a chamadas prontas para produção.

O que você vai aprender:

• Criar uma chave e fazer sua primeira requisição com curl, Python e TypeScript

• Ler slugs de modelos (vendor/model) e usar variantes como :free, :nitro e :floor

• Lidar com streaming, limites de taxa e fallbacks multi-modelo

• Saber quanto a plataforma custa — e quando um gateway multimodal é a melhor escolha

Como o OpenRouter funciona

O catálogo de modelos

O OpenRouter lista centenas de modelos da OpenAI, Anthropic, Google, Meta, Mistral, DeepSeek, Qwen e outros, cada um com preço por token e especificações de contexto na sua página de modelo ^[1].

Como uma requisição flui

Sua requisição chega ao endpoint unificado, o roteador escolhe um provedor upstream para aquele modelo (muitos modelos têm vários), executa e normaliza a resposta para o formato da OpenAI. Por padrão, a seleção de provedor equilibra preço e disponibilidade ^[2].

Quanto custa

A inferência é cobrada pelo preço de tabela do provedor, sem margem; a plataforma cobra 5.5% (mín. $0.80) na compra de créditos, e os modelos gratuitos têm teto de 50 requisições/dia (1,000/dia depois que você compra $10+ em créditos) ^[3].

Início rápido

1. Crie uma conta e uma chave

Cadastre-se, compre um pacote pequeno de créditos (isso também desbloqueia o limite gratuito mais alto) e gere uma chave no dashboard. Chaves são bearer tokens — mantenha-as no servidor.

2. Primeira requisição com curl

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.2",
    "messages": [{"role": "user", "content": "Hello from the unified API"}]
  }'

3. Python e TypeScript

Os SDKs oficiais da OpenAI funcionam sem alterações:

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="sk-or-...",
)

resp = client.chat.completions.create(
    model="google/gemini-2.5-pro",
    messages=[{"role": "user", "content": "Three taglines for a coffee app"}],
)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
});

Slugs de modelos e variantes

Lendo um slug

Os IDs de modelo seguem o padrão vendor/model-name, por exemplo anthropic/claude-sonnet-4.5 ou deepseek/deepseek-chat. A string exata na página do modelo é a string exata que a API espera.

As variantes de sufixo

Variantes são dicas de roteamento, não pesos diferentes — mesmo modelo, seleção de provedor diferente ^[2].

Escolhendo um modelo

Filtre o catálogo por preço, janela de contexto e modalidade, depois faça benchmarks na sua própria tarefa. A escada pragmática: prototipe numa variante :free, lance com um modelo intermediário e reserve um modelo de fronteira para os 10% mais difíceis das requisições.

Questões de produção

Streaming

Defina "stream": true e consuma server-sent events — idêntico ao contrato de streaming da OpenAI, então o código de UI de streaming existente funciona sem mudanças.

Limites de taxa e retries

Os limites escalam com seu saldo de créditos em vez de faixas fixas; respostas 429 devem acionar backoff exponencial. Para modelos gratuitos, planeje em torno dos tetos de 50/1,000 por dia ^[3].

Fallbacks

Passe um array models ordenado por prioridade e o roteador tenta o próximo modelo no lado do servidor em caso de erros ou limites de taxa ^[4]:

{
  "model": "openai/gpt-5.2",
  "models": ["anthropic/claude-sonnet-4.5", "deepseek/deepseek-chat"],
  "messages": [{ "role": "user", "content": "..." }]
}

Quando você precisa de mais do que modelos de linguagem

O OpenRouter unifica texto. No momento em que seu roadmap diz "gerar uma imagem de produto" ou "adicionar um clipe de vídeo", você volta às integrações por fornecedor — a menos que seu gateway cubra essas modalidades nativamente.

Uma API unificada que inclui modelos de mídia

APIMart aplica o mesmo padrão de chave única a 500+ modelos de chat, imagem (GPT-Image-2), vídeo (Sora 2, Kling, Veo) e áudio (Suno).

Preços abaixo da tabela, não na tabela

Os modelos são oferecidos cerca de 20% abaixo dos preços oficiais, com as tarifas originais e com desconto de cada modelo publicadas na página de preços — sem contas de taxas à parte.

Drop-in para o mesmo código

Os endpoints são compatíveis com a OpenAI, então o início rápido acima funciona com outra base URL e outra chave. Seu registro de modelos e sua lógica de fallback migram sem nenhum ajuste.

Acesse 500+ modelos de IA com uma única chave de API

Modelos de chat, imagem, vídeo e áudio atrás de uma única API compatível com a OpenAI — preços transparentes de pagamento por uso, cerca de 20% abaixo das tarifas oficiais.

Comece a construir

Recapitulando

Aponte um SDK da OpenAI para o endpoint unificado, referencie modelos pelo slug vendor/model, use :floor ou :nitro quando custo ou velocidade importarem, adicione um array de fallback models antes da produção e lembre-se de que o custo real é o preço de tabela mais a taxa de recarga de 5.5% ^[3]. Se o seu app também precisa de imagens, vídeo ou áudio, comece com um gateway que já os cubra.