Vidu 参考生视频
当前渠道提供 viduq2、viduq2-pro 的参考生视频。图片参考输入 1–7 张,或按官方主体格式提供 subjects。主体创建和管理 API 不在本站公开接口范围。 Q4 Preview 的图片与 sounds 字段仅说明官方协议,尚未确认本站渠道可用。Q3 Turbo 虽在官方提供参考生视频,本站当前渠道未开放此操作,不应直接将文生/图生权限视为参考权限。 使用 Bearer goldflow.cc API Key,并保存公共 task_id。以创建时同一 Key 查询 GET /ent/v2/tasks/{task_id}/creations;当前 off_peak 只能为 false。
bearerAuthAuthorizationBearer <API key>使用 Authorization Bearer API Key 进行鉴权。
application/json- body
原生 Vidu 请求公共字段;具体模型与操作约束见各请求分支。未列出的原生扩展字段仍由上游校验。
model*string"viduq2""viduq2-pro"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 <= 5000images*array<>1 <= items <= 7subjects?array<>Q2 临时主体或已有主体的原生数组;主体数量和媒体格式按官方模型限制校验。本站不提供主体创建或管理接口,当前渠道未确认视频主体及视频编辑的可用性。
1 <= itemsaspect_ratio?stringQ2 支持 auto 或具体比例;Q4 使用 1:1、9:16、16:9、3:4、4:3。
"16:9"sounds?array<string>仅 Q4 协议;最多 3 个 mp3 音频,每个 3–12 秒、最大 50MB,整个请求不超过 20MB。
items <= 3[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/reference2video' \ -H 'Content-Type: application/json' \ -d '{ "model": "viduq2", "images": [ "https://example.com/character.png", "https://example.com/scene.png" ], "prompt": "参考图1中的角色在参考图2的场景中走向镜头。", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9", "audio": false, "watermark": false}'{ "task_id": "task_VIDU_PUBLIC_EXAMPLE", "state": "created", "model": "viduq3-turbo"}首尾帧生视频
images 按首帧、尾帧顺序提供两张图片。当前支持 viduq2-pro、viduq2-turbo、viduq2-pro-fast、viduq3-pro、viduq3-turbo;Q4 Preview 不提供首尾帧操作。 Q2 为 1–10 秒,Q3 为 1–16 秒;Pro Fast 仅使用 720p/1080p。Q3 支持 audio 音画同出;不要将 Q3 的 audio 能力直接套用于 Q2 首尾帧。 使用 Bearer goldflow.cc API Key。保存公共 task_id 并以同一 Key 查询原生任务接口;当前 off_peak 只能为 false。
查询任务
传入创建响应中的 goldflow.cc 公共 task_id,使用创建任务的同一 goldflow.cc API Key。不能替换为供应商内部 ID 或回调中的 ID。 查询响应的顶层任务 ID 字段为 id;创建响应则为 task_id。state 为 success 时,从 creations[].url 读取视频地址;failed 时读取 err_code。 created、queueing、processing 为未完成状态,建议每 10–15 秒有界轮询。视频、封面和水印视频链接通常有效 24 小时,请及时下载或转存。 查询不重复收费。callback_url 由供应商执行,回调 ID 不保证与公共 ID 一致;仍以公共 ID 的查询结果为准。