Vidu · 模型接口

Vidu Q4 API 价格与接入

Vidu Q4 API 的模型能力、计价规格、请求参数和接入示例。使用 VezAPI 账号密钥统一接入。

图生视频

Vidu Q4 API 接入文档

使用 VezAPI 密钥接入 Vidu Q4。下列操作共用同一个账号余额和鉴权方式。

服务地址： https://api.vezapi.com
请求头使用 Authorization: Bearer YOUR_VEZAPI_KEY。每次提交使用唯一的 Idempotency-Key，查询同一笔提交时才复用。

Vidu Q4 图生视频

POST/api/v1/jobs/createTask

模型标识： vidu-q4/image-to-video

参数	类型	说明与限制
`model` 必填	`string`	用于生成的模型名称。此接口必须使用 `vidu-q4/image-to-video`。可选值：`"vidu-q4/image-to-video"` 默认：`"vidu-q4/image-to-video"`
`callBackUrl` 可选	`string`	接收生成任务完成状态更新的回调地址。可选，但建议在生产环境中使用。生成完成后，系统会将任务状态和结果以 POST 方式发送到该地址。
`input` 必填	`object`	生成任务的输入参数。
`input.prompt` 可选	`string`	对动作和场景的文字描述。可选，最多 20000 个字符。 `maxLength: 20000`
`input.duration` 可选	`integer`	视频时长（秒）。整数，范围 3 到 16。默认：`5` `minimum: 3` `maximum: 16`
`input.resolution` 可选	`string`	输出分辨率。可选值：`"540p", "720p", "1080p", "2k", "4k"` 默认：`"720p"`
`input.audio` 可选	`boolean`	生成同步音频（对白和音效）。设为 false 则生成无声视频。默认：`true`
`input.image_url` 必填	`string`	首帧图片地址（http/https）。支持 JPG、JPEG、PNG、WEBP 格式，最大 50 MB。视频将继承该图片的宽高比。 `minLength: 1`

请求示例

curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "vidu-q4/image-to-video",
  "input": {
    "prompt": "Your prompt",
    "duration": 5,
    "resolution": "720p",
    "image_url": "Your prompt"
  }
}'

返回值与错误

HTTP 200

请求成功

参数	类型	说明与限制
`code` 可选	`integer`	请求状态码。请求失败时 HTTP 状态仍为 200，请始终以本字段判断：200 表示成功，其他值均表示失败，原因见 msg。常见值：401 API key 无效或缺失；402 积分不足；429 超出频率限制；422 或 500 请求未能处理（请先查看 msg、检查参数，再决定是否重试）。可选值：`200, 400, 401, 402, 404, 422, 429, 455, 500, 501, 505`
`msg` 可选	`string`	响应消息
`data` 可选	`object`
`data.taskId` 可选	`string`	任务 ID，可用于[获取任务详情](/cn/market/common/get-task-detail)接口查询任务状态

HTTP 500

服务器错误

Vidu Q4 参考生视频

POST/api/v1/jobs/createTask

模型标识： vidu-q4/reference-to-video

参数	类型	说明与限制
`model` 必填	`string`	用于生成的模型名称。此接口必须使用 `vidu-q4/reference-to-video`。可选值：`"vidu-q4/reference-to-video"` 默认：`"vidu-q4/reference-to-video"`
`callBackUrl` 可选	`string`	接收生成任务完成状态更新的回调地址。可选，但建议在生产环境中使用。生成完成后，系统会将任务状态和结果以 POST 方式发送到该地址。
`input` 必填	`object`	生成任务的输入参数。
`input.prompt` 必填	`string`	视频的文字描述。可按顺序引用输入素材，例如 "参考图 2 中的男人说……，使用参考音频 1"。最多 20000 个字符。 `minLength: 1` `maxLength: 20000`
`input.duration` 可选	`integer`	视频时长（秒）。整数，范围 3 到 16。默认：`5` `minimum: 3` `maximum: 16`
`input.resolution` 可选	`string`	输出分辨率。可选值：`"540p", "720p", "1080p", "2k", "4k"` 默认：`"720p"`
`input.audio` 可选	`boolean`	生成同步音频（对白和音效）。设为 false 则生成无声视频。默认：`true`
`input.reference_image_urls` 必填	`array`	参考图片地址（http/https），1 到 15 张。支持 JPG、JPEG、PNG、WEBP 格式。 `minItems: 1` `maxItems: 15`
`input.reference_audio_urls` 可选	`array`	可选的参考音频地址（http/https），最多 3 个。仅支持 MP3 格式，每个时长 3 到 12 秒，最大 50 MB。 `maxItems: 3`
`input.aspect_ratio` 可选	`string`	输出宽高比。可选值：`"16:9", "9:16", "1:1", "4:3", "3:4"` 默认：`"16:9"`

请求示例

curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "vidu-q4/reference-to-video",
  "input": {
    "prompt": "Your prompt",
    "duration": 5,
    "resolution": "720p",
    "reference_image_urls": [
      "Your prompt"
    ],
    "aspect_ratio": "16:9"
  }
}'

返回值与错误

HTTP 200

请求成功

参数	类型	说明与限制
`code` 可选	`integer`	请求状态码。请求失败时 HTTP 状态仍为 200，请始终以本字段判断：200 表示成功，其他值均表示失败，原因见 msg。常见值：401 API key 无效或缺失；402 积分不足；429 超出频率限制；422 或 500 请求未能处理（请先查看 msg、检查参数，再决定是否重试）。可选值：`200, 400, 401, 402, 404, 422, 429, 455, 500, 501, 505`
`msg` 可选	`string`	响应消息
`data` 可选	`object`
`data.taskId` 可选	`string`	任务 ID，可用于[获取任务详情](/cn/market/common/get-task-detail)接口查询任务状态

HTTP 500

服务器错误

任务状态与回调

异步任务请保存返回的 taskId。调用 GET /api/v1/jobs/recordInfo?taskId=... 查询，或在创建时设置 callBackUrl。只有任务所属账号可以查询任务或基于任务创建派生资源。

超时可能表示请求已经受理。请在控制台查看原请求，不要自动新建任务。回调可能重试并重复到达，请使用 X-VezAPI-Event-Id 去重。

文件、日志与计费

生成媒体通常随上游保留 14 天，上传文件在 24 小时后失效。请在过期前保存所需文件。VezAPI 仅流式转发已登记资源，不提供永久作品库。请求日志保留两个自然月。

调用前预留积分，最终按实际优惠扣分 1:1 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。

打开完整文档 →

使用你的 VezAPI 密钥发送请求。成功生成将消耗账号积分。

VezAPI API Key

POST/api/v1/jobs/createTask

请求内容

{
  "model": "vidu-q4/image-to-video",
  "input": {
    "prompt": "Your prompt",
    "duration": 5,
    "resolution": "720p",
    "image_url": "Your prompt"
  }
}

返回结果

返回结果将在这里显示。

Vidu Q4 API 价格

下方费率为参考估算，最终按实际优惠扣分 1:1 结算。按标准充值包换算，1,000 积分约为 10 美元，大额充值包可降低每积分实际单价。

规格	积分	计价单位	美元参考
Vidu Q4, reference-to-video, 4k	62.4	每秒	$0.624
Vidu Q4, reference-to-video, 2k	30.4	每秒	$0.304
Vidu Q4, reference-to-video, 1080p	19.2	每秒	$0.192
Vidu Q4, reference-to-video, 720p	15.2	每秒	$0.152
Vidu Q4, reference-to-video, 540p	7.2	每秒	$0.072
Vidu Q4, image-to-video, 4k	62.4	每秒	$0.624
Vidu Q4, image-to-video, 2k	30.4	每秒	$0.304
Vidu Q4, image-to-video, 1080p	19.2	每秒	$0.192
Vidu Q4, image-to-video, 720p	15.2	每秒	$0.152
Vidu Q4, image-to-video, 540p	7.2	每秒	$0.072