본문으로 건너뛰기

마이그레이션 가이드Google Vertex AI에서

Vertex AI 단독에서, 여러 공급자 중 하나인 Vertex로

현재 Gemini Enterprise Agent Platform의 일부인 Vertex AI는 고객의 Google Cloud 프로젝트에서 Gemini와 Anthropic의 Claude를 제공하며, Google이 청구합니다. INFRO는 그 프로젝트의 서비스 계정으로 이를 호출합니다. 앱은 하나의 엔드포인트를 호출하고, Vertex의 Claude와 Anthropic의 Claude, 또는 Vertex의 Gemini와 Google AI의 Gemini 사이에서 페일오버할 수 있으며, 호출마다 먼저 예산을 확인합니다.

2026-04-22에 Gemini Enterprise Agent Platform으로 이름 변경. aiplatform.googleapis.com 호스트는 동일

INFRO 계정은 셀프 서비스입니다. 카탈로그, 문서, API 계약은 공개되어 있고, 게이트웨이는 배포되어 있으며, v1 이후의 기능은 Later로 표시됩니다. 요금제와 체험

현재 상황

이름 변경

Google 릴리스 노트에 따르면 2026-04-22에 Vertex AI는 Gemini Enterprise Agent Platform의 일부가 되었고, Vertex AI API는 이제 Agent Platform API입니다. aiplatform.googleapis.com 호스트는 여전히 문서화된 호스트입니다.

SDK 변경

Google Gen AI SDK는 이제 enterprise=True를 받으며, vertexai=True는 레거시 플래그로 유지됩니다. 2026-09-18에 이전 Python SDK는 google-cloud-agentplatform으로 옮겨졌습니다.

INFRO가 호출하는 것

고객 프로젝트의 locations/global에 있는 Vertex AI. roles/aiplatform.user만 필요한 서비스 계정 키로 단기 토큰을 서명합니다. 각 Claude 모델은 Model Garden 카드에서 활성화해야 합니다.

실행하는 모든 것이 Google Cloud에 있고 Google 도구가 이미 질문에 답하고 있다면 그대로 두세요. 구체적인 경우는 다음과 같습니다.

  • 조직에서 서비스 계정 키를 금지합니다. INFRO의 Vertex 연결은 서비스 계정 키를 사용하며, 워크로드 ID 제휴는 사용하지 않습니다.
  • 명시적 컨텍스트 캐시(caches.create와 cached_content), 그라운딩, 또는 채팅 형식이 전달하지 못하는 기타 Gemini 네이티브 기능을 사용합니다.
  • 비용 할당을 위해 labels가 Cloud Billing에 도달해야 합니다. INFRO는 배분 정보를 자체 metadata에 기록합니다.
  • 데이터 상주를 위해 리전 또는 멀티 리전 엔드포인트가 필요합니다. INFRO는 글로벌 위치를 호출하며, 데이터 상주는 로드맵에 있습니다.

수정 사항을 한 행에 하나씩 정리했습니다. 여기에 없는 것은 그대로 유지됩니다.

 Google Vertex AIINFRO
베이스 URLaiplatform.googleapis.com/v1/projects/{project}/locations/{location}/...https://api.infro.io/v1(OpenAI 형식), Anthropic SDK는 https://api.infro.io.
자격 증명Application Default Credentials에서 받은 1시간짜리 액세스 토큰.INFRO 게이트웨이 키. INFRO는 서비스 계정 키를 봉인해 보관하고 단기 토큰을 직접 서명합니다.
모델 IDgemini-3.8-flash, google/gemini-3.8-flash, claude-sonnet-5-5.google/gemini-3.8-flash, anthropic/claude-sonnet-5.5. Anthropic SDK는 /v1/messages에서 claude-sonnet-5-5를 그대로 쓸 수 있습니다.
필드labels, 파트너 모델은 X-Vertex-AI-Labels.metadata { user_id, session_id, tags }, INFRO가 기록하고 Google로 보내지 않습니다.

이전 · 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" } },
});

이후 · 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는 OpenAI 형식으로 옮겨 갑니다

Gen AI SDK를 쓰는 코드는 요청 형식이 Chat Completions로 바뀝니다. 명시적 컨텍스트 캐시처럼 그 형식이 전달하지 못하는 기능은 해당 호출을 직접 호출로 유지할 이유가 됩니다.

Claude는 Anthropic 형식을 유지합니다

Vertex 연결에서 /v1/messages는 thinking 블록, cache_control, 도구를 포함해 본문을 작성된 그대로 보냅니다. 라우트는 같은 Claude 모델에 대해 Vertex를 첫 번째로, Anthropic을 두 번째로 둘 수 있습니다.

서비스 계정 하나

roles/aiplatform.user만 부여하세요. INFRO는 호출마다 이것으로 1시간짜리 토큰을 서명하며, 프로젝트에서 다른 것은 읽지 않습니다.

Google Vertex AI의 공개 문서(2026년 10월 19일에 읽음)를 바탕으로 Google Vertex AI의 객체를 INFRO의 객체와 대조하고, 게이트웨이가 구현한 내용과 비교해 확인했습니다. INFRO에 없다고 표시된 행이 1개입니다.

Google Vertex AI그곳에서 하는 일INFRO에서
프로젝트와 자격 증명다름고객의 Google Cloud 프로젝트. ADC 또는 서비스 계정 토큰.서비스 계정 키를 봉인해 보관하는 Vertex 연결. 토큰은 호출마다 서명합니다. 워크로드 ID 제휴는 없습니다.
Gemini `generateContent`다름Gen AI SDK를 통한 네이티브 Gemini API.chat completions에서 OpenAI 형식으로 제공됩니다. 네이티브 전용 기능은 전달되지 않습니다.
Claude `rawPredict`같은 구조Vertex의 Anthropic Messages 본문./v1/messages, 작성된 그대로 Vertex로 전송.
글로벌 및 리전 엔드포인트다름글로벌, 리전, 멀티 리전 중 선택.글로벌 위치만.
라벨다름Cloud Billing으로 전달되는 비용 라벨.INFRO 요청 로그와 사용량의 metadata 배분, 프로젝트·키·사용자·태그별.
컨텍스트 캐싱해당 없음cached_content로 생성하고 참조하는 명시적 캐시.동등한 기능은 없습니다. Claude의 cache_control은 작성된 그대로 Vertex에 도달하며, INFRO는 정확 일치 응답 캐시를 더합니다.
할당량과 Provisioned Throughput다름Dynamic Shared Quota, Standard PayGo 등급, Provisioned Throughput.Google 쪽은 변경 없음. 429는 라우트의 실패 규칙을 따릅니다. INFRO는 달러 예산을 더합니다.
페일오버다름글로벌 엔드포인트가 리전을 고릅니다. 공급자 간 처리는 고객의 코드 몫입니다.유형별 실패 규칙을 갖춘 Vertex, Anthropic, Google AI 등 간 라우트.

체험이나 벤치마크가 아니라 Google Vertex AI의 공개 문서를 저희가 읽은 결과입니다. 잘못 읽은 부분이 있으면 알려 주세요. 해당 행을 수정하겠습니다.

INFRO가 하지 않는 것

  • 워크로드 ID 제휴나 ADC 사용. 서비스 계정 키가 필요합니다.
  • 지역 또는 멀티 리전 Vertex 엔드포인트 호출.
  • 명시적 컨텍스트 캐시나 그라운딩 같은 Gemini 네이티브 기능 전달.
  • 청구 라벨 전달 또는 Google Cloud 청구와 대사.

이어지지 않는 것

  • Cloud Logging 및 Monitoring 기록. Google Cloud에 남습니다.
  • 컨텍스트 캐시. 프로젝트에 남습니다.

질문

INFRO가 Vertex AI의 Claude를 라우팅할 수 있나요?
네. 서비스 계정 키로 Vertex AI를 연결하고, Model Garden에서 Claude 모델을 활성화한 뒤 /v1/messages나 chat completions를 호출하세요.
사용료는 누가 청구하나요?
Google Cloud가 고객의 프로젝트로 청구합니다. INFRO는 구독이며 모델 지출에 0%를 더합니다.
INFRO에는 어떤 권한이 필요한가요?
roles/aiplatform.user를 가진 서비스 계정. INFRO는 이를 Vertex AI 호출에만 사용합니다.

저희와 함께, 또는 직접 옮기세요

마이그레이션 프로그램에서는 통화로 Google Vertex AI 설정을 INFRO 연결, 라우트, 예산에 매핑하고 첫 서비스를 함께 옮깁니다. 공급자는 계속 고객에게 직접 청구하며, INFRO는 구독이고 모델 지출에 0%를 더합니다.

14일 체험 시작 마이그레이션 세션 예약빠른 시작 읽기

출처

이 페이지에서 Google Vertex AI에 관한 모든 서술은 2026년 10월 19일에 읽은 다음 자료 중 하나에서 나왔습니다. 체험, 벤치마크, 대화에서 추론한 것은 없습니다.