Saltar al contenido

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 inferenceRegion por 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 GatewayINFRO
URL basehttps://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.
ClaveAI_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 modeloanthropic/claude-opus-5anthropic/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.
OpcionesproviderOptions.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 GatewayQué hace allíEn INFRO
Claves de API de AI Gateway y OIDCdistintoClaves 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 BYOKdistintoLas 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`distintoProbar 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, TPSnadaElegir un proveedor por solicitud según costo o velocidad.Nada. Deciden el orden o los pesos de una ruta.
Respaldos de modelosmisma formamodels, probados en orden.fallbacks, hasta 5.
Reglas de enrutamientomisma formaReglas de equipo sobre qué modelos se pueden usar.Listas de permitidos y bloqueados por organización, proyecto y clave, incluidos fabricantes completos.
Presupuestosmisma formaTopes 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 formaUsuario 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 promptsdistintocaching: '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 formaTrazas de OpenTelemetry hacia tu herramienta.Spans hacia tu colector de OpenTelemetry desde la ruta de la solicitud.
Embeddings y RealtimedistintoServido 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 inferencianadaEnrutamiento 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 gateway del 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 ejemplo anthropic/claude-opus-5. Consulta GET /v1/models para ver lo que sirven tus conexiones de INFRO.
¿El AI SDK funciona con INFRO?
Sí, con createOpenAI de @ai-sdk/openai y baseURL: https://api.infro.io/v1, llamando a infro.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.