js-genai：构建 Gemini 助力应用的核心工具

js-genai：构建 Gemini 助力应用的核心工具

js-genai TypeScript/JavaScript SDK for Gemini and Vertex. [EXPERIMENTAL] 项目地址: https://gitcode.com/gh_mirrors/js/js-genai

项目介绍

js-genai 是 Google 提供的一个 JavaScript SDK，专为 TypeScript 和 JavaScript 开发者设计，帮助他们构建利用 Gemini 强大功能的各类应用。此 SDK 支持 Gemini 开发者 API 以及 Google Cloud 的 Vertex AI 生成式 AI 服务。通过 js-genai，开发者可以轻松地将 Gemini 2.0 特性集成到他们的项目中。

项目技术分析

js-genai SDK 提供了丰富的 API 方法，通过这些方法可以轻松实现与 Gemini API 的交互。以下是一些主要模块和功能：

• ai.models：用于查询模型（如 generateContent、generateImages 等），或检查它们的元数据。
• ai.caches：创建和管理缓存，以减少在重复使用相同的大型提示前缀时的成本。
• ai.chats：创建具有本地状态的管理聊天对象，以简化多轮交互。
• ai.files：上传文件到 API 并在提示中引用，减少带宽使用，并处理无法直接嵌入提示的大型文件。
• ai.live：启动实时会话，支持文本、音频和视频输入，以及文本或音频输出。

此外，js-genai 还支持流式 API 交互，使得 API 响应更加快速和灵敏。开发者还可以通过提供 functionDeclaration 对象来让 Gemini 与外部系统交互。

项目及技术应用场景

js-genai 可以广泛应用于多种场景中，以下是一些典型的使用案例：

1. 智能客服系统：使用 js-genai 构建一个基于 Gemini 的智能客服系统，能够提供自然语言理解和生成能力，提升客户服务体验。
2. 内容生成平台：开发一个能够自动生成文章、报告或其他文本内容的平台，为用户提供高效的内容生成解决方案。
3. 教育应用：构建一个辅助学习的应用，通过 Gemini 的能力，为学生提供定制化的学习内容和指导。
4. 个性化推荐系统：利用 Gemini 的理解能力，为用户推荐个性化的内容、商品或服务。

项目特点

易于集成

js-genai 提供了简单的安装和初始化流程，开发者只需通过 NPM 安装 SDK，然后使用 API 密钥即可开始构建应用。

丰富的功能

通过 js-genai，开发者可以访问 Gemini 的多种功能，包括内容生成、图像生成、文件管理、实时交互等。

安全性

js-genai 强调 API 密钥的安全性，建议开发者在生产环境中使用服务器端实现，避免在客户端代码中暴露 API 密钥。

预览版

目前 js-genai 处于预览阶段，开发者可以尝试使用并测试其功能，但请注意，预览版的产品或功能可能不完全成熟，不提供 SLA 或技术支持承诺。

import { GoogleGenAI } from '@google/genai';
const GEMINI_API_KEY = process.env.GEMINI_API_KEY;

const ai = new GoogleGenAI({ apiKey: GEMINI_API_KEY });

async function main() {
  const response = await ai.models.generateContent({
    model: 'gemini-2.0-flash-001',
    contents: 'Why is the sky blue?',
  });
  console.log(response.text);
}

main();

通过以上代码，开发者可以快速开始使用 js-genai，并探索其提供的丰富功能。无论你是构建一个简单的个人项目，还是一个复杂的企业级应用，js-genai 都是一个值得考虑的选择。

js-genai TypeScript/JavaScript SDK for Gemini and Vertex. [EXPERIMENTAL] 项目地址: https://gitcode.com/gh_mirrors/js/js-genai