ModelSell 文档
视频系列Vidu 视频

Vidu 文生视频

POST
/ent/v2/text2video

使用 Vidu 原生正文创建异步任务，当前支持 viduq2、viduq3-pro、viduq3-turbo。Q2 为 1–10 秒，Q3 为 1–16 秒，默认 5 秒；分辨率默认 720p。 请求 ModelSell 地址并使用 Bearer ModelSell API Key；不使用官方示例中的 Token 鉴权，也不在路径增加供应商前缀。 保存返回的 ModelSell 公共 task_id，以同一 API Key 查询 GET /ent/v2/tasks/{task_id}/creations。当前仅支持即时生成，off_peak 只能为 false。 创建预扣、成功结算、失败退款，查询不重复收费。完整示例见 Vidu 接入文档。

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/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"
}
Empty
{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}

模型与请求参数

Previous Page

图生视频

输入一张首帧图，创建 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 会保留，具体媒体校验由上游完成。