Alibaba

Qwen Image 3.0

qwen-image-3.0/image-to-image

阿里第三代图像生成与编辑模型，擅长长提示词下的密集排版与多语言文字渲染，支持参考图编辑

qwen-image-3.0-pro/image-to-image qwen-image-3.0-pro/text-to-image qwen-image-3.0/image-to-image qwen-image-3.0/text-to-image

试用 qwen-image-3.0/image-to-image

输入

作品灵感

查看全部作品

输出

image

填写参数并生成，结果会显示在这里。

价格

qwen-image-3.0/image-to-image 每张

单价	$0.0358

定位简介

基于参考图迭代修改的图像编辑模型，属于 Qwen-Image 3.0 系列。调用时传入 1–3 张参考图和一段描述保留与修改内容的正向提示词，即可在保留原图关键细节的前提下修改场景、风格、服装与画面文字，并输出 1K 或 2K 图片。适合需要把已有素材快速改造成信息图、海报、UI 概念稿或商品展示图的开发者，尤其是画面文字密集、多语言排版要求高的内容生产场景。

核心亮点

参考图迭代编辑，保留原图细节——以 1–3 张图作输入，按提示词修改场景、风格、服装与文字，而不是完全重绘，便于对同一素材反复迭代。
密集排版与小字号文字渲染——面向承载信息的画面设计，布局与多语言文字渲染更稳定，适合信息图、界面稿等文字密集的产出。
提示词可描述复杂版式——正向提示词上限 18000 字符，足以描述多元素画面、版面结构与区域性的修改要求。
输出规格可控——支持 1K/2K 分辨率档、8 种宽高比、png 或 jpeg 输出、随机种子与负向提示词，结果便于纳入生产流程。

能力说明

参考图编辑：传入 1–3 张参考图并配合提示词，在保留原图关键信息的基础上改动内容，适合对已有素材做定向修改而非重新生成。

长提示词与负向约束：正向提示词支持长文本描述版面与保留、修改区域，另有负向提示词排除不想要的元素，便于精确控制画面。

排版与文字渲染：可生成布局正确、含多语言文字的画面，适配信息图、界面概念稿等文字密集的视觉内容产出。

提示词自动优化：prompt_extend 默认开启，可自动扩写提示词，在输入较简短时降低描述负担，也可关闭以保持原样。

输出规格与可复现性：可指定分辨率档位、宽高比与文件格式，并通过 seed 复现结果，方便批量产出一致风格的素材。

适用场景

设计师改造现有海报或信息图——上传原版海报或版式稿，按提示词调整文案、风格或版面，得到可直接用于投放的更新版视觉素材。
产品团队迭代 UI 概念稿——以现有界面截图作参考图，修改配色、布局或文字，产出用于评审与原型讨论的高保真界面概念图。
电商运营更新商品展示图——用商品图作参考，调整场景、背景或模特服装，产出用于详情页与营销素材的商品展示图。
多语言物料本地化——以中文或英文物料为参考图，替换语言与风格，生成适配不同市场的宣传视觉素材。

限制与选型建议

仅支持图像编辑，不具备文生图能力，纯文本生成图像需选择同系列文生图线路。参考图限制为 1–3 张、单张不超过 10 MB，且不支持 SVG，多图复杂合成场景会受限。小字号文字的可读性受排版密度与语言影响，产出前应逐张校验。该模型较新，公开的独立评测有限，建议先用少量样例验证效果，再接入批量流程。

近期更新

查看更新日志 →

模型上新新模型上线：qwen-image-3.0-pro/text-to-image Oct 31, 2026
模型上新 qwen-image-3.0-pro 图生图模型上线 Oct 31, 2026
模型上新新增 qwen-image-3.0/text-to-image… Aug 20, 2026

常见问题

查看全部常见问题 →

Qwen Image 3.0 图片编辑支持多少张参考图？

支持 1 至 3 张参考图。至少需要一张，API 字段为 input.image_urls。
标准版与 Pro 图片编辑有什么区别？

标准版强调较低成本和快速迭代；Pro 更适合准确文字替换、复杂材质和最终版式。
1K、2K 和参考图如何计费？

1K 与 2K 使用同一输出档位，每张参考图另收附加费；具体金额以本页实时价格为准。
如何减少主体、版式或文字漂移？

在 Prompt 中分别列出要改变的内容和必须保留的主体、文字、位置、材质、机位与光线；需要准确文字时使用引号写出目标文本。

提交生成任务

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

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：qwen-image-3.0/image-to-image

routestring可选

当前固定值：default

inputobject必填

qwen-image-3.0/image-to-image 和线路 default 的业务参数对象，见下方参数表。

seedinteger可选min 0max 2147483647

随机种子，用于控制生成结果的随机性，取值形态为整数；相同种子配合相同其他参数可复现相近结果。

promptstring必填minLength 1maxLength 18000

正向提示词，用文本描述需要保留和改变的内容，取值形态为字符串。

image_urlsarray必填minItems 1maxItems 3

参考图 URL 数组，元素为图片链接字符串，1–3 张；支持 JPEG、PNG、WEBP、BMP、GIF、TIFF，每张不超过 10 MB，不支持 SVG。

Array [ string ]

resolutionstring可选默认值: "1K"

输出分辨率档位，取值形态为字符串，默认 1K。

可选项：1K2K

aspect_ratiostring可选默认值: "1:1"

输出画面的宽高比例，取值形态为字符串，默认 1:1。

可选项：1:13:22:34:33:416:99:1621:9

output_formatstring可选默认值: "png"

生成图片的文件格式，取值形态为字符串，默认 png。

可选项：pngjpeg

prompt_extendboolean可选默认值: true

是否自动优化提示词，取值形态为布尔值，默认 true。

negative_promptstring可选默认值: ""maxLength 500

不希望出现在画面中的内容，取值形态为字符串，默认空字符串。

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-3.0/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "png",
    "prompt_extend": true,
    "negative_prompt": ""
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "qwen-image-3.0/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "1K",
      "aspect_ratio": "1:1",
      "output_format": "png",
      "prompt_extend": true,
      "negative_prompt": ""
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "qwen-image-3.0/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "1K",
          "aspect_ratio": "1:1",
          "output_format": "png",
          "prompt_extend": True,
          "negative_prompt": ""
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}