Adobe Firefly · Veo 3.1 视频生成对接说明

针对 Veo 3.1 的异步视频任务说明，重点覆盖时长、画幅和分辨率字段。

API Base URLhttps://api2.cgapi.top/v1查看模型广场

适用场景

适合需要明确控制成片时长、横竖画幅和 720p 或 1080p 输出的文生视频工作流。模型 ID 请复制下方精确值。

本页中的 size 是画幅比例，不是像素尺寸；像素清晰度由 video_resolution 控制。

模型与参数

模型 ID	`firefly-veo-3.1` `firefly-veo-3.1-fast`
Endpoint	`POST /v1/videos`
时长	`seconds` 使用字符串 `"4"`、`"6"` 或 `"8"`；兼容字段为 `video_seconds`，值为 `"4s"`、`"6s"` 或 `"8s"`。
画幅	`size` 传 `16:9` 或 `9:16`。
分辨率	`video_resolution` 传 `720p` 或 `1080p`。
输出尺寸	720p 横版 1280x720，720p 竖版 720x1280；1080p 横版 1920x1080，1080p 竖版 1080x1920。

提交任务

curl --request POST "https://api2.cgapi.top/v1/videos" \
  --header "Authorization: Bearer <CGAPI_API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{"model":"firefly-veo-3.1","prompt":"雪山峡谷中的航拍镜头，云层缓慢流动，真实自然光。","seconds":"8","size":"16:9","video_resolution":"1080p"}'

如果业务封装使用兼容字段，可将时长写成 video_seconds，但同一请求不要同时传两套时长字段。

轮询与下载

读取创建响应中的 id 或 task_id。
请求 GET /v1/videos/{task_id} 直到状态为 completed 或失败。
完成后读取响应顶层的 video_url，再下载视频文件并校验 video/mp4。

下载 URL 可能有时效。拿到 video_url 后应立即下载，并把任务 ID 与本地文件关联保存。

成功信号

创建接口返回任务 ID。
轮询状态为 completed。
完成响应包含顶层 video_url，下载内容为可播放 MP4。
输出像素尺寸与 size、video_resolution 的组合一致。

常见问题

400：检查时长是否为字符串枚举、size 是否为比例、分辨率是否为 720p 或 1080p。
找不到视频地址：确认任务状态为 completed，再读取顶层 video_url。
横竖尺寸不一致：不要把像素尺寸写进 size，应使用 16:9 或 9:16。
价格与分组：以模型广场和控制台消费记录为准。