Qwen Image 3.0 编辑图片 API：生图修图最高 2K

Name: Qwen Image 3.0 API
SKU: alibaba/qwen-image-3.0/edit
Price: 0.05 USD
Availability: InStock

请求参数

参数	必填	说明
`aspect_ratio`	否	画面形状：横版、方形或竖版。 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 默认值: 1:1
`enable_prompt_expansion`	否	让模型给短提示词补充细节。默认值: true
`image_urls`	是	要编辑或合成的照片。在提示词里说明每张的作用。
`negative_prompt`	否	不想出现的东西。
`num_outputs`	否	一次生成几张。 ≥ 1 · ≤ 1 · 默认值: 1
`prompt`	是	Describe the subject, composition, lighting, and any text to render.
`resolution`	否	输出尺寸。越大越清晰，价格也越高。 1k · 2k · 默认值: 2k
`seed`	否	用同一个数字，结果就能复现。 ≥ 0 · ≤ 2147483647

价格

价格以积分计，和网站上用的是同一种积分（1 积分 = $0.01）。任务受理时先冻结积分，完成后按实际费用结算；失败的任务会退还。

选项	积分 /张	≈ 美元
标准	4.5	US$0.045

每个任务按整数积分向上取整，所以最低档跑一次是 5 积分/张（US$0.05）。

想在运行前知道确切金额，把同样的请求体发到 POST /jobs/quote 即可。

API 快速上手

三步调用 Qwen Image 3.0 API

创建 API 密钥. 登录 PopNow，在 API 控制台创建密钥。密钥以 sk-popnow- 开头，和网站共用同一份积分。
发送请求. 向 POST /jobs/createTask 发请求，model 填 alibaba/qwen-image-3.0/edit，input 按参数表填写。响应会立刻返回任务 ID。
取回结果. 用任务 ID 轮询 GET /jobs/recordInfo，或者传 callBackUrl，结果会推送到这个地址。任务成功后下载输出链接。

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/qwen-image-3.0/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "aspect_ratio": "1:1",
    "resolution": "2k",
    "num_outputs": 1
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

请把提示词和链接换成你自己的。API 页签里有响应、轮询和回调的参考。

Qwen Image 3.0 API 常见问题

Qwen Image 3.0 API 怎么收费？

Qwen Image 3.0：最便宜的任务是编辑图片，5 积分（US$0.05）/张起。积分和网站通用（1 积分 = $0.01），新账号赠送 30 积分，失败的任务会退还。

Qwen Image 3.0 在 API 里的调用名是什么？

在 POST /jobs/createTask 的 model 字段里填生成图片用 alibaba/qwen-image-3.0/text-to-image；编辑图片用 alibaba/qwen-image-3.0/edit。

Qwen Image 3.0 API 有哪些限制？

分辨率：1K · 2K；画面比例：1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +2；参考图：3；提示词长度（字符）：5,000；单个上传上限：10 MB。超出这些限制的请求会在扣费之前被拒绝。

不写代码能试 Qwen Image 3.0 吗？

可以。Playground 用你的 PopNow 积分运行 Qwen Image 3.0，不需要 API 密钥，每次运行都会给出对应的代码。

全部 Qwen Image 模型

Qwen Image 3.0 Pro 在多行排版和精细质感上的上限更高，适合终稿。

其他图片 API

关于 Qwen Image 3.0 的更多内容

试用: Qwen Image 3.0 AI 生图在线使用在 PopNow 用 Qwen Image 3.0 生成图片
文档: API 文档里的 Qwen Image 3.0 模型名与输入格式 PopNow API 快速上手：五分钟发出第一个请求 PopNow API 图片生成指南 Webhook：不轮询也能拿到 Qwen Image 3.0 的结果