ModelSell Docs
VideosVidu Video

Vidu 参考生视频

POST
/ent/v2/reference2video

当前渠道提供 viduq2、viduq2-pro 的参考生视频。图片参考输入 1–7 张，或按官方主体格式提供 subjects。主体创建和管理 API 不在本站公开接口范围。 Q4 Preview 的图片与 sounds 字段仅说明官方协议，尚未确认本站渠道可用。Q3 Turbo 虽在官方提供参考生视频，本站当前渠道未开放此操作，不应直接将文生/图生权限视为参考权限。 使用 Bearer ModelSell API Key，并保存公共 task_id。以创建时同一 Key 查询 GET /ent/v2/tasks/{task_id}/creations；当前 off_peak 只能为 false。

Authorization

bearerAuth
AuthorizationBearer <token>

使用 Authorization Bearer API Key 进行鉴权。

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/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"
}
Empty
{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}

Start and End Frames

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 ModelSell API Key。保存公共 task_id 并以同一 Key 查询原生任务接口；当前 off_peak 只能为 false。

Query Task

传入创建响应中的 ModelSell 公共 task_id，使用创建任务的同一 ModelSell 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 的查询结果为准。