One continuous eight-second shot inside a quiet botanical glasshouse during a sudden rain shower. The camera glides slowly at leaf height past broad wet leaves while droplets strike the glass roof, merge into rivulets, and cast moving reflections across the stone path. Keep the plant geometry stable, water motion physically believable, and the depth transition smooth from foreground leaves to the distant iron doorway. Natural overcast light only. No cuts, no people, no readable text, no logos, no brands, no products, no advertising, no watermark.
Veo 3.1 文生视频 API
google/veo3.1/text-to-video根据文本提示词生成 8 秒视频。可描述主体、动作、环境、镜头移动、光线和构图,并选择 720p、1080p 或 4K 输出。
输入
8s由当前端点固定输出
等待运行生成视频将在此显示
设置输入并运行任务,生成进度和完成后的视频会保留在此面板。
示例
快速开始
完成鉴权,按当前模型契约提交任务,再用返回的任务 ID 轮询结果。完整字段说明保留在 API 文档中。
配置鉴权
把 Vidgo API Key 作为 Bearer Token 发送。密钥应保存在服务端,不要暴露到浏览器代码中。
- 端点
- POST https://api.vidgo.ai/api/generate/submit
- 鉴权
- Authorization: Bearer VIDGO_API_KEY
提交生成任务
使用准确模型 ID veo3.1/text-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/text-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"
}
}'{
"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 文生视频
Veo 3.1 文生视频把文字场景生成一段 8 秒视频。无需准备源图片,适合可以完全通过提示词定义的镜头。这是 Vidgo 当前公开的标准 Veo 3.1 工作流。
为什么选择这个工作流?
从文字镜头开始无需准备源素材,直接在提示词中描述画面内容、动作和镜头计划。
使用明确的端点契约模型 ID 把页面锁定为“仅文本提示词”,表单与 JSON 请求始终对应同一工作流。
按交付场景选择清晰度可选择 720p、1080p 或 4K 输出,以及横版或竖版画面。
提交前确认成本Playground 会在发送任务前显示当前分辨率所需积分。
参数
| 参数 | 要求 | 说明 |
|---|---|---|
| prompt | 必填 | 字符串。描述可见内容、动作、镜头方向、光线和构图;最长 10,000 个字符。 |
| duration | 可选 | 整数。默认为 8;当前端点不接受其他时长。 默认值 8 |
| resolution | 可选 | 字符串。选择输出分辨率;默认为 720p。 默认值 720p1080p4k |
| aspect_ratio | 可选 | 字符串。选择横版或竖版画面。 16:99:16 |
如何使用
编写场景明确主体、环境、可见动作,以及一个连续镜头内的变化过程。
指导运动分别描述主体动作和镜头运动,让每条指令承担清晰的作用。
设置输出时长保持固定 8 秒,然后选择分辨率和画面比例。
运行并跟踪任务提交请求后保存 task_id,轮询状态,直到任务 finished 或 failed。
价格
按每个生成视频计费,积分取决于所选分辨率。
| 规格 | 积分 | 说明 |
|---|---|---|
| 720p | 200 积分 | 每个成功的 8 秒视频请求。 |
| 1080p | 200 积分 | 每个成功的 8 秒视频请求。 |
| 4k | 400 积分 | 每个成功的 8 秒视频请求。 |
适用场景
概念镜头把文字视觉方向快速转成短视频概念,用于创意评审。
营销素材变体基于同一创意分别生成横版和竖版镜头方案。
动态预演在正式制作前验证场面调度和镜头运动。
实用建议
- 围绕一个连贯镜头编写提示词,避免在 8 秒内堆叠多个无关场景。
- 把主体动作、镜头运动和视觉风格拆成清晰的短句。
- 优先描述最终视频中可以直接看到的内容。
注意事项
- 生成采用异步任务;请保存 task_id,并在状态为 finished 或 failed 时停止轮询。
- 本页公开模型 ID 为 veo3.1/text-to-video。
常见问题
Veo 3.1 文生视频 使用哪个模型 ID?
使用 veo3.1/text-to-video。Playground 会锁定该值,避免请求误切换到其他 Veo 工作流。
支持哪些时长?
Vidgo 当前端点接受固定整数时长 8 秒。
支持哪些分辨率和画面比例?
分辨率可选 720p、1080p 或 4k;画面比例可选 16:9 或 9:16。
需要提交图片吗?
不需要。该文生视频端点不接受 image_urls。
如何获取生成完成的视频?
提交调用会返回 task_id。轮询状态端点,在状态变为 finished 时读取结果;failed 时停止轮询。

