Qwen Image 3.0 Pro 图生图
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过 统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型名称 | qwen-image-3.0-pro/image-to-image |
|---|---|
| 类型 | 图生图 |
| 接口 | POST /v1/tasks |
| 价格 | 见 HiAPI 定价 |
Qwen Image 3.0 Pro Image to Image，使用统一异步接口生成参考图引导图片。
生产建议
生产建议
- 生产环境优先传 callback.url 接收终态通知。
- 在 prompt 中明确说明要保留的主体、构图和文字。
- 含精确画面文字时，建议将 prompt_extend 设为 false。
适用场景
高质量精修
适合复杂材质、高密度版式和最终成片精修。
image_urlsprompt画幅控制
可为输出选择方图、横图、竖图或超宽画幅。
aspect_ratio请求参数
model string 必填 固定填 qwen-image-3.0-pro/image-to-image。
input object 必填 模型专属参数对象。
prompt string 必填 正向提示词，描述画面内容、风格和构图；最长 18000 个字符。
image_urls string[] 必填 参考图 URL 数组，1–3 张；支持 JPEG、PNG、WEBP、BMP、GIF、TIFF，每张不超过 10 MB；不支持 SVG。
aspect_ratio enum 可选 输出画面的宽高比例。
resolution enum 可选 输出分辨率档位。
output_format enum 可选 生成图片的文件格式。
prompt_extend boolean 可选 是否自动优化提示词。
negative_prompt string 可选 不希望出现在画面中的内容，最长 500 个字符。
seed integer 可选 随机种子，范围 0–2147483647。
callback object 可选 可选回调配置。生产环境建议传 callback.url 接收任务终态通知。
url string 必填 接收任务终态通知的 HTTPS 地址。
when enum 可选 回调触发时机；使用 final。
用例示例
参考图精修
使用已验证的请求结构。
请求体
{
"model": "qwen-image-3.0-pro/image-to-image",
"input": {
"prompt": "Refine the supplied image into a premium editorial photograph while preserving its composition and main subject. No added text or logo.",
"image_urls": [
"https://dev-static.hiapi.ai/model-covers/2026/08/10/1786343693249-49193d12be6a4009-qwen-image-3-0-pro-golden.webp"
],
"aspect_ratio": "16:9",
"resolution": "2K",
"output_format": "png",
"prompt_extend": false
}
}获取结果
- 提交成功后立即获得 taskId。
- 生产环境优先等待 callback.url；本地调试可轮询 GET /v1/tasks/:id。
- status=success 后从 output[].url 下载图片。
常见问题
Standard 和 Pro 怎么选？
Standard 适合快速试稿和常规视觉生成；Pro 适合更丰富细节、复杂材质和最终成片。