跳转到主要内容
千问 AI 平台 home page
文档
Vidu 图像生成

Vidu -- 创建任务

使用 Vidu 模型提交图像生成任务（文生图/参考图生图），异步生成图像。

POST
/services/aigc/image-generation/generation
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
  --header 'X-DashScope-Async: enable' \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "vidu/vidu-image_reference2image",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "一间有着精致窗户的花店,漂亮的木质门,摆放着花朵"
          }
        ]
      }
    ]
  },
  "parameters": {
    "size": "1024*1024",
    "n": 1,
    "watermark": false
  }
}'
{
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "PENDING"
  },
  "code": "<string>",
  "message": "<string>"
}
提交图像生成任务后，服务将异步生成图像。提交任务后，使用查询任务结果接口轮询任务状态，直到 task_status 为 SUCCEEDED 或 FAILED。

模型列表

模型能力输入模态输出图像规格
vidu/vidu-image_reference2image参考生图、文生图、图片编辑，中英文字精准渲染、UI/图表像素级还原文本、图像1K/2K/4K，1 张，PNG
vidu/viduq3-fast_reference2image参考生图、文生图、图片编辑，高速高质低成本（比 Pro 降低约 50%）文本、图像1K/2K/4K，1 张，PNG
vidu/viduq2-pro_reference2image参考生图、文生图、图片编辑，复杂逻辑处理、上下文一致性文本、图像1K/2K/4K，1 张，PNG
vidu/viduq2-fast_reference2image参考生图、文生图、图片编辑，语义理解增强文本、图像1K，1 张，PNG

HTTP 调用

图像生成接口仅支持异步调用，请求时必须携带请求头 X-DashScope-Async: enable。 任务提交成功后返回 task_id，使用查询任务结果接口获取生成结果。

可用尺寸列表

vidu-image

分辨率支持尺寸
1K1024*1024, 720*1440, 1440*720, 1024*768, 768*1024, 1920*1088, 1088*1920, 1536*1024, 1024*1536, 1920*816, 816*1920
2K2048*2048, 1088*2160, 2160*1088, 2736*2048, 2048*2736, 2560*1440, 1440*2560, 3072*2048, 2048*3072, 2560*1104, 1104*2560
4K2880*2880, 1440*2880, 2880*1440, 3312*2480, 2480*3312, 3840*2160, 2160*3840, 3520*2352, 2352*3520, 3840*1648, 1648*3840

viduq3-fast

分辨率支持尺寸
1K1024*1024, 768*1376, 848*1264, 896*1200, 928*1152, 1152*928, 1200*896, 1264*848, 1376*768, 1584*672, 512*2064, 2064*512, 352*2928, 2928*352
2K2048*2048, 1536*2752, 1696*2528, 1792*2400, 1856*2304, 2304*1856, 2400*1792, 2528*1696, 2752*1536, 3168*1344, 1024*4128, 4128*1024, 704*5856, 5856*704
4K4096*4096, 3072*5504, 3392*5056, 3584*4800, 3712*4608, 4608*3712, 4800*3584, 5056*3392, 5504*3072, 6336*2688, 2048*8256, 8256*2048, 1408*11712, 11712*1408

viduq2-pro

分辨率支持尺寸
1K1024*1024, 768*1376, 848*1264, 896*1200, 928*1152, 1152*928, 1200*896, 1264*848, 1376*768, 1584*672
2K2048*2048, 1536*2752, 1696*2528, 1792*2400, 1856*2304, 2304*1856, 2400*1792, 2528*1696, 2752*1536, 3168*1344
4K4096*4096, 3072*5504, 3392*5056, 3584*4800, 3712*4608, 4608*3712, 4800*3584, 5056*3392, 5504*3072, 6336*2688

viduq2-fast

分辨率支持尺寸
1K1024*1024, 768*1376, 848*1264, 896*1200, 928*1152, 1152*928, 1200*896, 1264*848, 1376*768, 1584*672

鉴权

​
string
header
必填

千问 AI 平台 API Key。详见获取 API Key。

Header 参数

​
enum<string>
必填

请求内容类型，必须设置为 application/json。

可选值：application/json
​
enum<string>
必填

异步处理配置参数。HTTP 请求只支持异步，必须设置为 enable。缺少此请求头将报错："current user api does not support synchronous calls"。

可选值：enable
​
string

任务完成后的回调通知地址。

请求体

application/json
​
enum<string>
必填

模型名称。

可选值：vidu/vidu-image_reference2image,vidu/viduq3-fast_reference2image,vidu/viduq2-pro_reference2image,vidu/viduq2-fast_reference2image
示例:vidu/vidu-image_reference2image
​
object
必填

输入参数对象。

​
object

控制图像生成参数。

响应

200-application/json
​
string

请求唯一标识。可用于请求明细溯源和问题排查。

示例:4909100c-7b5a-9f92-bfe5-xxxxxx
​
object

任务输出信息。

​
string

请求失败的错误码。请求成功时不会返回此参数。

​
string

请求失败的详细信息。请求成功时不会返回此参数。