Google GenAI Go SDK 1.78.0 升级后怎样配置 v1beta?

Noah
Noah
发布时间:2026-11-18| 6人浏览过
原创

Google GenAI Go SDK 1.78.0 将 Gemini Developer API 默认改为 v1,可用 HTTPOptions.APIVersion 或环境变量保留 v1beta,Vertex AI 默认值不变。

Google GenAI Go SDK 1.78.0 的开发者接口默认改用 v1。需要保留 v1beta 的项目,可以用环境变量设置版本,也可以在 Go 客户端里明确指定;后者的优先级更高。对 Python 开发者维护的混合语言服务而言,这里讨论的是 Go 工具包版本,不能直接当作 Python 包的升级结论。

Google GenAI Go SDK 1.78.0 正式发布页面

为何依赖能编译,运行行为却可能变化?

这次正式版本将 Gemini Developer API 的隐式版本从 v1beta 调整到 v1,针对的是 genai.BackendGeminiAPI。官方称它为运行时破坏性变化,同时说明没有因此更改 Go 类型及函数签名,仍沿用 google.golang.org/genai 模块路径。构建正常不代表原来依赖测试接口的业务一定正常。

官方特别提醒三个 latest 别名:gemini-flash-latest、gemini-flash-lite-latest、gemini-pro-latest,以及部分 -preview 模型和依赖测试特性的 TTS 模型,不能默认按 v1 使用。开发者接口上的 client.Live、client.Caches、client.Agents、client.Decisions、client.Webhooks 也仍属于 v1beta 范围。

1.78.0 官方默认版本变更、受影响功能与配置示例

在 Go 项目中确定依赖版本

进入已有 Go 模块目录后执行下面的版本固定与查询命令。查询结果应显示 google.golang.org/genai v1.78.0;若项目仍选择了其他版本,应先处理依赖约束。这里固定的是 SDK,并非将服务端 API 固定到 v1。

go get google.golang.org/genai@v1.78.0
go list -m google.golang.org/genai

不改初始化代码时怎样设置?

客户端没有显式填写 APIVersion 时,可在启动程序的终端设置下列环境变量。设置后应使该进程新建的 Gemini Developer API 客户端选择 v1beta。命令不发送 API 请求,因此不能凭终端没有报错就认定模型调用成功;服务部署还需让相同变量进入实际进程。

# Gemini Developer API: run in the shell that starts your Go process
export GOOGLE_GENAI_API_VERSION=v1beta
# Alternative: beta resolves to v1beta for Gemini Developer API, v1beta1 for Vertex AI
# export GOOGLE_GENAI_API_VERSION=beta

也可以使用 beta 取值,让 SDK 按后端解析:Gemini Developer API 对应 v1beta,Vertex AI 对应 v1beta1。这与把同一个显式版本字符串硬套到所有后端不同。

需要明确配置优先级时怎样写?

下面的完整 Go 初始化示例将后端设为 Gemini Developer API,并通过 HTTPOptions.APIVersion 指定 v1beta。先在运行环境配置有效的 GOOGLE_API_KEY 或 GEMINI_API_KEY,密钥不要写入源码。初始化配置有效时程序无输出,也没有发起模型请求;它展示的是版本选择方法,没有声称完成业务实测。

package main

import (
    "context"
    "log"

    "google.golang.org/genai"
)

func main() {
    // Set GOOGLE_API_KEY or GEMINI_API_KEY in the process environment first.
    client, err := genai.NewClient(context.Background(), &genai.ClientConfig{
        Backend: genai.BackendGeminiAPI,
        HTTPOptions: genai.HTTPOptions{APIVersion: "v1beta"},
    })
    if err != nil {
        log.Fatal(err)
    }
    _ = client // Use this client for subsequent API calls.
}

即使环境中设置了其他版本,代码里的非空 APIVersion 仍优先。这也是环境变量改了却看不到预期效果时,应首先检查的配置位置。

哪些项目无需恢复这个旧默认?

Vertex AI 后端的默认值没有随本次发布改变,genai.BackendVertexAI 或 GOOGLE_GENAI_USE_VERTEXAI=true 对应的客户端继续默认 v1beta1。已经在代码中明确指定版本的项目,也应围绕自身配置评估,而非只看依赖版本号。

若业务希望使用 v1,应选用该接口支持的具体稳定模型,并逐项确认所需服务;换模型不能替代 Live 或缓存服务的 API 版本要求。1.78.0 已有正式 Release,模块代理也能查询到对应版本,这里的配置结论针对该标签源码,不能扩展为所有语言包、所有服务或后续开发分支均已同步上线。

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。