Skip to Content
goldflow.cc Docs
VideosVidu Video

Vidu 首尾帧生视频

POST
/ent/v2/start-end2video

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。

Authorization

bearerAuth
headerAuthorizationBearer <API key>

使用 Authorization Bearer API Key 进行鉴权。

Request Body

application/json
  1. body

原生 Vidu 请求公共字段;具体模型与操作约束见各请求分支。未列出的原生扩展字段仍由上游校验。

model*string
Value in"viduq2-pro""viduq2-turbo"
duration?integer

整数秒;Q2 为 1–10、Q3 为 1–16、Q4 协议为 3–16。

Range1 <= value <= 10
Default5
resolution?string

Q2/Q3 使用 540p/720p/1080p;Q2 Pro Fast 仅 720p/1080p;Q4 协议还支持 2K/4K。

Default"720p"
Value in"540p""720p""1080p"
audio?boolean

Q3 与 Q4 默认 true;Q2 文生默认 true、图生和参考默认 false。Q2 首尾帧不承诺此能力。

seed?integer

不传或为 0 时随机;显式 0 会保留。

Default0
payload?string

原样返回的业务关联字符串。

Lengthlength <= 1048576
off_peak?boolean

本站当前仅提供即时生成,不接受 true。

Defaultfalse
watermark?boolean

是否添加水印,建议明确填写。

wm_position?integer

水印位置;位置与默认值以具体模型的官方说明为准。

Value in1234
wm_url?string

自定义水印图片 URL。

meta_data?string

JSON 编码的内容标识字符串,不是 JSON 对象。

callback_url?string

供应商执行 POST 回调;回调可能携带上游 ID,不能替代 goldflow.cc 公共任务 ID。

Formaturi
images*array<>

第一张为首帧,第二张为尾帧;图片比例和分辨率应相近,规格以对应模型官方说明为准。

Items2 <= items <= 2
prompt?string
Lengthlength <= 5000
bgm?boolean

Q2 背景音乐选项,Q3 不使用该选项;以模型支持为准。

[key: string]?any

Response Body

已受理异步任务,不代表生成成功;保存公共 task_id 并查询终态。

application/json
  1. response
task_id*string

goldflow.cc 公共任务 ID,用于后续查询。

Match^task_.+
state*string
Value in"created""queueing""processing""success""failed"
model?string
credits?integer

受理时返回的积分信息;最终以成功任务的结算信息为准。

created_at?string
Formatdate-time
[key: string]?any
Example Request
curl -X POST 'https://goldflow.cc/ent/v2/start-end2video' \  -H 'Content-Type: application/json' \  -d '{  "model": "viduq3-turbo",  "images": [    "https://example.com/first-frame.png",    "https://example.com/last-frame.png"  ],  "prompt": "镜头从首帧平稳过渡到尾帧,保持人物与场景一致。",  "duration": 5,  "resolution": "720p",  "audio": true,  "watermark": false}'
Example Response
{  "task_id": "task_VIDU_PUBLIC_EXAMPLE",  "state": "created",  "model": "viduq3-turbo"}