One continuous fixed-camera stop-motion-like transition from the resting origami fox to the standing fox. Paper folds release in a clear sequence: front legs extend, torso rises, hind legs straighten, head lifts, then the tail unfolds. Preserve the same rust-orange handmade paper, fox identity, backdrop, lighting and scale. No tearing, no extra paper, no text, no logos, no brands, no products, no advertising, no watermark.
Veo 3.1 Fast 图生视频 API
google/veo3.1-fast/image-to-video根据严格按顺序提交的两张图片生成 8 秒转场。第一张定义首帧,第二张定义尾帧。
输入
8s由当前端点固定输出
等待运行生成视频将在此显示
设置输入并运行任务,生成进度和完成后的视频会保留在此面板。
示例
快速开始
完成鉴权,按当前模型契约提交任务,再用返回的任务 ID 轮询结果。完整字段说明保留在 API 文档中。
配置鉴权
把 Vidgo API Key 作为 Bearer Token 发送。密钥应保存在服务端,不要暴露到浏览器代码中。
- 端点
- POST https://api.vidgo.ai/api/generate/submit
- 鉴权
- Authorization: Bearer VIDGO_API_KEY
提交生成任务
使用准确模型 ID veo3.1-fast/image-to-video。提交端点会返回异步任务 ID。
curl --request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "veo3.1-fast/image-to-video",
"input": {
"prompt": "A single continuous shot of a paper boat drifting through a rain-lit city canal at dusk.",
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"image_urls": [
"https://example.com/start-frame.jpg",
"https://example.com/end-frame.jpg"
]
}
}'{
"code": 200,
"data": {
"task_id": "task-unified-...",
"status": "not_started"
}
}轮询任务结果
使用 task_id 查询任务状态,直到任务变为 finished 或 failed。
GET https://api.vidgo.ai/api/generate/status/{task_id}not_started → running → finished | failed
Veo 3.1 Fast 图生视频
Veo 3.1 Fast 图生视频使用严格按顺序提交的两张图片和提示词,生成从指定首帧过渡到指定尾帧的 8 秒视频。Fast 版本以更低积分成本支持快速迭代。
为什么选择这个工作流?
控制镜头的起点和终点锁定开场与结束画面,由提示词指导两者之间的运动变化。
使用明确的端点契约模型 ID 把页面锁定为“严格按顺序提交 2 个图片 URL”,表单与 JSON 请求始终对应同一工作流。
按交付场景选择清晰度可选择 720p、1080p 或 4K 输出,以及横版或竖版画面。
提交前确认成本Playground 会在发送任务前显示当前分辨率所需积分。
参数
| 参数 | 要求 | 说明 |
|---|---|---|
| prompt | 必填 | 字符串。描述可见内容、动作、镜头方向、光线和构图;最长 10,000 个字符。 |
| image_urls | 必填 | 数组。严格包含 2 个公开 HTTP(S) 图片 URL,顺序为首帧、尾帧。 |
| duration | 可选 | 整数。默认为 8;当前端点不接受其他时长。 默认值 8 |
| resolution | 可选 | 字符串。选择输出分辨率;默认为 720p。 默认值 720p1080p4k |
| aspect_ratio | 可选 | 字符串。选择横版或竖版画面。 16:99:16 |
如何使用
准备两帧图片先上传首帧,再上传尾帧;顺序不同会改变生成的转场方向。
指导运动分别描述主体动作和镜头运动,让每条指令承担清晰的作用。
设置输出时长保持固定 8 秒,然后选择分辨率和画面比例。
运行并跟踪任务提交请求后保存 task_id,轮询状态,直到任务 finished 或 failed。
价格
按每个生成视频计费,积分取决于所选分辨率。
| 规格 | 积分 | 说明 |
|---|---|---|
| 720p | 36 积分 | 每个成功的 8 秒视频请求。 |
| 1080p | 36 积分 | 每个成功的 8 秒视频请求。 |
| 4k | 60 积分 | 每个成功的 8 秒视频请求。 |
适用场景
产品转场在两个已确认的产品构图之间生成具有明确起点和终点的运动。
前后状态演示把两个指定视觉状态连接成一个短镜头。
分镜插值使用相邻分镜探索计划画面之间的运动和节奏。
实用建议
- 围绕一个连贯镜头编写提示词,避免在 8 秒内堆叠多个无关场景。
- 把主体动作、镜头运动和视觉风格拆成清晰的短句。
- 提交前检查图片顺序:第一个 URL 是首帧,第二个 URL 是尾帧。
注意事项
- 生成采用异步任务;请保存 task_id,并在状态为 finished 或 failed 时停止轮询。
- 本页公开模型 ID 为 veo3.1-fast/image-to-video。
常见问题
Veo 3.1 Fast 图生视频 使用哪个模型 ID?
使用 veo3.1-fast/image-to-video。Playground 会锁定该值,避免请求误切换到其他 Veo 工作流。
支持哪些时长?
Vidgo 当前端点接受固定整数时长 8 秒。
支持哪些分辨率和画面比例?
分辨率可选 720p、1080p 或 4k;画面比例可选 16:9 或 9:16。
必须提交多少张图片?
必须提交两个公开 HTTP(S) 图片 URL,顺序为首帧在前、尾帧在后。
如何获取生成完成的视频?
提交调用会返回 task_id。轮询状态端点,在状态变为 finished 时读取结果;failed 时停止轮询。

