Saltar al contenido

Guías de migraciónDesde Google Vertex AI

De Vertex AI como único proveedor a Vertex como uno de tus proveedores

Vertex AI, ahora parte de Gemini Enterprise Agent Platform, sirve Gemini y Claude de Anthropic en tu proyecto de Google Cloud, facturado por Google. INFRO lo llama con una cuenta de servicio de ese proyecto. Tu app llama a un solo endpoint y puede hacer failover entre Claude en Vertex y Claude en Anthropic, o entre Gemini en Vertex y Gemini en Google AI, con los presupuestos comprobados antes de cada llamada.

Renombrado Gemini Enterprise Agent Platform el 2026-04-22; mismos hosts aiplatform.googleapis.com

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

El cambio de nombre

Las notas de versión de Google dicen que el 2026-04-22 Vertex AI pasó a formar parte de Gemini Enterprise Agent Platform; la API de Vertex AI es ahora la Agent Platform API. Los hosts aiplatform.googleapis.com siguen siendo los documentados.

Cambios en el SDK

El Google Gen AI SDK ahora acepta enterprise=True y mantiene vertexai=True como flag heredado. El 2026-09-18 el SDK de Python anterior pasó a google-cloud-agentplatform.

Lo que INFRO llama

Vertex AI en locations/global en tu proyecto, con tokens de corta duración firmados con una clave de cuenta de servicio que solo necesita roles/aiplatform.user. Cada modelo Claude debe estar habilitado en su tarjeta de Model Garden.

Si todo lo que ejecutas está en Google Cloud y las herramientas de Google ya responden tus preguntas, quédate. Estos son los casos concretos.

  • Tu organización prohíbe las claves de cuenta de servicio. La conexión de Vertex de INFRO usa una; no usa federación de identidades de cargas de trabajo.
  • Usas cachés de contexto explícitas (caches.create y cached_content), grounding u otras funciones nativas de Gemini que las formas de chat no transportan.
  • Dependes de que las labels lleguen a Cloud Billing para asignar costos. INFRO registra la atribución en su propio metadata.
  • Necesitas un endpoint regional o multirregional por residencia. INFRO llama a la ubicación global; la residencia está en la hoja de ruta.

Los cambios, uno por fila. Todo lo que no aparece aquí queda como está.

 Google Vertex AIINFRO
URL baseaiplatform.googleapis.com/v1/projects/{project}/locations/{location}/...https://api.infro.io/v1 (forma de OpenAI), https://api.infro.io para el SDK de Anthropic.
CredencialUn token de acceso de una hora de Application Default Credentials.Una clave del gateway de INFRO. INFRO guarda la clave de la cuenta de servicio, sellada, y firma sus propios tokens de corta duración.
Id del modelogemini-3.8-flash, google/gemini-3.8-flash, claude-sonnet-5-5.google/gemini-3.8-flash, anthropic/claude-sonnet-5.5; el SDK de Anthropic puede mantener claude-sonnet-5-5 en /v1/messages.
Camposlabels, o X-Vertex-AI-Labels para modelos de partners.metadata { user_id, session_id, tags }, registrado por INFRO, no enviado a Google.

Antes · Vertex AI

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  enterprise: true, // formerly vertexai: true
  project: "my-project",
  location: "global",
});

const response = await ai.models.generateContent({
  model: "gemini-3.8-flash",
  contents: "Hello",
  config: { labels: { team: "search" } },
});

Después · INFRO

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.infro.io/v1",
  apiKey: process.env.INFRO_API_KEY,
});

await client.chat.completions.create({
  model: "google/gemini-3.8-flash",
  messages: [{ role: "user", content: "Hello" }],
  // @ts-expect-error INFRO extension
  metadata: { tags: { team: "search" } },
});

Gemini pasa a la forma de OpenAI

El código sobre el Gen AI SDK cambia la forma de la solicitud a Chat Completions. Las funciones que esa forma no transporta, como las cachés de contexto explícitas, son un motivo para mantener esas llamadas directas.

Claude se queda en la forma de Anthropic

En una conexión de Vertex, /v1/messages envía el cuerpo tal como está escrito: bloques de razonamiento, cache_control y herramientas incluidos. Una ruta puede poner Vertex primero y Anthropic segundo para el mismo modelo Claude.

Una cuenta de servicio

Otórgale solo roles/aiplatform.user. INFRO firma con ella tokens de una hora por llamada y no lee nada más del proyecto.

Los objetos de Google Vertex AI frente a los de INFRO, según la documentación pública de Google Vertex AI leída el 19 de octubre de 2026 y comprobados contra lo que implementa el gateway. Una fila dice que INFRO no tiene nada.

Google Vertex AIQué hace allíEn INFRO
Proyecto y credencialesdistintoTu proyecto de Google Cloud; tokens de ADC o de cuenta de servicio.Una conexión de Vertex con una clave de cuenta de servicio, sellada; tokens firmados por llamada. Sin federación de identidades de cargas de trabajo.
Gemini `generateContent`distintoLa API nativa de Gemini a través del Gen AI SDK.Servido con la forma de OpenAI en chat completions; las funciones solo nativas no se transportan.
Claude `rawPredict`misma formaEl cuerpo de Messages de Anthropic en Vertex./v1/messages, enviado a Vertex tal como está escrito.
Endpoints globales y regionalesdistintoElegir global, una región o una multirregión.Solo la ubicación global.
EtiquetasdistintoEtiquetas de costo enviadas a Cloud Billing.Atribución por metadata en el registro de solicitudes y el uso de INFRO, por proyecto, clave, usuario y etiqueta.
Caché de contextonadaCachés explícitas creadas y referenciadas con cached_content.Nada equivalente. El cache_control de Claude llega a Vertex tal como está escrito; INFRO agrega una caché de respuestas por coincidencia exacta.
Cuota y Provisioned ThroughputdistintoDynamic Shared Quota, niveles Standard PayGo, Provisioned Throughput.Sin cambios del lado de Google; un 429 sigue la regla de fallo de la ruta. INFRO agrega presupuestos en dólares.
FailoverdistintoEl endpoint global elige una región; entre proveedores es cosa de tu código.Rutas entre Vertex, Anthropic, Google AI y otros, con reglas de fallo por tipo.

Nuestra lectura de la documentación publicada de Google Vertex AI, no una prueba ni un benchmark. Si leímos algo mal, dínoslo y corregiremos la fila.

Lo que INFRO no hace

  • Usar federación de identidades de cargas de trabajo o ADC; requiere una clave de cuenta de servicio.
  • Llamar a endpoints regionales o multirregionales de Vertex.
  • Transportar funciones nativas de Gemini, como cachés de contexto explícitas o grounding.
  • Enviar etiquetas de facturación o conciliar con la facturación de Google Cloud.

Lo que no se traslada

  • Historial de Cloud Logging y Monitoring; se queda en Google Cloud.
  • Cachés de contexto; se quedan en tu proyecto.

Preguntas

¿Puede INFRO enrutar Claude en Vertex AI?
Sí. Conecta Vertex AI con una clave de cuenta de servicio, habilita el modelo Claude en Model Garden y llama a /v1/messages o a chat completions.
¿Quién me factura el uso?
Google Cloud, en tu propio proyecto. INFRO es una suscripción y agrega 0% al gasto en modelos.
¿Qué permisos necesita INFRO?
Una cuenta de servicio con roles/aiplatform.user. INFRO la usa solo para llamar a Vertex AI.

Migra con nosotros o por tu cuenta

El programa de migración traslada en una llamada tu configuración de Google Vertex AI 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.

Prueba de 14 días Reserva una sesión de migraciónLeer la guía de inicio rápido

Fuentes

Cada afirmación de esta página sobre Google Vertex AI 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.