One continuous eight-second shot on textured ivory paper. A single black ink drawing of a crane gathers itself, lifts its wings, and rises from the paper as a dimensional ink-wash bird while two loose brush marks trail behind. The camera stays nearly overhead with one gentle push in. Keep the crane silhouette coherent and the ink diffusion restrained. No cuts, no written characters, no readable text, no logos, no brands, no products, no advertising, no watermark.
Veo 3.1 Fast Text-to-Video API
veo3.1-fast/text-to-video根据文本提示词生成 8 秒视频。可描述主体、动作、环境、镜头移动、光线和构图,并选择 720p、1080p 或 4K 输出。
输入
238/10,000
由当前端点固定
输出
等待运行生成视频将在此显示
设置输入并运行任务,生成进度和完成后的视频会保留在此面板。
示例
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-fast/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-fast/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"
}
}03
轮询任务结果
使用 task_id 查询任务状态,直到任务变为 finished 或 failed。
GET https://api.vidgo.ai/api/generate/status/{task_id}not_started → running → finished | failed
相关模型
常见问题
Veo 3.1 Fast 文生视频 使用哪个模型 ID?
使用 veo3.1-fast/text-to-video。Playground 会锁定该值,避免请求误切换到其他 Veo 工作流。
支持哪些时长?
Vidgo 当前端点接受固定整数时长 8 秒。
支持哪些分辨率和画面比例?
分辨率可选 720p、1080p 或 4k;画面比例可选 16:9 或 9:16。
需要提交图片吗?
不需要。该文生视频端点不接受 image_urls。
如何获取生成完成的视频?
提交调用会返回 task_id。轮询状态端点,在状态变为 finished 时读取结果;failed 时停止轮询。















