Go 后端升级 Google GenAI SDK 1.78.0 如何保留测试接口?

作者:墨池

时间:2026-11-18

浏览:237

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

文章目录

在 Go 服务中使用 Google GenAI SDK 1.78.0 时,若现有功能需要 v1beta,应显式配置 HTTPOptions.APIVersion,或在未写代码版本时设置 GOOGLE_GENAI_API_VERSION。此次升级把 Gemini Developer API 的默认值切换到 v1,Vertex AI 默认值保持不变;前端调用的 Go 后端也需要按实际后端配置判断影响。

Google GenAI Go SDK 1.78.0 正式发布页面

前端项目关联的 Go 服务会受什么影响?

影响来源是 Go 客户端选用的服务端 API 版本,而不是浏览器代码自动改变。默认使用 genai.BackendGeminiAPI 且没有固定版本的 Go 服务,升级到 1.78.0 后会从 v1beta 转向 v1。官方将此列为运行时破坏性变化,但没有因这次调整改变 Go 类型和函数签名,所以保留 v1.x 的模块路径。

需要重点区分“稳定接口”与“模型别名”。官方说明 gemini-flash-latest、gemini-flash-lite-latest、gemini-pro-latest、部分 -preview 模型及依赖 v1beta 特性的 TTS 模型不能直接使用 v1。Live、上下文缓存和 Agents、Decisions、Webhooks 等服务,在 Gemini Developer API 中仍只由 v1beta 提供。

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

先让依赖版本可核对

以下命令在已有 Go 模块的项目目录执行,安装目标为 SDK 1.78.0。第二条命令用于确认最终选用版本,预期包含 google.golang.org/genai v1.78.0。模块版本和 HTTP API 版本分开管理,安装这个模块并不表示必须使用 v1。

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

通过运行环境延续测试接口

对没有在代码里写 APIVersion 的客户端,在启动 Go 进程的同一终端执行以下配置。预期新建客户端使用 v1beta;命令只设置环境,不产生模型响应。服务或容器运行时,应确保变量传到真实业务进程,不能只留在开发终端。

# 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 的解析会考虑后端:开发者接口取 v1beta,Vertex AI 取 v1beta1。显式设置 v1beta 则是指定具体字符串,不能拿它代替所有后端的测试版默认值。

通过代码确定客户端版本

若希望配置跟随服务代码发布,可以采用下面的完整 Go 初始化程序。先用 GOOGLE_API_KEY 或 GEMINI_API_KEY 在环境中提供有效密钥,随后使用自己的常规 Go 构建运行流程。HTTPOptions.APIVersion 的非空值优先于环境变量;示例只初始化客户端,成功时无输出,不包含生成内容或 Live 会话请求。

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.
}

版本恢复后还需理解哪些限制?

设置 v1beta 只是恢复接口选择,不代表已经验证某个账户、模型或业务请求可用。若继续留在 v1,应改用实际支持该接口的稳定模型;即使模型可用,也不能据此推断上下文缓存、Live 等服务已支持 v1。

使用 genai.BackendVertexAI,或通过 GOOGLE_GENAI_USE_VERTEXAI=true 选择 Vertex AI 的客户端不受这次默认调整影响,仍使用 v1beta1。Go SDK 1.78.0 的正式发布,不表示 JavaScript SDK 采用同一个发行版本或相同的发布进度。排查时把服务后端、代码版本字段和进程变量放在一起核对,才能判断本次变更是否触及现有功能。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›