Qwen Image 系列

POST

tasks

Qwen Image 系列

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "image_urls": [
    "<string>"
  ],
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "n": 123,
  "negative_prompt": "<string>",
  "prompt_extend": true,
  "prompt_extend_mode": "<string>"
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "image_urls": ["<string>"],
    "aspect_ratio": "<string>",
    "resolution": "<string>",
    "n": 123,
    "negative_prompt": "<string>",
    "prompt_extend": True,
    "prompt_extend_mode": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    image_urls: ['<string>'],
    aspect_ratio: '<string>',
    resolution: '<string>',
    n: 123,
    negative_prompt: '<string>',
    prompt_extend: true,
    prompt_extend_mode: '<string>'
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"n\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"prompt_extend\": true,\n  \"prompt_extend_mode\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"n\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"prompt_extend\": true,\n  \"prompt_extend_mode\": \"<string>\"\n}")
  .asString();

Qwen Image 是阿里巴巴 Qwen 团队的图像基础模型系列，把文生图和图像编辑统一在同一套接口里，强项是中英双语排版、信息图和海报里的文字渲染。本页覆盖当前可用的四个模型，分成两代，每次请求都可出 1 至 6 张：2.0 一代按单一张价结算；3.0 一代支持多图参考与提示词扩写，参考图另行计费。

快速开始

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: qwen-image-demo-001" \
  -d '{
    "model": "qwen-image-3.0",
    "action": "generate",
    "prompt": "咖啡馆菜单海报，中英双语，标题用衬线体，正文分两栏",
    "aspect_ratio": "3:4",
    "resolution": "2k",
    "n": 1
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: qwen-image-edit-001" \
  -d '{
    "model": "qwen-image-3.0-pro",
    "action": "edit",
    "prompt": "把第一张的商品放进第二张的展台，光线统一",
    "image_urls": [
      "https://cdn.example.com/product.png",
      "https://cdn.example.com/scene.png"
    ],
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-2.0",
    "action": "generate",
    "prompt": "扁平插画风格的城市天际线，四种配色变体",
    "negative_prompt": "文字, 水印",
    "aspect_ratio": "16:9",
    "resolution": "2k",
    "n": 4
  }'

提交成功后返回 task_id。用 GET /v1/tasks/{task_id} 查询结果，也可以用 Prefer: wait 在一次调用里等待，或配置 Webhook。

请求参数

string

必填

四选一：qwen-image-2.0、qwen-image-2.0-pro、qwen-image-3.0 或 qwen-image-3.0-pro。

string

默认值:"generate"

generate：根据文字生成图片
edit：基于参考图改写；需要提供 image_urls

string

必填

图片描述或编辑指令，中英文均可。

string[]

参考图片 URL 数组。qwen-image-2.0 与 qwen-image-2.0-pro 在 edit 时至少需要 1 张。qwen-image-3.0 与 qwen-image-3.0-pro 在 edit 时需要 1 至 3 张，generate 不接受参考图。

string

画面比例：1:1、16:9、9:16、4:3、3:4、3:2、2:3。qwen-image-3.0 与 qwen-image-3.0-pro 不传时为 1:1。

string

输出分辨率，1k 或 2k。qwen-image-3.0 与 qwen-image-3.0-pro 不传时为 1k。

integer

默认值:"1"

生成数量，四个模型都取 1–6。

string

不希望出现在结果中的内容，最多 500 字符。

boolean

默认值:"false"

让模型扩写提示词，默认关闭。只有 qwen-image-3.0 与 qwen-image-3.0-pro 支持。

string

提示词扩写模式，direct 或 agent。只有 qwen-image-3.0 与 qwen-image-3.0-pro 支持，且必须同时设置 prompt_extend: true；edit 只接受 direct。

通用的 callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。本系列不接受 seed、quality、watermark 和 mask_url。以上之外的参数会返回 400，不计费。

限制

条件	限制
`qwen-image-2.0` / `qwen-image-2.0-pro`	一次最多出 6 张
`action: "edit"`（2.0 两档）	图片编辑需要至少 1 张参考图
`qwen-image-3.0` / `qwen-image-3.0-pro`	提示词必填，每次请求可生成 1 至 6 张图。
`action: "generate"`（3.0 两档）	文生图不接收参考图，请改用 `edit`
`action: "edit"`（3.0 两档）	图片编辑需要 1 至 3 张参考图
`prompt_extend_mode`	只有 `prompt_extend=true` 时才能设置
`prompt_extend_mode` 在 `edit` 下	图片编辑的 `prompt_extend_mode` 只支持 `direct`

计费

按成功出图的固定张价结算。单价见 GET /v1/models 返回的 price_config，或控制台「模型市场」。单次调用的实际花费见任务响应里的 cost——整数 quota，500,000 quota = 1 USD，不是美元。计费维度按代次不同：

qwen-image-2.0 / qwen-image-2.0-pro：单一张价，1k 与 2k 同价，画幅与提示词长度都不影响价格；总价 = 张价 × n。
qwen-image-3.0：1k 与 2k 同价；输出部分 = 张价 × n。
qwen-image-3.0-pro：2k 比 1k 贵一档；输出部分 = 张价 × n。
3.0 两档的参考图另计：本次请求带的每张参考图按张各计一笔，每次请求只计一次、不随 n 重复，加在输出图的价格上；generate 没有参考图，不产生这笔费用。

resolution 不在该模型支持的档位内时，按其兜底价结算（等于该模型的基础档价）。只有成功出图才计费。任务失败、取消，或没有返回可用图片时，全额退款。

响应

任务完成

{
  "task_id": "task-wave1789004688b950049238",
  "model": "qwen-image-3.0",
  "action": "edit",
  "status": "completed",
  "progress": "100%",
  "created_at": 1788754231,
  "completed_at": 1788754266,
  "result": {
    "images": [
      {
        "expires_at": 1789089508,
        "url": ["https://cdn.example.com/result.png"]
      }
    ]
  },
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1789004688b950049238",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1789004688b950049238/cancel"
  },
  "billing_status": "settled",
  "cost": 12377
}

result.images 返回生成的图片，expires_at 是该链接的失效时间戳。n 大于 1 时 images 数组里有多个元素。完整字段说明见查询任务状态。

可用模型

模型 ID	分辨率	`n`	参考图	专有参数
`qwen-image-2.0`	`1k` `2k`（同价）	1–6	`edit` 时提供	`negative_prompt`
`qwen-image-2.0-pro`	`1k` `2k`（同价）	1–6	`edit` 时提供	`negative_prompt`
`qwen-image-3.0`	`1k` `2k`（同价）	1–6	1–3 张，另计费	`negative_prompt` `prompt_extend` `prompt_extend_mode`
`qwen-image-3.0-pro`	`1k` `2k`（`2k` 更贵）	1–6	1–3 张，另计费	`negative_prompt` `prompt_extend` `prompt_extend_mode`

四个模型都支持 generate 与 edit，画幅集合相同：1:1、16:9、9:16、4:3、3:4、3:2、2:3。

相关文档

Qwen Image 系列

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "image_urls": [
    "<string>"
  ],
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "n": 123,
  "negative_prompt": "<string>",
  "prompt_extend": true,
  "prompt_extend_mode": "<string>"
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "image_urls": ["<string>"],
    "aspect_ratio": "<string>",
    "resolution": "<string>",
    "n": 123,
    "negative_prompt": "<string>",
    "prompt_extend": True,
    "prompt_extend_mode": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    image_urls: ['<string>'],
    aspect_ratio: '<string>',
    resolution: '<string>',
    n: 123,
    negative_prompt: '<string>',
    prompt_extend: true,
    prompt_extend_mode: '<string>'
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"n\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"prompt_extend\": true,\n  \"prompt_extend_mode\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"n\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"prompt_extend\": true,\n  \"prompt_extend_mode\": \"<string>\"\n}")
  .asString();

文本生成

图像生成

视频生成

音频处理

工具与嵌入

任务管理

账户与用量

快速开始

请求参数

限制

计费

响应

可用模型

相关文档

​快速开始

​请求参数

​限制

​计费

​响应

​可用模型

​相关文档

快速开始

请求参数

限制

计费

响应

可用模型

相关文档