Vidu 文生视频
使用 Vidu 原生正文创建异步任务,当前支持 viduq2、viduq3-pro、viduq3-turbo。Q2 为 1–10 秒,Q3 为 1–16 秒,默认 5 秒;分辨率默认 720p。 请求 goldflow.cc 地址并使用 Bearer goldflow.cc API Key;不使用官方示例中的 Token 鉴权,也不在路径增加供应商前缀。 保存返回的 goldflow.cc 公共 task_id,以同一 API Key 查询 GET /ent/v2/tasks/{task_id}/creations。当前仅支持即时生成,off_peak 只能为 false。 创建预扣、成功结算、失败退款,查询不重复收费。完整示例见 Vidu 接入文档。
bearerAuthAuthorizationBearer <API key>使用 Authorization Bearer API Key 进行鉴权。
application/json- body
原生 Vidu 请求公共字段;具体模型与操作约束见各请求分支。未列出的原生扩展字段仍由上游校验。
model*"viduq2""viduq2"duration?integer整数秒;Q2 为 1–10、Q3 为 1–16、Q4 协议为 3–16。
1 <= value <= 105resolution?stringQ2/Q3 使用 540p/720p/1080p;Q2 Pro Fast 仅 720p/1080p;Q4 协议还支持 2K/4K。
"720p""540p""720p""1080p"audio?booleanQ3 与 Q4 默认 true;Q2 文生默认 true、图生和参考默认 false。Q2 首尾帧不承诺此能力。
seed?integer不传或为 0 时随机;显式 0 会保留。
0payload?string原样返回的业务关联字符串。
length <= 1048576off_peak?boolean本站当前仅提供即时生成,不接受 true。
falsewatermark?boolean是否添加水印,建议明确填写。
wm_position?integer水印位置;位置与默认值以具体模型的官方说明为准。
1234wm_url?string自定义水印图片 URL。
meta_data?stringJSON 编码的内容标识字符串,不是 JSON 对象。
callback_url?string供应商执行 POST 回调;回调可能携带上游 ID,不能替代 goldflow.cc 公共任务 ID。
uriprompt*string1 <= length <= 5000aspect_ratio?string"16:9""1:1""16:9""9:16""4:3""3:4"[key: string]?any已受理异步任务,不代表生成成功;保存公共 task_id 并查询终态。
application/json- response
task_id*stringgoldflow.cc 公共任务 ID,用于后续查询。
^task_.+state*string"created""queueing""processing""success""failed"model?stringcredits?integer受理时返回的积分信息;最终以成功任务的结算信息为准。
created_at?stringdate-time[key: string]?anycurl -X POST 'https://goldflow.cc/ent/v2/text2video' \ -H 'Content-Type: application/json' \ -d '{ "model": "viduq3-turbo", "prompt": "晨光中,一只红色陶瓷茶壶放在木桌上,镜头缓慢推进。", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9", "audio": true, "seed": 0, "off_peak": false, "watermark": false}'{ "task_id": "task_VIDU_PUBLIC_EXAMPLE", "state": "created", "model": "viduq3-turbo"}Models and Parameters
Previous Page
Image to Video
输入一张首帧图,创建 Vidu 异步视频任务。当前可用 viduq2-pro、viduq2-turbo、viduq2-pro-fast、viduq3-pro、viduq3-turbo。 viduq4-preview 的字段依照 [官方 Q4 Preview 文档](https://platform.vidu.cn/docs/api-reference/video-models/vidu-q4-preview/image-to-video)说明协议;本站尚未确认其渠道可用,不代表已开放,调用前请查看模型权限。 Q2 为 1–10 秒;Q3 为 1–16 秒;Q4 协议为 3–16 秒。Q4 的 2K/4K 不适用于 Q2/Q3。当前 Q3 不接受 is_rec: true,请明确传 false 使用自己的提示词;off_peak 只能为 false。 使用 Bearer goldflow.cc API Key,保存公共 task_id 并以同一 Key 查询。原生附加字段及显式 false/0 会保留,具体媒体校验由上游完成。