viduq3-pro (Image To Video)
身份验证
1.
2.
3.
4.
发起请求
查询结果
enable_sync_mode 设置为 true（某些模型不支持此参数，但您仍需要通过 id 查询结果），您必须调用查询结果接口来获取最终输出。您可以在以下位置找到它：
data.id – 预测的唯一标识符data.urls[0].get – 一个现成的 GET URL，已嵌入 id响应示例
{
"data": {
"id": "abc",
"model": "model_name",
"outputs": [],
"urls": {
"get": "https://surgeai.one/api/v3/predictions/abc/result"
},
"status": "completed",
"error": null,
"executionTime": 0,
"timings": {
"inference": 0
},
"has_nsfw_contents": [],
"created_at": "2026-01-01 00:00:00"
},
"message": "success",
"code": 200
}参数
路径参数
https://surgeai.one/api/v3/vidu/{model}/{scene}| scene | 示例 | 可用模型 |
|---|---|---|
text-to-video | https://surgeai.one/api/v3/vidu/{model}/text-to-video | viduq2 viduq3-pro |
reference-to-video | https://surgeai.one/api/v3/vidu/{model}/reference-to-video | viduq2 |
image-to-video | https://surgeai.one/api/v3/vidu/{model}/image-to-video | viduq3-pro viduq2-pro-fast viduq2-pro viduq2-turbo |
start-end-framed | https://surgeai.one/api/v3/vidu/{model}/start-end-frame | viduq2-pro-fast viduq2-pro viduq2-turbo |
核心参数
| 参数 | 类型 | 必填 | 默认值 | 范围 | 描述 |
|---|---|---|---|---|---|
prompt | string | 是 | - | - | 生成的正向提示词。 |
resolution | string | 否 | 720p | 540p, 720p, 1080p | 生成媒体的分辨率。 |
duration | number | 否 | 5 | 1 ~ 10 | 生成媒体的时长，以秒为单位。 |
aspect_ratio | string | 否 | 4:3 | 3:4, 4:3 | 生成媒体的宽高比。 |
bgm | boolean | 否 | false | true, false | 生成输出的背景音乐。 |
audio | boolean | 否 | false | true, false | 生成输出的音频。 |
seed | integer | 否 | 1 | 1 ~ 2147483647 | 生成使用的随机种子。1 表示将使用随机种子。 |
图像输入 参数
| 参数 | 类型 | 必填 | 默认值 | 范围 | 描述 |
|---|---|---|---|---|---|
image | string | 是 | - | - | 生成输出的起始图像。 |
last_image | string | 是 | - | - | 生成输出的结束图像。 |
subjects | array | 是 | - | 1~7 | 图像中主体的信息。 |
>>subjects.id | string | 是 | - | - | 可在提示词中通过 @subjectId 使用。 |
>>subjects.images | array | 是 | - | 1~3 | 对应主体的图像 URL。每个主体最多支持 3 张图像。 |
>>subjects.voice_id | string | 否 | - | - | 用于确定视频中的声音角色。系统会自动推荐合适的声音，可选值可在声音列表中找到。如果指定了 voice_id，则 audio 参数必须设置为 true。 |
模型场景兼容性矩阵
| Model | text-to-video | reference-to-video | image-to-video | start-end-framed |
|---|---|---|---|---|
| viduq2 | • duration: D=5, R=1-10 • resolution: D=720p, R=540p/720p/1080p • aspect_ratio: D=16:9, R=16:9/9:16/3:4/4:3/1:1 • audio: 无效 • bgm: D=false，duration=9-10 时无效 | • duration: D=5, R=1-10 • resolution: D=720p, R=540p/720p/1080p • aspect_ratio: D=16:9, R=任意支持的比率 • audio: D=false • bgm: 无效 | 不支持 | 不支持 |
| viduq2-pro-fast | 不支持 | 不支持 | • duration: D=5, R=1-10 • resolution: D=720p, R=720p/1080p • aspect_ratio: 无效 • audio: D=false • bgm: D=false，duration=9-10 时无效 | • duration: D=5, R=1-8 • resolution: D=720p, R=540p/720p/1080p • aspect_ratio: 无效 • audio: 无效 • bgm: D=false，duration=9-10 时无效 |
| viduq2-turbo | 不支持 | 不支持 | • duration: D=5, R=1-10 • resolution: D=720p, R=540p/720p/1080p • aspect_ratio: 无效 • audio: D=false • bgm: D=false，duration=9-10 时无效 | • duration: D=5, R=1-8 • resolution: D=720p, R=540p/720p/1080p • aspect_ratio: 无效 • audio: 无效 • bgm: D=false，duration=9-10 时无效 |
| viduq2-pro | 不支持 | 不支持 | • duration: D=5, R=1-10 • resolution: D=720p, R=540p/720p/1080p • aspect_ratio: 无效 • audio: D=false • bgm: D=false，duration=9-10 时无效 | • duration: D=5, R=1-8 • resolution: D=720p, R=540p/720p/1080p • aspect_ratio: 无效 • audio: 无效 • bgm: D=false，duration=9-10 时无效 |
| viduq3-pro | • duration: D=5, R=1-16 • resolution: D=720p, R=540p/720p/1080p • aspect_ratio: D=16:9, R=16:9/9:16/3:4/4:3/1:1 • audio: D=true • bgm: 无效 | 不支持 | • duration: D=5, R=1-16 • resolution: D=720p, R=540p/720p/1080p • aspect_ratio: 无效 • audio: D=true • bgm: 无效 | 不支持 |
关键特性
错误码
常见错误码
| 错误码 | 错误名称 | 描述 |
|---|---|---|
| 401 | Unauthorized | API key 缺失或无效 |
| 403 | Forbidden | 您的 API key 没有权限访问此资源，或余额不足以执行请求的操作 |
| 429 | Too Many Requests | 您已超出速率限制 |
| 500 | Internal server error | 服务器内部错误 |
| 503 | Content policy violation | 内容因安全问题被拦截（实际状态码为 400） |
修改于 2026-03-11 06:24:05