创建 Vidu 图片生成任务（文生图/参考生图）

POST

/domi/providers/vidu/ent/v2/reference2image

当前网关支持的模型（请求 model 直接填写）：viduq2、viduq1。列表依据仓库 SQL 配置，实际可用性取决于部署环境启用配置及 NewAPI 授权。

官方接口文档：https://platform.vidu.cn/docs/reference-to-image

网关按端点和请求参数选择唯一的受控配置，创建后异步轮询。仅当 Vidu 返回 success 时，才将结果中的 credits 作为 completion tokens 调用 NewAPI 结算；失败、取消任务不收费。 viduq2 在不传 images 时即为文生图；传 images 时可用于图片编辑或参考生图。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

{
    "model": "viduq2",
    "images": [
        "your_image_url1",
        "your_image_url2",
        "your_image_url3"
    ],
    "prompt": "your_prompt",
    "seed": 0,
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "payload": ""
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gateway.domi-kids.com/domi/providers/vidu/ent/v2/reference2image' \
--header 'domi-ai-metadata;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "viduq2",
    "images": [
        "your_image_url1",
        "your_image_url2",
        "your_image_url3"
    ],
    "prompt": "your_prompt",
    "seed": 0,
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "payload": ""
}'

返回响应

🟢200

application/json

创建成功，返回 Vidu 任务 ID

Bodyapplication/json

示例

{
    "task_id": "task_018f840081627e03",
    "state": "created"
}

🟠400

🟠401

🟠4XX

🔴5XX

修改于 2026-09-16 09:19:31

创建 Vidu 智能多帧视频任务

创建 Vidu 文生音频任务