curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "vidu/q4/image-to-video",
"input": {
"image_urls": [
"https://example.com/still.png"
],
"prompt": "The lantern flickers as the girl looks up and snow starts to fall, slow push-in",
"duration": 5,
"resolution": "720p"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1762160000-abc123",
"status": "not_started",
"created_time": "2026-11-03T10:30:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Vidu
Vidu Q4 图生视频
Vidu Q4 图生视频 API 将一张起始图片生成 3–16 秒的视频，分辨率可选 540p、720p、1080p、2K 或 4K，并保持图片的宽高比。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "vidu/q4/image-to-video",
"input": {
"image_urls": [
"https://example.com/still.png"
],
"prompt": "The lantern flickers as the girl looks up and snow starts to fall, slow push-in",
"duration": 5,
"resolution": "720p"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1762160000-abc123",
"status": "not_started",
"created_time": "2026-11-03T10:30:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
- vidu/q4/image-to-video — Vidu Q4 图生视频，使用一张起始帧，3–16 秒，540p 到 4K。
功能
- 以一张起始帧图生视频。
- 可选提示词，用于指导运动和镜头运动。
- 时长为 3 到 16 秒的整数。
- 五种分辨率：
540p、720p、1080p、2k和4k。 - 宽高比跟随输入图片。
必填参数
image_urls（string[]）：恰好一个公开 HTTP(S) 图片 URL，用作首帧。
可选参数
prompt（string）：哪些元素运动、镜头如何运动以及氛围。最多 5,000 个字符。默认为空。duration（integer）：输出时长，3–16秒。默认5。resolution（string）：540p、720p、1080p、2k或4k（不区分大小写）。默认720p。enable_safety_checker（boolean）：开启或关闭上游安全检查。
分辨率
resolution | 适用场景 |
|---|---|
540p | 快速、低成本的草稿 |
720p | 默认；社交平台和网页短片 |
1080p | 全高清交付 |
2k | 高分辨率母版 |
4k | 主视觉镜头和大屏 |
输出
任务完成后，查询任务状态和回调内容的files 数组中会返回一个 MP4 视频。
示例
- 5 秒 720p 动画：一张插画加简短的运动提示词，其余使用默认设置。
- 10 秒 4K 主视觉镜头，带回调：将主视觉以
4k生成，用于大屏展示，并提供callback_url。
注意事项
- 本 ID 的图生视频不生成音频，也不接受
aspect_ratio、generate_audio、reference_image_urls或reference_audio_urls，传入会返回 400。需要多图参考、音色参考或原生音频时，请用 Vidu Q4 参考生视频。 - Vidu Q4 没有文生视频模式，每个请求都需要图片。
model和callback_url放在请求根级，不要放进input。- 积分在提交时预扣，按
resolution和duration（每输出秒）计算。参考图、参考音频和generate_audio不影响费率。任务失败会全额退还。当前费率见定价页。
授权
所有 API 接口都需要 Bearer Token 认证
获取 API Key：
进入 仪表盘 → API 密钥（API Key 管理页面）获取你的 API Key
在请求头中添加：
Authorization: Bearer VIDGO_API_KEY
请求体
application/json