ModelSell 文档
视频系列Vidu 视频

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 ModelSell API Key。保存公共 task_id 并以同一 Key 查询原生任务接口；当前 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/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  }'
{
  "task_id": "task_VIDU_PUBLIC_EXAMPLE",
  "state": "created",
  "model": "viduq3-turbo"
}
Empty
{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}

图生视频

输入一张首帧图，创建 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 ModelSell API Key，保存公共 task_id 并以同一 Key 查询。原生附加字段及显式 false/0 会保留，具体媒体校验由上游完成。

参考生视频

当前渠道提供 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。