Qwen Image 2.0 Pro API

POST /v1/tasks

所有模型都通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称	qwen-image-2.0-pro
类型	图像生成（文生图）
接口	POST /v1/tasks
价格	见 HiAPI 定价

阿里通义 Qwen Image 2.0 专业档:文字渲染更强、写实质感更细腻、语义遵循更准,最高 2048x2048,按张计费。

生产建议

生产环境建议

生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

专业级中文文字渲染

牌匾、春联、标签等画面文字准确率是 Pro 档强项,「云顶茶居」「万象更新」等实测全对。

promptprompt_extend

细腻写实质感

人像皮肤纹理、金属反光、材质细节明显优于基础版,适合人像与产品大片。

prompt

商业海报与产品图

语义遵循更强,多元素构图(主体+文字+氛围)一次成型,返工少。

promptsize

灵活尺寸

总像素 512² 到 2048² 之间自由设置,五档推荐尺寸覆盖常用画幅。

size

请求参数

POST https://api.hiapi.ai/v1/tasks

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
# 把 YOUR_API_KEY 换成你的账号 API Key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-2.0-pro",
  "input": {
    "prompt": "一座悬浮在云海之上的中式空中茶馆,飞檐翘角挂满暖黄灯笼,木质牌匾上写着「云顶茶居」四个楷书大字,一条木栈道从云中延伸至茶馆,晨光穿透云层,电影感构图,戏剧性定向打光,暖金与云白统一色调,超高细节,商业级质感,细微胶片颗粒",
    "size": "2688*1536",
    "prompt_extend": false
  }
}'

import requests, json

# 业务参数对象，字段随模型而定（见对应模型页）
payload = json.loads(r'''
{
  "model": "qwen-image-2.0-pro",
  "input": {
    "prompt": "一座悬浮在云海之上的中式空中茶馆,飞檐翘角挂满暖黄灯笼,木质牌匾上写着「云顶茶居」四个楷书大字,一条木栈道从云中延伸至茶馆,晨光穿透云层,电影感构图,戏剧性定向打光,暖金与云白统一色调,超高细节,商业级质感,细微胶片颗粒",
    "size": "2688*1536",
    "prompt_extend": false
  }
}
''')

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # 成功返回 { code, message, data: { taskId } }

// 提交异步任务，成功立即返回 taskId（不等待生成完成）
// 把 YOUR_API_KEY 换成你的账号 API Key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "qwen-image-2.0-pro",
  "input": {
    "prompt": "一座悬浮在云海之上的中式空中茶馆,飞檐翘角挂满暖黄灯笼,木质牌匾上写着「云顶茶居」四个楷书大字,一条木栈道从云中延伸至茶馆,晨光穿透云层,电影感构图,戏剧性定向打光,暖金与云白统一色调,超高细节,商业级质感,细微胶片颗粒",
    "size": "2688*1536",
    "prompt_extend": false
  }
}),
});
console.log(await resp.json()); // 成功返回 { code, message, data: { taskId } }

model string 必填

固定填 qwen-image-2.0-pro。

示例 qwen-image-2.0-pro

input object 必填

业务参数对象；Qwen Image 2.0 Pro 的模型专属配置都放在这里。

prompt string 必填

画面描述,中英文均可;要渲染的文字逐字写进提示词。

size enum 可选

输出尺寸宽*高;总像素在 512x512 与 2048x2048 之间自由设置。

默认 2048*2048 可选值: 2688*15362368*17282048*20481728*23681536*2688

negative_prompt string 可选

负向提示词:描述画面中要避免出现的内容。

默认 ""

prompt_extend boolean 可选

自动优化改写提示词(默认开);画面含精确文字时建议关闭,避免原文被改写。

默认 true

watermark boolean 可选

是否添加 AI 生成水印(默认关)。

默认 false

seed integer 可选

随机种子,0-2147483647,固定后可复现。

callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback

when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

云顶茶居(牌匾文字)

16:9 大场景 + 楷书牌匾,验证文字与氛围。

请求体

{
  "model": "qwen-image-2.0-pro",
  "input": {
    "prompt": "一座悬浮在云海之上的中式空中茶馆,飞檐翘角挂满暖黄灯笼,木质牌匾上写着「云顶茶居」四个楷书大字,一条木栈道从云中延伸至茶馆,晨光穿透云层,电影感构图,戏剧性定向打光,暖金与云白统一色调,超高细节,商业级质感,细微胶片颗粒",
    "size": "2688*1536",
    "prompt_extend": false
  }
}

银饰老匠人(写实人像)

3:4 人像,验证皮肤纹理与浅景深。

请求体

{
  "model": "qwen-image-2.0-pro",
  "input": {
    "prompt": "一位苗族银饰老匠人的写实肖像,布满岁月痕迹的双手正在錾刻一只银蝴蝶,工作台上散落银屑与工具,窗外柔光洒在他专注的侧脸,皮肤纹理与银器反光细腻真实,浅景深,电影感构图,超高细节",
    "size": "1728*2368",
    "prompt_extend": false
  }
}

沉香香水(商业产品)

9:16 产品大片,标签双语文字。

请求体

{
  "model": "qwen-image-2.0-pro",
  "input": {
    "prompt": "新中式香水产品商业大片,琥珀色玻璃香水瓶立于水面浅滩,瓶身标签清晰印着「沉香」宋体字和 AGARWOOD 英文,背景水墨远山,涟漪倒影,晨雾氤氲,电影感构图,琥珀与墨色统一色调,超高细节",
    "size": "1536*2688",
    "prompt_extend": false
  }
}

获取结果

提交成功后立即返回 taskId（不等待生成完成）。
生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
status=success 后，从返回的 output[].url 下载生成的图片。
如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

Pro 和基础版 qwen-image-2.0 怎么选?

Pro 在文字渲染、写实质感和语义遵循上都更强,单价更高;基础版性价比高适合迭代。建议基础版跑创意、Pro 出成片,参数结构一致切换零成本。

支持 4K 吗?

不支持。Pro 最高 2048x2048(总像素上限),需要 4K 直出选 wan2.7-image/text-to-image 或 seedream-5.0-lite。

prompt_extend 什么时候关?

prompt_extend 默认开启,会自动改写优化提示词。画面里有精确文字(牌匾/春联/标签)时务必设为 false,避免原文被改写;纯场景类提示词保持开启效果更好。

怎么拿到生成的图片?

提交后立即返回 taskId,任务进入终态后从 output[].url 下载图片。生产环境建议在请求体顶层传 callback.url 收终态通知,减少无效轮询。