功能与选择

Veo 根据文字或一张起始图片生成带音频的视频。标准版与 Fast 共用接口，只需切换完整模型 ID。Responses 格式适合已经使用 Responses 消息结构的应用；希望直接管理视频任务、上传图片文件时，可以使用统一视频格式。

这两种格式都是本站提供的兼容接口，视频由 Google Veo 生成。Responses 与 Google 原生格式不同，本入口也不提供通用文本模型的工具调用或会话管理。

第一步：鉴权

每次请求携带青云 API Key，不需要单独调用登录接口。

Authorization: Bearer YOUR_API_KEY

将 YOUR_API_KEY 替换为完整 Key，保留 Bearer 后的一个空格。JSON 创建请求同时发送 Content-Type: application/json。示例在你的服务端运行，不要把 Key 放进网页前端。

第二步：调用模型生成

操作方法与本站地址说明
创建POST https://top.qingyuntop.ai/v1/responsesJSON 请求；文字用 input，图片用 input_image
查询GET https://top.qingyuntop.ai/v1/responses/{response_id}使用创建返回的 resp_… ID
下载GET https://top.qingyuntop.ai/v1/videos/{task_id}/content完成后使用 metadata.task_id；返回视频字节

建议首次接入使用 background: true、stream: false：提交一次，保存顶层 id，约每 10 秒查询一次，completed 后下载。三种模式只改变等待和返回方式，生成能力相同。

模式backgroundstream返回方式
后台（推荐）truefalse尽快返回 response 对象，随后主动查询
同步false 或省略false 或省略保持连接等待结果；服务端等待超时可能返回 queued，继续查询
流式false 或省略trueSSE 进度与结果事件，不是实时视频流
后台加流式truetrue同样保持 SSE 连接，不会立即返回普通 JSON

模型与能力边界

模型 ID说明
veo-3.1-generate-previewVeo 3.1 标准版，本文示例
veo-3.1-fast-generate-previewVeo 3.1 Fast，相同调用结构
veo-3.0-generate-001Veo 3 标准版
veo-3.0-fast-generate-001Veo 3 Fast

可调用模型以你的 Key 在 GET https://top.qingyuntop.ai/v1/models 中的权限及模型价格为准。调用前请确认 API Key 的模型权限。下列组合以 Veo 3.1 为准，不直接套用到 3.0。

能力本站调用方式与限制
时长seconds 为 4、6 或 8；建议显式填写 8
分辨率metadata.resolution 为 720p、1080p 或 4k；1080p、4k 使用 8 秒
比例metadata.aspectRatio 为 16:9 或 9:16
音频、帧率Veo 3.1 生成原生音频，官方为 24 fps；本接口没有音频开关或帧率参数
起始图片一张 PNG/JPEG 的 data URL；只使用第一张图片
输出数量固定为一个视频
多参考图、首尾帧、视频延长本入口不支持，请勿添加对应的 Google 原生字段

Google 原生 REST 使用 predictLongRunning 和 instances / parameters，与本页的请求结构不同。本站本目录只提供统一视频和 Responses 两种方式；请按本页填写地址和鉴权，勿直接替换 Google 示例域名。

按功能阅读

Responses 文生视频

功能、鉴权、参数和语言示例

Responses 图生视频

起始图片编码与输入结构

同步、流式与后台模式

模式选择、SSE 事件与断线处理

查询结果与下载视频

ID、响应结构、自动等待和保存 MP4

Responses 错误与限制

参数错误、任务失败与下载问题

官方参考