Qwen Image
curl --request POST \
--url https://api.mixroute.ai/v1/images/generationsimport requests
url = "https://api.mixroute.ai/v1/images/generations"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.mixroute.ai/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mixroute.ai/v1/images/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.mixroute.ai/v1/images/generations"
req, _ := http.NewRequest("POST", url, nil)
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.mixroute.ai/v1/images/generations")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mixroute.ai/v1/images/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_body图像系列
Qwen Image
Qwen Image 图片生成字段、模型限制与请求示例。
Qwen Image
curl --request POST \
--url https://api.mixroute.ai/v1/images/generationsimport requests
url = "https://api.mixroute.ai/v1/images/generations"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.mixroute.ai/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mixroute.ai/v1/images/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.mixroute.ai/v1/images/generations"
req, _ := http.NewRequest("POST", url, nil)
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.mixroute.ai/v1/images/generations")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mixroute.ai/v1/images/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_body使用阿里云原生同步请求结构,通过 Qwen Image 生成图片。
POST https://api.mixroute.ai/v1/images/generations
input 和 parameters 均为 Qwen 原生字段。提示词放入 input.messages[].content[].text,不额外增加顶层 prompt。本页说明同步请求,不使用独立的异步 image-synthesis API。支持模型
| 模型 ID | 能力与限制 |
|---|---|
qwen-image-2.0-pro | 生成与编辑融合模型,最多六张输出,提示词上限 1300 Token。 |
qwen-image-2.0 | 生成与编辑融合模型,最多六张输出,提示词上限 1300 Token。 |
qwen-image-max | 仅文生图,固定一张输出,使用五种固定尺寸。 |
qwen-image-plus | 仅文生图,固定一张输出,使用五种固定尺寸。 |
qwen-image | 仅文生图,固定一张输出,使用五种固定尺寸。 |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型表中的完整 ID。 |
input | object | 是 | 原生输入对象。 |
input.messages | object[] | 是 | 有且只有一条消息,此接口为单轮调用。 |
input.messages[].role | string | 是 | 固定为 user。 |
input.messages[].content | object[] | 是 | 文生图时包含且仅包含一个文本项。 |
input.messages[].content[].text | string | 是 | 正向提示词。Qwen Image 2.0 上限为 1300 Token,其余模型为 800 Token,超出部分会截断;不要传入多个文本项。 |
parameters | object | 否 | 原生输出与提示词处理设置。 |
parameters.n | integer | 否 | 默认 1。Qwen Image 2.0 支持 1-6,qwen-image、Plus、Max 仅支持 1。 |
parameters.size | string | 否 | 输出尺寸格式为 宽*高,限制见下表,不是 OpenAI 的 宽x高 格式。 |
parameters.negative_prompt | string | 否 | 描述需排除的内容,支持中英文,最多 500 个字符,超出部分截断。 |
parameters.prompt_extend | boolean | 否 | 默认 true,改写正向提示词,不改变反向提示词。 |
parameters.watermark | boolean | 否 | 默认 false,true 时在右下角添加 Qwen-Image 水印。 |
parameters.seed | integer | 否 | 范围 0-2147483647,省略时使用随机种子;相同种子可提高一致性,但不保证输出完全相同。 |
尺寸规则
| 模型 | 输出尺寸 |
|---|---|
| Qwen Image 2.0 / Pro | 总像素 262144-4194304,默认 2048*2048。可使用 2688*1536、1536*2688、2368*1728、1728*2368 等尺寸;这是总像素限制,不是单边 2048 px 限制。 |
| Qwen Image / Plus / Max | 1664*928 (默认), 1472*1104, 1328*1328, 1104*1472, 928*1664 |
调用示例
将 MixRoute Key 设置到环境变量MIXROUTE_API_KEY,通过 Authorization: Bearer ... 认证。编辑图片前,将素材占位值替换为可访问的图片或本地文件。
curl --request POST "https://api.mixroute.ai/v1/images/generations" \
--header "Authorization: Bearer $MIXROUTE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "qwen-image-2.0-pro",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"text": "A clean product photograph of a red ceramic mug on a white background."
}
]
}
]
},
"parameters": {
"size": "1024*1024",
"n": 1,
"prompt_extend": true,
"watermark": false
}
}'
Python
import json
import os
import requests
payload = json.loads(r'''
{
"model": "qwen-image-2.0-pro",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"text": "A clean product photograph of a red ceramic mug on a white background."
}
]
}
]
},
"parameters": {
"size": "1024*1024",
"n": 1,
"prompt_extend": true,
"watermark": false
}
}
''')
response = requests.post(
"https://api.mixroute.ai/v1/images/generations",
headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]},
json=payload,
timeout=180,
)
response.raise_for_status()
result = response.json()
for choice in result.get("output", {}).get("choices", []):
for part in choice.get("message", {}).get("content", []):
if "image" in part:
print(part["image"])
响应
从output.choices[].message.content[].image 读取图片 URL,输出为 PNG,托管链接在 24 小时后过期。request_id 用于问题排查,不是视频任务轮询 ID;此响应不是 OpenAI 的 data[].b64_json 结构。
Qwen 图片编辑