Vercel AI Gateway: una API key, cientos de modelos de IA sin markup y con failover automático
Vercel AI Gateway es un servicio que unifica el acceso a cientos de modelos de IA de múltiples providers —OpenAI, Anthropic, xAI, Google, Meta, Moonshot, NVIDIA y más— a través de una sola API key, con sin markup en tokens, failover automático entre providers y observabilidad integrada. Es, en esencia, un router inteligente para todo tu stack de IA.
En lugar de firmar contratos con N providers, integrar N SDKs y gestionar N dashboards de billing, AI Gateway te da una única integración, una sola factura y un panel unificado para todo.
Qué problemas resuelve
Si construyes aplicaciones con IA, te enfrentas a varios problemas recurrentes:
- Integración múltiple: cada provider tiene su propio SDK, su propia API, su propia auth
- Billing fragmentado: pagas a OpenAI, Anthropic, xAI por separado, sin visibilidad unificada
- Fallos de provider: cuando un provider cae, tu app cae
- Gestión de keys: rotar, auditar y controlar gasto por key, por usuario, por proyecto
- Cumplimiento: asegurar que los datos no se usan para entrenamiento
AI Gateway aborda todo esto desde una sola capa.
Características principales
1. Una API key, cientos de modelos
Accedes a modelos de todos los providers principales con una sola API key de Vercel. Sin gestionar keys separadas por provider. Los nuevos modelos están disponibles el día cero de su lanzamiento.
2. Sin markup en tokens
Pagas exactamente lo que el provider cobra. $0 de fee de plataforma. Si OpenAI cobra $5/1M input para GPT-5.6 Sol, pagas $5/1M input. Sin recargo. Esto aplica también con Bring Your Own Key (BYOK).
3. Failover automático entre providers
Si un provider se degrada o cae, AI Gateway reintenta automáticamente con el mismo modelo en otro provider. Output idéntico, sin downtime. Configuras el routing una vez y el Gateway maneja la resiliencia.
4. API unificada compatible con tu SDK existente
AI Gateway funciona con:
- AI SDK v5 y v6 de Vercel
- OpenAI Chat Completions — apunta tu SDK de OpenAI al Gateway, mismo código
- OpenAI Responses API
- Anthropic Messages API
- Endpoint compatible con OpenResponses
Migrar es típicamente un cambio de base URL sin reescribir código.
5. Bring Your Own Key (BYOK)
Si ya tienes keys de OpenAI, Anthropic u otros providers, puedes usarlas a través del Gateway sin fee ni markup. Tus compromisos existentes con providers fluyen directamente. Si tu key falla, el Gateway reintenta con credenciales del sistema (ese fallback se cobra contra tu balance de créditos).
6. Zero Data Retention (ZDR)
Puedes configurar que las requests se enruten solo a providers que acuerdan no retener ni entrenar con tus datos. Configurable por request o a nivel team. Ideal para entornos con requisitos de compliance estrictos.
7. Provider allowlist
Restringe qué providers puede usar tu team. A nivel team-wide o por request individual. Útil para políticas de seguridad corporativas.
8. Observabilidad integrada
El dashboard muestra:
- Uso y gasto por modelo, provider y proyecto
- Volumen de requests
- TTFT (Time To First Token)
- Conteo de tokens (input/output/cached)
- Errores y rate limits
9. Gestión de presupuesto y cuotas
- Per-key budgets: establece límites de gasto por API key desde el dashboard o CLI
- Per-user spending limits: limita el gasto de usuarios individuales en keys compartidas, sin necesidad de keys separadas
- OIDC tokens de corta duración: autentica con credenciales que expiran, sin credenciales estáticas
10. Custom Reporting API
Etiqueta requests por usuario, cliente, feature o entorno. Consulta los datos via API para analizar gasto en tus propios sistemas.
11. Modalidades múltiples
No solo texto. A través de un solo endpoint:
- Texto (chat/completion)
- Imagen (generación y análisis)
- Video
- Audio (speech, transcripción, realtime)
- Embeddings
- Reranking
12. AWS Marketplace
AI Gateway está disponible en AWS Marketplace. Puedes comprarlo con private offers y aplicar el gasto hacia tus commits de AWS existentes.
Modelos disponibles
AI Gateway da acceso a cientos de modelos de todos los providers principales. Algunos destacados a julio 2026:
| Modelo | Provider | Contexto | Input ($/1M) | Output ($/1M) |
|---|---|---|---|---|
| GPT-5.6 Sol | OpenAI | 1.1M | $5 | $30 |
| GPT-5.6 Luna | OpenAI | 1.1M | $1 | $6 |
| GPT-5.6 Terra | OpenAI | 1.1M | $2.50 | $15 |
| Claude Fable 5 | Anthropic | 1M | $10 | $50 |
| Claude Sonnet 5 | Anthropic | 1M | $3 | $15 |
| Claude Opus 4.8 | Anthropic | 1M | $5-$10 | $25-$50 |
| Grok 4.5 | xAI | 500K | $2 | $6 |
| Gemini Omni Flash | 1M | $1.50 | $9 | |
| Kimi K3 | Moonshot | 1M | $3 | $15 |
| Nemotron 3 Ultra | NVIDIA | 1M | $0.37 | $1.08 |
| GLM-5.2 | Zhipu | 1M | $0.90 | $2.84 |
| Qwen 3.7 Plus | Alibaba | 1M | $0.32 | $1.28 |
| Inkling | Thinking Machines | 256K | $1 | $4.05 |
Puedes ver el catálogo completo y actualizado en vercel.com/ai-gateway/models.
Precios
Modelo: pay-as-you-go sin markup
AI Gateway usa un modelo de créditos pre-pagados. Compras créditos y el uso se descuenta del balance por request. Los tokens cuestan exactamente lo que el provider cobra — $0 de markup.
Free tier
- Cada team de Vercel obtiene créditos gratuitos al hacer su primera request
- Subset de modelos disponibles (no el catálogo completo)
- Rate limits más bajos por modelo
- Al comprar créditos, pasas al paid tier y el free credit mensual deja de aplicar
Paid tier
- Créditos comprados, sin obligación de renovar
- Acceso al catálogo completo de modelos
- Rate limits más altos
- BYOK disponible sin markup
- Auto top-up configurable: recarga automática cuando el balance baja de un umbral
Cargos adicionales por capacidades opcionales
| Capacidad | Costo | Disponibilidad |
|---|---|---|
Per-request provider filter (only) | Gratis | Todos los planes |
| Team-wide provider allowlist | $0.10 / 1.000 requests exitosas | Pro y Enterprise |
| Per-request zero data retention | Gratis | Pro y Enterprise |
| Team-wide zero data retention | $0.10 / 1.000 requests | Pro y Enterprise |
| Custom Reporting — Write | $0.075 / 1.000 tag/user ID/quota entity writes | Paid tier |
| Custom Reporting — Query | $5 / 1.000 queries al reporting endpoint | Paid tier |
Facturación Enterprise
Los clientes Enterprise pueden cambiar a una factura consolidada única de Vercel cubriendo todos los providers en su routing pool. Disponible también via AWS Marketplace con private offers.
Tutorial: cómo usar Vercel AI Gateway
Opción 1: Con AI SDK (recomendado)
import { generateText } from 'ai';
import { gateway } from '@ai-sdk/gateway';
const result = await generateText({
model: gateway('openai/gpt-5.6-sol'),
prompt: 'Explica qué es RAG en español'
});
console.log(result.text);
Opción 2: Migrar tu SDK de OpenAI existente
Si ya usas el SDK de OpenAI, solo cambias la base URL:
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.VERCEL_AI_GATEWAY_API_KEY,
baseURL: 'https://ai-gateway.vercel.sh/v1' // solo esto cambia
});
const response = await client.chat.completions.create({
model: 'openai/gpt-5.6-sol',
messages: [{ role: 'user', content: 'Hola' }]
});
Opción 3: Con Anthropic SDK
import Anthropic from '@anthropic-ai/sdk';
const client = new Anthropic({
apiKey: process.env.VERCEL_AI_GATEWAY_API_KEY,
baseURL: 'https://ai-gateway.vercel.sh/anthropic'
});
const response = await client.messages.create({
model: 'anthropic/claude-opus-4.8',
max_tokens: 1024,
messages: [{ role: 'user', content: 'Hola' }]
});
Opción 4: Con BYOK (Bring Your Own Key)
import { generateText } from 'ai';
import { gateway } from '@ai-sdk/gateway';
const result = await generateText({
model: gateway('openai/gpt-5.6-sol', {
providerOptions: {
gateway: {
apiKey: process.env.VERCEL_AI_GATEWAY_API_KEY,
// Tu key de OpenAI se configura en el dashboard de Vercel
}
}
}),
prompt: 'Hola'
});
Opción 5: Failover automático
import { generateText } from 'ai';
import { gateway } from '@ai-sdk/gateway';
const result = await generateText({
model: gateway('anthropic/claude-sonnet-5', {
providerOptions: {
gateway: {
// Si Anthropic cae, reintenta con otro provider del mismo modelo
fallbacks: ['anthropic/claude-sonnet-5']
}
}
}),
prompt: 'Tarea crítica que no puede fallar'
});
Opción 6: Descubrimiento dinámico de modelos
import { getAvailableModels } from '@ai-sdk/gateway';
const availableModels = await getAvailableModels();
availableModels.models.forEach((model) => {
console.log(`${model.id}: ${model.name}`);
if (model.pricing) {
console.log(` Input: $${model.pricing.input}/token`);
console.log(` Output: $${model.pricing.output}/token`);
}
});
También puedes consultar el endpoint REST sin autenticación:
curl https://ai-gateway.vercel.sh/v1/models
Opción 7: ZDR (Zero Data Retention) por request
const result = await generateText({
model: gateway('openai/gpt-5.6-sol', {
providerOptions: {
gateway: {
zeroDataRetention: true // esta request no se retiene ni entrena
}
}
}),
prompt: 'Datos sensibles'
});
Ventajas sobre ir directo a cada provider
| Característica | Directo a provider | Vercel AI Gateway |
|---|---|---|
| Integraciones | N SDKs, N APIs, N auths | Una API key, un SDK |
| Billing | N facturas, N dashboards | Una factura, un dashboard |
| Markup en tokens | $0 (precio provider) | $0 (sin markup) |
| Failover automático | No — si cae, tu app cae | Sí — reintenta en otro provider |
| Nuevos modelos | Integrar manualmente cada uno | Disponibles day-zero |
| BYOK | N/A | Sí, sin fee |
| ZDR | Por provider, manual | Configurable por request o team |
| Observabilidad | Por provider, fragmentada | Unificada: TTFT, tokens, gasto, errores |
| Presupuesto por key/usuario | No nativo | Sí, desde dashboard o CLI |
| OIDC tokens | No | Sí, credenciales de corta duración |
| AWS Marketplace | No | Sí, aplica a commits de AWS |
Casos de uso
1. Aplicación con múltiples modelos
Usas GPT-5.6 para tareas complejas, Claude Sonnet 5 para escritura, Gemini Flash para respuestas rápidas y Nemotron para embeddings. Con AI Gateway, una sola integración, una sola factura.
2. Alta disponibilidad
Tu app no puede caer. Configuras failover: si OpenAI se degrada, el Gateway reintenta con el mismo modelo en otro provider automáticamente.
3. Optimización de costes
Monitoreas gasto unificado por modelo, provider y proyecto. Identificas qué modelo es más costoso y cambias a uno más barato con un cambio de una línea de código.
4. Compliance empresarial
Activas ZDR team-wide para asegurar que ningún provider retiene o entrena con tus datos. Configuras allowlist para restringir a providers aprobados.
5. Multi-tenant SaaS
Etiquetas requests por cliente con Custom Reporting. Estableces per-user spending limits en keys compartidas. Cada cliente ve solo su uso.
6. Migración gradual
Ya usas el SDK de OpenAI. Cambias la base URL al Gateway. Todo sigue funcionando. Luego gradualmente exploras otros modelos y providers sin reescribir código.
Routing avanzado
AI Gateway permite configurar cómo se seleccionan providers y se rutean requests:
- Provider options: filtra y ordena providers por preferencia
- Model fallbacks: define modelos alternativos si el principal falla
- Provider timeouts: establece timeouts por provider
- Routing rules: reglas custom para selección de provider
- Automatic caching: cache de responses para reducir coste
- Service tiers: selecciona tier de servicio por modelo
Limitaciones a considerar
- Créditos pre-pagados por defecto: no es facturación post-pago estándar (Enterprise sí puede tener factura consolidada)
- Free tier limitado: subset de modelos y rate limits bajos
- Capacidades avanzadas en Pro/Enterprise: ZDR team-wide, allowlist team-wide y Custom Reporting requieren planes pagos
- Fallback con BYOK consume créditos: si tu key falla y el Gateway reintenta con credenciales del sistema, ese consumo se cobra
Preguntas frecuentes
¿Hay markup en los tokens?
No. Pagas exactamente lo que el provider cobra, con $0 de fee de plataforma. Esto aplica también con BYOK.
¿Necesito cambiar mi código?
Probablemente no. Si usas el SDK de OpenAI o Anthropic, migrar es un cambio de base URL. Si usas AI SDK, solo cambias el provider.
¿Qué pasa si un provider cae?
AI Gateway reintenta automáticamente con el mismo modelo en otro provider. Output idéntico, sin downtime.
¿Puedo usar mis propias keys de provider?
Sí, con BYOK. Sin markup ni fee. Si tu key falla, el Gateway reintenta con credenciales del sistema (ese fallback se cobra).
¿Mis datos se usan para entrenamiento?
Puedes activar ZDR (Zero Data Retention) por request o team-wide para asegurar que los providers no retengan ni entrenen con tus datos.
¿Cómo pago?
Pre-compras créditos en el dashboard. El uso se descuenta del balance por request. Puedes configurar auto top-up. Enterprise puede usar factura consolidada o AWS Marketplace.
¿Qué modelos están disponibles?
Cientos de modelos de OpenAI, Anthropic, xAI, Google, Meta, Moonshot, NVIDIA, Alibaba, Zhipu, ByteDance, Thinking Machines y más. Ver catálogo completo en vercel.com/ai-gateway/models.
Recursos
- Vercel AI Gateway (página principal)
- Catálogo de modelos
- Documentación
- Precios detallados
- Models & Providers docs
Conclusión
Vercel AI Gateway resuelve uno de los problemas más dolorosos de construir aplicaciones con IA: la fragmentación de providers. Con una sola API key, sin markup en tokens, failover automático, BYOK, ZDR, observabilidad unificada y gestión de presupuesto por key y usuario, elimina la complejidad de operar múltiples providers de IA sin añadir coste.
La promesa es simple: pagas lo mismo que irías directo a cada provider, pero con resiliencia, visibilidad y control que ningún provider individual te da. Para equipos que usan más de un modelo de IA —que en 2026 es prácticamente todos—, AI Gateway es una capa de infraestructura que reduce complejidad sin aumentar coste.
Y para los que ya están en el ecosistema Vercel, la integración es nativa: el AI SDK funciona out-of-the-box, el dashboard está en la misma plataforma, y el billing se unifica con el resto de tu cuenta. Es, simplemente, la forma más fácil de operar un stack multi-provider de IA.