快速结论
- viduq4-preview 在单页中覆盖 Text-to-Video、Image-to-Video、R2V、Video Edit 四种流程。
- 页面支持参数对比与最小请求样例，便于快速验证和接口对接。
- 建议先在本页收敛参数，再迁移到生产 API。
关键参数
- model | string | 必填 | viduq4-preview | - | 模型标识，固定使用 `viduq4-preview`。
- prompt | string | 必填 | - | - | 描述目标视频的主体、动作、场景与风格。
- aspect_ratio | string | 可选 | 16:9 | 16:9 | 9:16 | 4:3 | 3:4 | 1:1 | 视频画幅比例，默认 `16:9`；支持 `16:9 | 9:16 | 4:3 | 3:4 | 1:1`。
- duration | integer | 可选 | 5 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 输出时长，单位秒；默认 `5`，支持 `3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16`。
- resolution | string | 可选 | 720p | 540p | 720p | 1080p | 2K | 4K | 输出分辨率；默认 `720p`，支持 `540p | 720p | 1080p | 2K | 4K`。
常见错误
- 400 invalid_request_error: 触发=请求体缺少必填字段或字段类型不匹配。; 修复=校验 model、mode、input 的字段完整性与类型。; 重试=修正参数后重试，不建议直接盲重试。
- 401 authentication_error: 触发=缺少 Authorization 头或 API Key 无效。; 修复=确认 Bearer Token 与密钥权限范围。; 重试=修复鉴权后重试；连续失败请轮换密钥。
- 429 rate_limit_exceeded: 触发=请求频率、并发或当前额度命中上游限流策略。; 修复=先做指数退避重试，并检查当前请求节奏、并发设置和额度使用情况。; 重试=建议指数退避（例如 1s/2s/4s）+ 抖动；连续触发时再收紧提交节奏。
- 500 internal_error: 触发=上游服务瞬时异常或内部处理失败。; 修复=记录 request id 并触发重试链路。; 重试=可短间隔重试 2-3 次，持续失败请升级人工排查。