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 圖片編輯