@core-ai/google-vertex

中文文档
0.38.0发布于 2026/11/06MITTypeScriptESM + CJS构建来源已验证近 30 天下载 4319

Vertex 大赦国际 @core-ai/core-ai的谷歌供应商包

中文使用文档
文档目录6 节
  1. 安装
  2. 使用量
  3. 认证
  4. 模式和区域
  5. 图像生成
  6. 供应商的选择和能力

@ core-ai/ google- 顶点

npm

Vertex AI供应商软件包上的谷歌 @core-ai/core-ai它使用 @google/genai vertex AI模式中的客户端并共享聊天、嵌入、图像生成、结构化输出和推理行为 @core-ai/google-genai。 。 。 .

安装

npm install @core-ai/core-ai @core-ai/google-vertex zod

使用量

import { generate } from '@core-ai/core-ai';
import { createGoogleVertex } from '@core-ai/google-vertex';

const googleVertex = createGoogleVertex({
    projectId: process.env.GOOGLE_VERTEX_PROJECT,
    region: 'europe-west1',
});
const model = googleVertex.chatModel('gemini-2.5-flash');

const result = await generate({
    model,
    messages: [{ role: 'user', content: 'Hello!' }],
});

console.log(result.content);

认证

默认情况下,提供者使用 Google 应用程序默认证书( ADC)数字 :

const googleVertex = createGoogleVertex({
    projectId: process.env.GOOGLE_VERTEX_PROJECT,
    region: 'europe-west1',
});

用明确的服务账户认证, 解析其 JSON 密钥, 并将其传递为 credentials数字 :

const rawCredentials = process.env.GOOGLE_APPLICATION_CREDENTIALS_JSON;
const credentialsJson = rawCredentials?.trim().startsWith('{')
    ? rawCredentials
    : Buffer.from(rawCredentials ?? '', 'base64').toString('utf8');

const googleVertex = createGoogleVertex({
    projectId: process.env.GOOGLE_VERTEX_PROJECT,
    region: 'europe-west1',
    credentials: JSON.parse(credentialsJson),
});

您也可以输入预配置 GoogleGenAI 客户端 :

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

const googleVertex = createGoogleVertex({
    client: new GoogleGenAI({
        vertexai: true,
        project: 'my-project',
        location: 'europe-west1',
    }),
});

模式和区域

将 Vertex AI 型号ID 传到相应的型号工厂:

const chat = googleVertex.chatModel('gemini-2.5-flash');
const embeddings = googleVertex.embeddingModel('gemini-embedding-001');
const image = googleVertex.imageModel('gemini-2.5-flash-image');

模型提供情况因区域而异。 一个供应商实例针对一个区域,因此在不同地点托管模型时创建单独的供应商.

图像生成

import { generateImage } from '@core-ai/core-ai';

const result = await generateImage({
    model: googleVertex.imageModel('gemini-2.5-flash-image'),
    prompt: 'A watercolor robot in a mountain cabin at sunrise',
    size: '1024x1024',
});

console.log(result.images[0]?.base64);

双子座图像模型使用本土多模式生成并返回基础64图像 数据.

供应商的选择和能力

这个提供者分享其模式行为 @core-ai/google-genai选项 google。 。 。 . @core-ai/google-vertex 再导出适用的提供者-选项计划、能力助手和推理元数据类型.

版本与发布记录

@core-ai/google-vertex 共发布 30 个版本,首次发布于 2026/07/15;过去 12 个月发布了 30 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.38.0latest2026/11/064 天前
0.37.02026/11/055 天前
0.36.22026/10/2912 天前
0.36.12026/10/2813 天前
0.36.02026/10/2219 天前
0.35.02026/10/1427 天前

关于 @core-ai/google-vertex 的常见问题

@core-ai/google-vertex 是什么?

Vertex 大赦国际 @core-ai/core-ai的谷歌供应商包

如何安装 @core-ai/google-vertex?

在项目目录运行 npm install @core-ai/google-vertex,或使用 pnpm add / yarn add / bun add。

@core-ai/google-vertex 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@core-ai/google-vertex 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@core-ai/google-vertex 可以商用吗?

@core-ai/google-vertex 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@core-ai/google-vertex 的下载量有多少?

根据 npm 官方下载统计,@core-ai/google-vertex 在 2026/10/11 – 2026/11/09 这 30 天内被下载 4,319 次,日均约 144 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@core-ai/google-vertex 还在维护吗?

最新版本 0.38.0 发布于 2026/11/06(4 天前);至今共发布 30 个版本,其中过去 12 个月发布了 30 个;首次发布于 2026/07/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。