Respuesta corta
Pasar de OpenRouter a APIVAI supone cambiar tres cosas: la base URL (https://api.apivai.com/v1 para clientes con formato OpenAI, https://api.apivai.com para clientes con formato Anthropic como Claude Code), la clave de API y los IDs de modelo (anthropic/claude-sonnet-4.6 pasa a ser claude-sonnet-4-6). Tiene sentido si la mayor parte de tu tráfico va a modelos Claude o GPT: a fecha de 2026-11-18, APIVAI ofrece la mayoría de los modelos Claude 60–63% por debajo del precio de lista y los GPT hasta 86% por debajo de lista.
Para una comparación completa lado a lado, consulta OpenRouter frente a APIVAI.
| Modelo | Precio de lista (entrada / salida, por 1M) | APIVAI (entrada / salida, 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 |
Precios de APIVAI a fecha de 2026-11-18; la página de precios incluye todos los modelos. OpenRouter suele cobrar el precio de lista del proveedor para estos modelos; consulta los precios de OpenRouter para las condiciones actuales.
Antes de empezar
- Crea una cuenta en APIVAI con tu correo y un código de verificación.
- Añade saldo. La recarga mínima es de $10 con tarjeta o criptomonedas, o ¥20 con Alipay / WeChat Pay.
- En el Dashboard, crea una clave de API. Puedes dar a cada clave su propio presupuesto, lo que es útil si quieres una clave aparte para probar la migración.
¿Cómo se corresponden los IDs de modelo de OpenRouter con los de APIVAI?
OpenRouter usa IDs con formato proveedor/modelo y puntos en los números de versión. APIVAI usa el ID de modelo sin prefijo, con guiones en el caso de Claude. La columna de OpenRouter de abajo muestra el patrón habitual; comprueba los IDs exactos en la página de modelos de OpenRouter, porque pueden variar.
| ID al estilo OpenRouter | ID en 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 |
Los IDs de GPT en APIVAI conservan los puntos (gpt-5.6-sol, gpt-6.1-sol); solo desaparece el prefijo openai/. Para obtener la lista oficial desde tu propia clave, llama a GET /v1/models (se muestra en la sección de pruebas de abajo).
Paso 1: variables de entorno
Si tu código lee la base URL y la clave del entorno, este es todo el cambio para los clientes con formato OpenAI:
# Antes (OpenRouter) export OPENAI_BASE_URL="https://openrouter.ai/api/v1" export OPENAI_API_KEY="sk-or-..." # Después (APIVAI) export OPENAI_BASE_URL="https://api.apivai.com/v1" export OPENAI_API_KEY="your-apivai-key"
Después actualiza el ID de modelo allí donde esté definido (a menudo una variable MODEL o un archivo de configuración).
Paso 2: SDK de 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)El streaming (stream=True), las llamadas a herramientas y las imágenes de entrada funcionan igual. Si pasabas extra_headers o extra_body para OpenRouter, elimínalos (ver más abajo).
Paso 3: SDK de 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);La Responses API (client.responses.create) también funciona con la misma base URL.
Paso 4: LangChain y frameworks similares
La mayoría de los frameworks envuelven el cliente de OpenAI y aceptan una base URL y una clave. En ChatOpenAI de LangChain suele ser así:
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="claude-sonnet-4-6",
base_url="https://api.apivai.com/v1",
api_key="your-apivai-key",
)Los nombres de los parámetros cambian entre frameworks y versiones (base_url, openai_api_base, baseURL), así que revisa la documentación de tu librería. Si usabas una integración específica de OpenRouter, sustitúyela por el cliente genérico compatible con OpenAI del framework.
Paso 5: Cursor
En Cursor, abre Settings > Models, activa Override OpenAI Base URL y ponlo en https://api.apivai.com/v1. Pega tu clave de APIVAI como clave de API de OpenAI y añade como modelos personalizados los IDs que quieras (por ejemplo claude-sonnet-4-6 o gpt-5.6-sol). La guía de configuración de Cursor cubre los detalles.
Paso 6: Cline
En la configuración de Cline, elige el proveedor OpenAI Compatible, pon la base URL en https://api.apivai.com/v1, pega tu clave de APIVAI e introduce un ID de modelo como claude-sonnet-4-6. Los nombres de los menús cambian entre versiones, pero lo que importa son estos tres campos. Continue y extensiones similares siguen el mismo patrón.
Paso 7: Claude Code
Claude Code habla el formato Anthropic Messages, y APIVAI lo sirve de forma nativa, así que no hace falta ninguna capa de traducción. Ten en cuenta que la base URL va sin /v1:
export ANTHROPIC_BASE_URL="https://api.apivai.com" export ANTHROPIC_AUTH_TOKEN="your-apivai-key" unset ANTHROPIC_API_KEY # si está definida, tiene prioridad y provoca errores 401
Arranca claude y cambia de modelo con /model. Si antes enviabas Claude Code a través de OpenRouter o de un proxy, elimina esa configuración. Paso a paso completo: guía de configuración de Claude Code.
¿Qué ajustes específicos de OpenRouter debes quitar?
- Opciones de enrutamiento de proveedor, como un objeto
provideren el cuerpo de la solicitud: APIVAI no usa estas opciones. Elimínalas. - El array de respaldo
modelsy campos similares de las solicitudes de OpenRouter: no se admiten. Envía un únicomodel. - Las cabeceras
HTTP-RefereryX-Title: sirven para la atribución de apps de OpenRouter. Simplemente no hacen falta; puedes borrarlas. - Sufijos de ID de modelo o modelos de enrutamiento automático: usa en su lugar un ID de modelo concreto de APIVAI.
Si dependías del respaldo automático de modelos de OpenRouter, lleva esa lógica a tu propio código. Una versión 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}")¿Cómo pruebas el cambio?
Lista los modelos que puede usar tu clave:
curl https://api.apivai.com/v1/models \ -H "Authorization: Bearer your-apivai-key"
Envía un 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"}]}'Después revisa el Dashboard: cada solicitud aparece con sus tokens y su coste. Errores habituales: 401 significa una clave incorrecta o sin presupuesto (o que ANTHROPIC_API_KEY se impone en Claude Code); 404 suele significar que la base URL es incorrecta (la dirección final debe ser https://api.apivai.com/v1/chat/completions o https://api.apivai.com/v1/messages; la mayoría de los clientes con formato OpenAI usan https://api.apivai.com/v1, Claude Code y el SDK de Anthropic usan https://api.apivai.com); 429 significa más de 60 solicitudes por minuto en una clave.
¿Puedes usar ambos en paralelo durante la migración?
Sí, y en producción es el camino más seguro. Mantén dos clientes y elige uno con un flag de configuración:
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"Mueve primero un servicio o una parte del tráfico, compara la salida y el coste durante unos días y luego cambia el resto. El límite es de 60 solicitudes por minuto por clave; si el tráfico de producción necesita más, repártelo entre varias claves.
¿Qué pierdes al dejar OpenRouter?
Amplitud de modelos. APIVAI ofrece solo modelos Claude y GPT. Si usas modelos de pesos abiertos, Gemini, Mistral u otras familias a través de OpenRouter, seguirás necesitando OpenRouter u otro proveedor para ellos, y mantener ambos es una configuración razonable. APIVAI tampoco ofrece endpoints de Batch, Files, embeddings, generación de imágenes, audio ni fine-tuning; la API oficial de OpenAI y la API de Anthropic sí los ofrecen.
Lo que se mantiene o mejora para el tráfico de Claude y GPT: una clave para los formatos OpenAI y Anthropic, streaming y llamadas a herramientas en ambos, y el coste de cada solicitud en el Dashboard. APIVAI no guarda ni inspecciona el contenido de las solicitudes ni de las respuestas; solo se conservan los metadatos de uso para la facturación.
FAQ
¿Tengo que cambiar mi código o solo la configuración?
Normalmente solo la configuración: base URL, clave de API e ID de modelo. Solo hace falta cambiar código si usabas campos o cabeceras de solicitud específicos de OpenRouter, que debes eliminar.
¿Puedo seguir usando el SDK de OpenAI con modelos Claude?
Sí. Apunta el SDK de OpenAI a https://api.apivai.com/v1 y usa un ID de Claude como claude-sonnet-4-6. También puedes usar el SDK de Anthropic con la base URL https://api.apivai.com.
¿APIVAI admite respaldo automático de modelos?
No. Cada solicitud va al modelo que indiques. Implementa el respaldo en tu código capturando los errores y reintentando con otro ID de modelo.
¿Puedo pasar mis créditos de OpenRouter a APIVAI?
No, los saldos son independientes. Gasta o gestiona tus créditos de OpenRouter según sus condiciones, y recarga APIVAI desde $10 (tarjeta o criptomonedas) o ¥20 (Alipay / WeChat Pay).
¿Cómo pago APIVAI?
Con tarjeta de crédito o débito, criptomonedas (USDT y más), Alipay o WeChat Pay. La facturación es un saldo prepago, sin suscripción ni mínimo mensual.
¿Dónde puedo comparar los dos servicios con más detalle?
Consulta OpenRouter frente a APIVAI para la comparación completa y la documentación para todos los endpoints.