Veo 模型接入

概览

OneLinkAI 提供 Gemini 官方兼容接口，用于在 OneLinkAI 网关下调用 Google Gemini 的视频生成能力。整体目标是尽可能兼容 Gemini 官方协议，方便已经接入 Gemini 官方接口的业务快速迁移或并行接入。

本文重点说明 Veo：Gemini 视频生成能力，适用于文生视频、图生视频、首尾帧控制、多参考图引导与视频延长。

接入规则

鉴权方式

调用 OneLinkAI 的 Gemini 兼容接口时，统一使用 Bearer Token 鉴权：

路径规则

在 OneLinkAI 中，Gemini 兼容接口沿用 Gemini 官方接口路径结构，视频生成（异步任务）主要使用以下两类路径：

创建任务：

官方路径：POST https://generativelanguage.googleapis.com/v1beta/models/{model}:predictLongRunning

OneLinkAI 路径：POST /v1beta/models/{model}:predictLongRunning

查询任务：

官方路径：GET https://generativelanguage.googleapis.com/v1beta/operations/{operation_name}

OneLinkAI 路径：GET /v1beta/operations/{operation_name}

也就是说，如果你已经接入过 Gemini 官方接口，通常只需要：

将请求地址替换为 OneLinkAI 对应网关地址。

将官方 x-goog-api-key 鉴权替换为 OneLinkAI 的 Authorization: Bearer <ApiKey>。

按照当前支持范围继续使用原有请求体结构与响应体结构进行联调。

通用调用方式

Veo 使用异步任务模式。

创建成功后，接口会先返回一个 operation name（任务 ID）。

业务侧需通过 GET /v1beta/operations/{operation_name} 轮询任务状态，直到任务完成。

请求体字段与响应体结构按 Gemini 官方文档整理，OneLinkAI 保留统一鉴权与网关路径。

能力清单

以下内容用于快速说明 OneLinkAI 对 Gemini 官方 Veo 能力的当前支持范围：

能力名称	是否支持	参考文档
文生视频	✔️	https://ai.google.dev/gemini-api/docs/video?hl=zh-cn&example=dialogue
图生视频	✔️	https://ai.google.dev/gemini-api/docs/video?hl=zh-cn&example=dialogue
首尾帧控制	✔️	https://ai.google.dev/gemini-api/docs/video?hl=zh-cn&example=dialogue
多参考图引导	✔️	https://ai.google.dev/gemini-api/docs/video?hl=zh-cn&example=dialogue
视频延长	✔️	https://ai.google.dev/gemini-api/docs/video?hl=zh-cn&example=dialogue
查询视频生成任务	✔️	https://ai.google.dev/gemini-api/docs/video?hl=zh-cn&example=dialogue

接口详情

以下请求示例统一以 https://api.onelinkai.cloud 作为示例网关地址，实际调用时请替换为你的真实接入地址和有效的 ApiKey。

1. 创建视频生成任务

兼容 Google Gemini 官方视频生成协议的创建任务接口

常用模型示例：veo-3.1-generate-preview

核心请求字段：路径参数 model，请求体中的 instances、instances[].prompt、instances[].image 或 instances[].video、parameters.aspectRatio、parameters.resolution、parameters.numberOfVideos

文生视频、图生视频、首尾帧控制、多参考图引导、视频延长等场景，均按 Gemini 官方 instances 与 parameters 结构传参

核心响应字段：name (即 operation_name)、done

查询视频生成任务

兼容 Google Gemini 官方异步任务查询协议的任务查询接口

官方请求路径：GET https://generativelanguage.googleapis.com/v1beta/operations/{operation_name}

OneLinkAI 路径：GET /v1beta/operations/{operation_name}

核心响应字段：name、done、response.generateVideoResponse.generatedSamples[].video.uri、error

当 done=true 且无错误时，通常可从 response.generateVideoResponse.generatedSamples[].video.uri 获取结果视频地址

使用建议

如果你已经接入过 Gemini 官方接口，推荐优先复用原有请求体结构与业务侧调用逻辑。

Veo 为异步接口，建议业务侧按 5 到 10 秒间隔轮询任务状态，直到 done=true。

Veo 返回的视频结果链接通常适合及时下载或转存，避免业务侧长期依赖临时下载地址。

具体模型可用性、字段约束、分辨率支持、错误码与边界行为，请以对应官方接口文档为准。

概览#

接入规则#

鉴权方式#

路径规则#

通用调用方式#

能力清单#

接口详情#

1. 创建视频生成任务#

查询视频生成任务#

使用建议#

概览