Resposta curta
Trocar o OpenRouter pela APIVAI significa mudar três coisas: a base URL (https://api.apivai.com/v1 para clientes no formato OpenAI, https://api.apivai.com para clientes no formato Anthropic, como o Claude Code), a chave de API e os IDs de modelo (anthropic/claude-sonnet-4.6 vira claude-sonnet-4-6). Faz sentido se a maior parte do seu tráfego vai para modelos Claude ou GPT: em 2026-11-18, a APIVAI cobra pela maioria dos modelos Claude 60–63% abaixo da tabela e pelos GPT até 86% abaixo da tabela.
Para uma comparação completa lado a lado, veja OpenRouter vs. APIVAI.
| Modelo | Preço de tabela (entrada / saída, por 1M) | APIVAI (entrada / saída, por 1M) |
|---|---|---|
| Claude Sonnet 4.6 | $3.00 / $15.00 | $1.14 / $5.68 |
| Claude Opus 5.5 | $4.00 / $20.00 | $1.52 / $7.57 |
| GPT-5.6 Sol | $4.00 / $20.00 | $0.61 / $3.65 |
Preços da APIVAI em 2026-11-18; a página de preços tem todos os modelos. O OpenRouter costuma cobrar o preço de tabela do provedor para esses modelos; veja os preços do OpenRouter para as condições atuais.
Antes de começar
- Crie uma conta na APIVAI com seu e-mail e um código de verificação.
- Adicione saldo. A recarga mínima é de $10 com cartão ou criptomoedas, ou ¥20 via Alipay / WeChat Pay.
- No Dashboard, crie uma chave de API. Você pode dar a cada chave o próprio orçamento, o que ajuda se quiser uma chave separada para testar a migração.
Como os IDs de modelo do OpenRouter correspondem aos da APIVAI?
O OpenRouter usa IDs no formato provedor/modelo, com pontos nos números de versão. A APIVAI usa o ID do modelo sem prefixo, com hífens no caso do Claude. A coluna do OpenRouter abaixo mostra o padrão usual; confira os IDs exatos na página de modelos do OpenRouter, porque podem variar.
| ID no estilo OpenRouter | ID na APIVAI |
|---|---|
anthropic/claude-sonnet-4.6 | claude-sonnet-4-6 |
anthropic/claude-opus-4.6 | claude-opus-4-6 |
anthropic/claude-haiku-4.5 | claude-haiku-4-5 |
anthropic/claude-opus-5.5 | claude-opus-5-5 |
anthropic/claude-sonnet-5 | claude-sonnet-5 |
openai/gpt-5.6-sol | gpt-5.6-sol |
Os IDs de GPT na APIVAI mantêm os pontos (gpt-5.6-sol, gpt-6.1-sol); só o prefixo openai/ sai. Para obter a lista oficial a partir da sua chave, chame GET /v1/models (mostrado na seção de testes abaixo).
Passo 1: variáveis de ambiente
Se o seu código lê a base URL e a chave do ambiente, esta é toda a mudança para clientes no formato OpenAI:
# Antes (OpenRouter) export OPENAI_BASE_URL="https://openrouter.ai/api/v1" export OPENAI_API_KEY="sk-or-..." # Depois (APIVAI) export OPENAI_BASE_URL="https://api.apivai.com/v1" export OPENAI_API_KEY="your-apivai-key"
Depois atualize o ID do modelo onde ele estiver definido (muitas vezes uma variável MODEL ou um arquivo de configuração).
Passo 2: SDK da OpenAI para Python
from openai import OpenAI
client = OpenAI(
base_url="https://api.apivai.com/v1",
api_key="your-apivai-key",
)
resp = client.chat.completions.create(
model="claude-sonnet-4-6", # antes "anthropic/claude-sonnet-4.6"
messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)Streaming (stream=True), chamada de ferramentas e imagens de entrada funcionam do mesmo jeito. Se você passava extra_headers ou extra_body para o OpenRouter, remova (veja abaixo).
Passo 3: SDK da OpenAI para Node
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.apivai.com/v1",
apiKey: process.env.APIVAI_KEY,
});
const resp = await client.chat.completions.create({
model: "gpt-5.6-sol", // antes "openai/gpt-5.6-sol"
messages: [{ role: "user", content: "Hello" }],
});
console.log(resp.choices[0].message.content);A Responses API (client.responses.create) também funciona com a mesma base URL.
Passo 4: LangChain e frameworks parecidos
A maioria dos frameworks envolve o cliente da OpenAI e aceita uma base URL e uma chave. No ChatOpenAI do LangChain costuma ser assim:
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="claude-sonnet-4-6",
base_url="https://api.apivai.com/v1",
api_key="your-apivai-key",
)Os nomes dos parâmetros mudam entre frameworks e versões (base_url, openai_api_base, baseURL), então veja a documentação da sua biblioteca. Se você usava uma integração específica do OpenRouter, troque pelo cliente genérico compatível com OpenAI do framework.
Passo 5: Cursor
No Cursor, abra Settings > Models, ative Override OpenAI Base URL e defina como https://api.apivai.com/v1. Cole sua chave da APIVAI como chave de API da OpenAI e adicione como modelos personalizados os IDs que quiser (por exemplo claude-sonnet-4-6 ou gpt-5.6-sol). O guia de configuração do Cursor cobre os detalhes.
Passo 6: Cline
Nas configurações do Cline, escolha o provedor OpenAI Compatible, defina a base URL como https://api.apivai.com/v1, cole sua chave da APIVAI e informe um ID de modelo como claude-sonnet-4-6. Os nomes dos menus mudam entre versões, mas o que importa são esses três campos. O Continue e extensões parecidas seguem o mesmo padrão.
Passo 7: Claude Code
O Claude Code fala o formato Anthropic Messages, e a APIVAI atende esse formato nativamente, então não é preciso nenhuma camada de tradução. Repare que a base URL não tem /v1:
export ANTHROPIC_BASE_URL="https://api.apivai.com" export ANTHROPIC_AUTH_TOKEN="your-apivai-key" unset ANTHROPIC_API_KEY # se estiver definida, tem prioridade e causa erros 401
Inicie o claude e troque de modelo com /model. Se antes você passava o Claude Code pelo OpenRouter ou por um proxy, remova essas configurações. Passo a passo completo: guia de configuração do Claude Code.
Quais configurações específicas do OpenRouter você deve remover?
- Opções de roteamento de provedor, como um objeto
providerno corpo da requisição: a APIVAI não usa essas opções. Remova. - O array de fallback
modelse campos parecidos das requisições do OpenRouter: não são suportados. Envie um únicomodel. - Os cabeçalhos
HTTP-ReferereX-Title: servem para a atribuição de apps do OpenRouter. Simplesmente não são necessários; pode apagar. - Sufixos de ID de modelo ou modelos de roteamento automático: use um ID de modelo concreto da APIVAI no lugar.
Se você dependia do fallback automático de modelos do OpenRouter, leve essa lógica para o seu próprio código. Uma versão mínima:
for model in ["claude-sonnet-4-6", "gpt-5.6-sol"]:
try:
resp = client.chat.completions.create(model=model, messages=messages)
break
except Exception as e:
print(f"{model} failed: {e}")Como testar a troca?
Liste os modelos que a sua chave pode usar:
curl https://api.apivai.com/v1/models \ -H "Authorization: Bearer your-apivai-key"
Envie um chat completion:
curl https://api.apivai.com/v1/chat/completions \
-H "Authorization: Bearer your-apivai-key" \
-H "Content-Type: application/json" \
-d '{"model": "claude-sonnet-4-6", "messages": [{"role": "user", "content": "Say OK"}]}'Depois confira o Dashboard: cada requisição aparece com os tokens e o custo. Erros comuns: 401 significa chave errada ou sem orçamento (ou ANTHROPIC_API_KEY sobrepondo no Claude Code); 404 geralmente significa base URL errada (o endereço final precisa ser https://api.apivai.com/v1/chat/completions ou https://api.apivai.com/v1/messages; a maioria dos clientes no formato OpenAI usa https://api.apivai.com/v1, o Claude Code e o SDK da Anthropic usam https://api.apivai.com); 429 significa mais de 60 requisições por minuto em uma chave.
Dá para rodar os dois em paralelo durante a migração?
Sim, e em produção é o caminho mais seguro. Mantenha dois clientes e escolha um por uma flag de configuração:
import os
from openai import OpenAI
if os.getenv("LLM_BACKEND") == "apivai":
client = OpenAI(base_url="https://api.apivai.com/v1", api_key=os.getenv("APIVAI_KEY"))
model = "claude-sonnet-4-6"
else:
client = OpenAI(base_url="https://openrouter.ai/api/v1", api_key=os.getenv("OPENROUTER_KEY"))
model = "anthropic/claude-sonnet-4.6"Mova primeiro um serviço ou uma parte do tráfego, compare saída e custo por alguns dias e depois troque o resto. O limite é de 60 requisições por minuto por chave; se o tráfego de produção precisar de mais, divida entre várias chaves.
O que você perde ao sair do OpenRouter?
Variedade de modelos. A APIVAI oferece só modelos Claude e GPT. Se você usa modelos de pesos abertos, Gemini, Mistral ou outras famílias pelo OpenRouter, ainda vai precisar do OpenRouter ou de outro provedor para eles, e manter os dois é uma configuração razoável. A APIVAI também não oferece endpoints de Batch, Files, embeddings, geração de imagens, áudio ou fine-tuning; a API oficial da OpenAI e a API da Anthropic oferecem.
O que se mantém ou melhora para o tráfego de Claude e GPT: uma chave para os formatos OpenAI e Anthropic, streaming e chamada de ferramentas nos dois, e o custo de cada requisição no Dashboard. A APIVAI não armazena nem inspeciona o conteúdo das requisições ou das respostas; só os metadados de uso são guardados para cobrança.
FAQ
Preciso mudar o código ou só a configuração?
Normalmente só a configuração: base URL, chave de API e ID do modelo. Só é preciso mexer no código se você usava campos ou cabeçalhos de requisição específicos do OpenRouter, que devem ser removidos.
Posso continuar usando o SDK da OpenAI com modelos Claude?
Sim. Aponte o SDK da OpenAI para https://api.apivai.com/v1 e use um ID do Claude como claude-sonnet-4-6. Você também pode usar o SDK da Anthropic com a base URL https://api.apivai.com.
A APIVAI tem fallback automático de modelos?
Não. Cada requisição vai para o modelo que você indicar. Implemente o fallback no seu código capturando os erros e tentando de novo com outro ID de modelo.
Posso transferir meus créditos do OpenRouter para a APIVAI?
Não, os saldos são separados. Use ou administre seus créditos do OpenRouter conforme as condições deles, e recarregue a APIVAI a partir de $10 (cartão ou criptomoedas) ou ¥20 (Alipay / WeChat Pay).
Como pago a APIVAI?
Com cartão de crédito ou débito, criptomoedas (USDT e outras), Alipay ou WeChat Pay. A cobrança é por saldo pré-pago, sem assinatura nem mínimo mensal.
Onde posso comparar os dois serviços com mais detalhes?
Veja OpenRouter vs. APIVAI para a comparação completa e a documentação para todos os endpoints.