One continuous locked-off shot that moves naturally from the first frame to the second. The copper observatory dome shutters separate slowly and evenly, revealing the dark telescope aperture and a narrow warm interior glow as dawn brightens slightly. Preserve the stone building, dome geometry, mountain silhouette, frost, camera position and composition. Motion should be mechanical, restrained and physically believable. No new objects, no people, no text, no logos, no brands, no products, no advertising, no watermark.
Veo 3.1 Image-to-Video API
veo3.1/image-to-video根据严格按顺序提交的两张图片生成 8 秒转场。第一张定义首帧,第二张定义尾帧。
输入
238/10,000
拖拽文件、粘贴剪贴板素材,或输入 URL。
拖拽文件、粘贴剪贴板素材,或输入 URL。
由当前端点固定
输出
等待运行生成视频将在此显示
设置输入并运行任务,生成进度和完成后的视频会保留在此面板。
示例
REST API
快速开始
完成鉴权,按当前模型契约提交任务,再用返回的任务 ID 轮询结果。完整字段说明保留在 API 文档中。
01
配置鉴权
把 Vidgo API Key 作为 Bearer Token 发送。密钥应保存在服务端,不要暴露到浏览器代码中。
- 端点
- POST https://api.vidgo.ai/api/generate/submit
- 鉴权
- Authorization: Bearer VIDGO_API_KEY
02
提交生成任务
使用准确模型 ID veo3.1/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/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"
}
}03
轮询任务结果
使用 task_id 查询任务状态,直到任务变为 finished 或 failed。
GET https://api.vidgo.ai/api/generate/status/{task_id}not_started → running → finished | failed
相关模型
常见问题
Veo 3.1 图生视频 使用哪个模型 ID?
使用 veo3.1/image-to-video。Playground 会锁定该值,避免请求误切换到其他 Veo 工作流。
支持哪些时长?
Vidgo 当前端点接受固定整数时长 8 秒。
支持哪些分辨率和画面比例?
分辨率可选 720p、1080p 或 4k;画面比例可选 16:9 或 9:16。
必须提交多少张图片?
必须提交两个公开 HTTP(S) 图片 URL,顺序为首帧在前、尾帧在后。
如何获取生成完成的视频?
提交调用会返回 task_id。轮询状态端点,在状态变为 finished 时读取结果;failed 时停止轮询。















