Guías de migraciónDesde Vercel AI Gateway
Desde Vercel AI Gateway, con los mismos ids de modelo
Vercel AI Gateway es el proveedor por defecto del AI SDK: un nombre de modelo como openai/gpt-6-astra llega a él con una clave de Vercel o un token OIDC, servido con las credenciales de sistema de Vercel o con tus propias claves. INFRO usa los mismos ids vendor/model, así que lo que cambia es el proveedor y las opciones, no los nombres de los modelos.
Disponible de forma general en todos los planes de Vercel; documentación actualizada hasta el 2026-10-07
Las cuentas de INFRO son de autoservicio. El catálogo, la documentación y el contrato de la API son públicos, el gateway está desplegado, y todo lo que va más allá de v1 está marcado como Más adelante. Planes y prueba
Dónde están las cosas
En qué punto está
Un producto activo de Vercel en todos los planes. Las reglas de enrutamiento por equipo sobre qué modelos se pueden usar se lanzaron el 2026-07-02.
En qué cuenta se sirve la solicitud
Por defecto, las credenciales de sistema de Vercel, pagadas con créditos de AI Gateway. Con BYOK, la documentación de Vercel dice que una solicitud fallida con tus credenciales se reintenta con sus credenciales de sistema y se cobra en créditos, y que el gasto BYOK no se cuenta en los presupuestos.
Lo que INFRO no copia
INFRO no implementa el protocolo de AI Gateway: el proveedor gateway del AI SDK no puede apuntar a INFRO. Cambias a un proveedor compatible con OpenAI, que el AI SDK incluye.
Si tu app corre en Vercel y el gateway hace su trabajo, la integración es difícil de superar. Quédate si se cumple alguna de estas condiciones.
- Te autenticas con tokens OIDC de Vercel desde tus despliegues y no quieres ninguna clave de gateway. INFRO solo acepta sus propias claves.
- Usas Realtime, embeddings de otros proveedores o las funciones exclusivas del gateway del AI SDK. INFRO sirve embeddings en conexiones de OpenAI, Azure OpenAI, Mistral y compatibles con OpenAI, y no sirve Realtime.
- Quieres elegir proveedor por costo, tiempo hasta el primer token o rendimiento (
sort). INFRO no ordena por solicitud. - Quieres acceso a modelos sin una cuenta en cada proveedor. INFRO solo funciona con cuentas que tienes.
- Necesitas enrutamiento sin retención de datos o
inferenceRegionpor solicitud. INFRO no tiene ninguno de los dos; la residencia está en la hoja de ruta.
Los cambios, uno por fila. Todo lo que no aparece aquí queda como está.
| Vercel AI Gateway | INFRO | |
|---|---|---|
| URL base | https://ai-gateway.vercel.sh/v1, o el proveedor gateway por defecto del AI SDK. | https://api.infro.io/v1, mediante createOpenAI({ baseURL }) en el AI SDK. |
| Clave | AI_GATEWAY_API_KEY o un token OIDC de Vercel. | INFRO_API_KEY, una clave del gateway de INFRO. Tus credenciales de proveedor pasan a INFRO como conexiones. |
| Id del modelo | anthropic/claude-opus-5 | anthropic/claude-opus-5, sin cambios. En el AI SDK, llama a infro.chat(id): la función directa del proveedor apunta a la Responses API. |
| Opciones | providerOptions.gateway { order, only, models, user, tags }, encabezados ai-reporting-*. | Una ruta para el orden, routing.providers para only, fallbacks para los modelos, metadata { user_id, tags } para el usuario y las etiquetas. |
Antes · Vercel AI Gateway
import { generateText } from "ai";
const { text } = await generateText({
model: "anthropic/claude-opus-5",
prompt: "Hello",
providerOptions: {
gateway: {
order: ["vertex", "anthropic"],
user: "user_123",
tags: ["feature:chat"],
},
},
});Después · INFRO
import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";
const infro = createOpenAI({
baseURL: "https://api.infro.io/v1",
apiKey: process.env.INFRO_API_KEY,
});
const { text } = await generateText({
// A route named "chat" holds the order: Vertex, then Anthropic.
model: infro.chat("chat"),
prompt: "Hello",
headers: { "X-INFRO-User-Id": "user_123", "X-INFRO-Feature": "chat" },
});`.chat()`, no la función directa
createOpenAI(...)(id) apunta a la Responses API de OpenAI. Usa infro.chat(id) para Chat Completions, que sirven todas las conexiones de INFRO; /v1/responses también se sirve, pero necesita la conversación completa en cada turno.
Los slugs de proveedor difieren
Los vertex y bedrock de Vercel son google-vertex y aws-bedrock de INFRO en routing.providers. El orden se define en una ruta en la consola, no por solicitud.
Los presupuestos ven cada solicitud
Cada solicitud de INFRO corre en tu propia cuenta, así que cada solicitud cuenta contra tus presupuestos. Un presupuesto rechaza en su techo con 402 budget_exceeded.
Los objetos de Vercel AI Gateway frente a los de INFRO, según la documentación pública de Vercel AI Gateway leída el 19 de octubre de 2026 y comprobados contra lo que implementa el gateway. Dos filas dicen que INFRO no tiene nada.
| Vercel AI Gateway | Qué hace allí | En INFRO |
|---|---|---|
| Claves de API de AI Gateway y OIDCdistinto | Claves de equipo o tokens OIDC de Vercel; las claves llevan un presupuesto y una caducidad. | Claves del gateway con límite de gasto, lista de modelos permitidos, lista de proveedores, rangos de IP y entorno, que se pueden rotar o desactivar. Sin intercambio de tokens OIDC. |
| Credenciales de sistema y BYOKdistinto | Las cuentas de proveedor de Vercel por defecto; tus credenciales son opcionales, con respaldo en las credenciales de sistema. | Solo tus conexiones, nunca un pool compartido. Cada proveedor te factura directamente. |
| `order`, `only`distinto | Probar proveedores en orden, o limitarse a algunos, por solicitud. | Una ruta guarda el orden y las reglas de fallo; routing.providers restringe por solicitud. |
| `sort` por costo, TTFT, TPSnada | Elegir un proveedor por solicitud según costo o velocidad. | Nada. Deciden el orden o los pesos de una ruta. |
| Respaldos de modelosmisma forma | models, probados en orden. | fallbacks, hasta 5. |
| Reglas de enrutamientomisma forma | Reglas de equipo sobre qué modelos se pueden usar. | Listas de permitidos y bloqueados por organización, proyecto y clave, incluidos fabricantes completos. |
| Presupuestosmisma forma | Topes por equipo, proyecto, clave y usuario, 402 al superarlos; el gasto BYOK queda excluido. | Presupuestos por organización, proyecto, miembro, clave y cliente final, 402 antes de llamar al proveedor; cada solicitud cuenta. |
| Informes personalizadosmisma forma | Usuario y etiquetas por solicitud; una API de informes agrupada por usuario, modelo, etiqueta y proveedor. | metadata.user_id y tags en cada solicitud, uso agrupado por proyecto, clave, modelo, usuario y etiqueta, y exportaciones. |
| Caché automática de promptsdistinto | caching: 'auto' agrega marcadores de caché del proveedor; encabezado de afinidad de sesión. | La caché de prompts del proveedor funciona como la define el proveedor; cache_control llega a Anthropic tal como está escrito en /v1/messages. INFRO no agrega marcadores. Aparte, una caché de respuestas opcional por coincidencia exacta. |
| Trace Drainsmisma forma | Trazas de OpenTelemetry hacia tu herramienta. | Spans hacia tu colector de OpenTelemetry desde la ruta de la solicitud. |
| Embeddings y Realtimedistinto | Servido por el gateway. | Embeddings en tu conexión de OpenAI, Azure OpenAI, Mistral o compatible con OpenAI, con failover solo al mismo modelo. Realtime no se sirve. |
| ZDR y región de inferencianada | Enrutamiento sin retención de datos por solicitud e inferenceRegion. | No disponible. La retención en el proveedor sigue tu contrato con él; la residencia está en la hoja de ruta. |
Nuestra lectura de la documentación publicada de Vercel AI Gateway, no una prueba ni un benchmark. Si leímos algo mal, dínoslo y corregiremos la fila.
Lo que INFRO no hace
- Implementar el protocolo de AI Gateway o el proveedor
gatewaydel AI SDK. - Aceptar tokens OIDC de Vercel.
- Servir Realtime, o embeddings en proveedores distintos de OpenAI, Azure OpenAI, Mistral o un endpoint compatible con OpenAI.
- Ordenar proveedores por solicitud según costo o velocidad.
- Dar acceso a modelos sin tus propias cuentas de proveedor.
Lo que no se traslada
- Registros de solicitudes e informes personalizados. No hay importador.
- Créditos de AI Gateway. Se quedan con Vercel.
- Presupuestos y reglas de enrutamiento. Recréalos como presupuestos y listas de permitidos de INFRO.
Preguntas
- ¿Tengo que cambiar los ids de modelo?
- No. Ambos usan
vendor/model, por ejemploanthropic/claude-opus-5. ConsultaGET /v1/modelspara ver lo que sirven tus conexiones de INFRO. - ¿El AI SDK funciona con INFRO?
- Sí, con
createOpenAIde@ai-sdk/openaiybaseURL: https://api.infro.io/v1, llamando ainfro.chat(modelId). - ¿Quién me factura el uso de modelos?
- Tus proveedores, directamente, en tus propias cuentas. INFRO es una suscripción con 0% de margen sobre el gasto en modelos.
Migra con nosotros o por tu cuenta
El programa de migración traslada en una llamada tu configuración de Vercel AI Gateway a conexiones, rutas y presupuestos de INFRO, y migra contigo el primer servicio. Tus proveedores te siguen facturando directamente; INFRO es una suscripción y agrega 0% al gasto en modelos.
Fuentes
Cada afirmación de esta página sobre Vercel AI Gateway proviene de una de estas fuentes, leídas el 19 de octubre de 2026. Nada se deduce de una prueba, un benchmark o una conversación.
- Vercel docs — AI Gatewayleído el 19 oct 2026
- Vercel docs — OpenAI Chat Completions APIleído el 19 oct 2026
- Vercel docs — Chat Completions advancedleído el 19 oct 2026
- Vercel docs — BYOKleído el 19 oct 2026
- Vercel docs — Provider filtering and orderingleído el 19 oct 2026
- Vercel docs — Budgetsleído el 19 oct 2026
- Vercel docs — Custom reportingleído el 19 oct 2026
- Vercel docs — Automatic cachingleído el 19 oct 2026
- Vercel docs — Pricingleído el 19 oct 2026
- Vercel changelog — AI Gateway routing rulesleído el 19 oct 2026