Qwen Image 图片 API

使用官方分组 API Key。Qwen Image 是图片模型，与使用 Chat Completions 的 Qwen 对话模型分开调用。

支持的协议

使用 JSON POST /v1/images/generations 生成图片，使用 POST /v1/images/edits（multipart/form-data）上传文件编辑。提交返回 202 Accepted 和任务 id，之后轮询 GET /v1/tasks/{id}，直到 completed 或 failed。202 不表示已经出图。

本系列使用 Images + 异步任务，不支持通过 /v1/chat/completions 或 /v1/responses 生成图片。完整示例见提交并轮询。

模型与参数

resolution 缺省为 1K，n 缺省为 1。size 使用 1:1、4:3、3:4、16:9、9:16、3:2 或 2:3。2.0 的提示词最多 800 字符，3.0 最多 4000 字符。示例可替换为表中任一模型 ID，参考图数量仍须符合对应上限。

生成图片

先将 APIPOOL_API_KEY 设置为自己的 Key，再运行示例：

APIPOOL_ENDPOINT="https://app.apipool.dev"

curl "$APIPOOL_ENDPOINT/v1/images/generations" \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3.0",
    "prompt": "A blue ceramic cup on a white table",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
}'

编辑图片

上传本地 PNG、JPEG 或 WebP 文件；把 source.png 换成实际文件路径：

curl "https://app.apipool.dev/v1/images/edits" \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -F "model=qwen-image-3.0" \
  -F "prompt=Change the cup to green" \
  -F "image=@./source.png" \
  -F "size=1:1" \
  -F "resolution=1K" \
  -F "n=1"

多张参考图可重复 -F "image=@./second.png"，不得超过模型上限。 已有可公开下载的参考图时，也可在同一个 JSON 生成接口中传 image_urls：

{
  "model": "qwen-image-3.0",
  "prompt": "Change the cup to green",
  "size": "1:1",
  "resolution": "1K",
  "n": 1,
  "image_urls": ["https://your-cdn.example/source.png"]
}

把示例 URL 换成服务端可访问的真实地址。临时隧道失效、DNS 解析失败或下载超时 会导致任务失败；不要使用仅自己的浏览器可访问的本机或登录态地址。

查询与获取结果

保存提交响应中的 id（例如 imgtask_01...），使用提交时同一个 Key 查询：

TASK_ID="imgtask_01..."
curl "https://app.apipool.dev/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $APIPOOL_API_KEY"

submitted、submission_unknown、processing、meter_pending 时继续查询； completed 时读取 data[].url 并在有效期内下载；failed 时读取 error。 不要因为尚未完成就重复提交。完整状态、超时处理和可运行轮询示例见 图片异步任务。

范围与计费

请求使用 prompt 和可选参考图，不使用 Chat 的 messages 或 Responses 的 input。图片任务不支持 stream: true。

以模型与价格为准。3.0 / 3.0 Pro 的参考图逐张计费，提交前核对所选模型的参考图费率。