curl --request POST \
--url https://api.goenhance.ai/api/v1/images/generations \
--header 'Content-Type: application/json' \
--data '
{
"model": "qwen-image-3-pro",
"prompt": "Replace her outfit with a tailored charcoal blazer, keep the face unchanged",
"ratio": "3:4",
"image_size": "2K",
"image_list": [
{
"url": "https://example.com/portrait.png"
}
]
}
'import requests
url = "https://api.goenhance.ai/api/v1/images/generations"
payload = {
"model": "qwen-image-3-pro",
"prompt": "Replace her outfit with a tailored charcoal blazer, keep the face unchanged",
"ratio": "3:4",
"image_size": "2K",
"image_list": [{ "url": "https://example.com/portrait.png" }]
}
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: 'qwen-image-3-pro',
prompt: 'Replace her outfit with a tailored charcoal blazer, keep the face unchanged',
ratio: '3:4',
image_size: '2K',
image_list: [{url: 'https://example.com/portrait.png'}]
})
};
fetch('https://api.goenhance.ai/api/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.goenhance.ai/api/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",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'qwen-image-3-pro',
'prompt' => 'Replace her outfit with a tailored charcoal blazer, keep the face unchanged',
'ratio' => '3:4',
'image_size' => '2K',
'image_list' => [
[
'url' => 'https://example.com/portrait.png'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.goenhance.ai/api/v1/images/generations"
payload := strings.NewReader("{\n \"model\": \"qwen-image-3-pro\",\n \"prompt\": \"Replace her outfit with a tailored charcoal blazer, keep the face unchanged\",\n \"ratio\": \"3:4\",\n \"image_size\": \"2K\",\n \"image_list\": [\n {\n \"url\": \"https://example.com/portrait.png\"\n }\n ]\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.goenhance.ai/api/v1/images/generations")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"qwen-image-3-pro\",\n \"prompt\": \"Replace her outfit with a tailored charcoal blazer, keep the face unchanged\",\n \"ratio\": \"3:4\",\n \"image_size\": \"2K\",\n \"image_list\": [\n {\n \"url\": \"https://example.com/portrait.png\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.goenhance.ai/api/v1/images/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"qwen-image-3-pro\",\n \"prompt\": \"Replace her outfit with a tailored charcoal blazer, keep the face unchanged\",\n \"ratio\": \"3:4\",\n \"image_size\": \"2K\",\n \"image_list\": [\n {\n \"url\": \"https://example.com/portrait.png\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": 0,
"msg": "Success",
"data": {
"img_uuid": "c12b656c-747a-44fd-9c80-add79b0c52d5",
"cost": 5.82
}
}Qwen-Image 3.0 Pro
Qwen-Image 3.0 Pro text-to-image and image editing in a single endpoint. Pass image_list to edit reference images (1-3), or omit it for pure text-to-image. Always returns a single image.
Pricing — output tier plus a surcharge per reference image:
| What | Tokens | USD |
|---|---|---|
| Output, 1K | 2.43 | $0.049 |
| Output, 2K | 4.85 | $0.097 |
| Each reference image | 0.19 | $0.0039 |
Example: 2K with 3 reference images = 4.85 + 3 x 0.19 = 5.42 tokens (= $0.1084).
image_size decides the price tier. Two cases are billed differently from what you send: ratio: auto is always billed at the 2K rate (the model picks the resolution, so it cannot be known up front), and 1:8 / 8:1 are always billed at the 1K rate (they cannot be produced above that tier).
For a cheaper flat rate use /api/v1/qwen-image-3, where both tiers cost 1.75 tokens (= $0.035).
Returns an img_uuid; poll GET /api/v1/jobs/detail (or use custom_callback_url) to get the generated image.
curl --request POST \
--url https://api.goenhance.ai/api/v1/images/generations \
--header 'Content-Type: application/json' \
--data '
{
"model": "qwen-image-3-pro",
"prompt": "Replace her outfit with a tailored charcoal blazer, keep the face unchanged",
"ratio": "3:4",
"image_size": "2K",
"image_list": [
{
"url": "https://example.com/portrait.png"
}
]
}
'import requests
url = "https://api.goenhance.ai/api/v1/images/generations"
payload = {
"model": "qwen-image-3-pro",
"prompt": "Replace her outfit with a tailored charcoal blazer, keep the face unchanged",
"ratio": "3:4",
"image_size": "2K",
"image_list": [{ "url": "https://example.com/portrait.png" }]
}
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: 'qwen-image-3-pro',
prompt: 'Replace her outfit with a tailored charcoal blazer, keep the face unchanged',
ratio: '3:4',
image_size: '2K',
image_list: [{url: 'https://example.com/portrait.png'}]
})
};
fetch('https://api.goenhance.ai/api/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.goenhance.ai/api/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",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'qwen-image-3-pro',
'prompt' => 'Replace her outfit with a tailored charcoal blazer, keep the face unchanged',
'ratio' => '3:4',
'image_size' => '2K',
'image_list' => [
[
'url' => 'https://example.com/portrait.png'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.goenhance.ai/api/v1/images/generations"
payload := strings.NewReader("{\n \"model\": \"qwen-image-3-pro\",\n \"prompt\": \"Replace her outfit with a tailored charcoal blazer, keep the face unchanged\",\n \"ratio\": \"3:4\",\n \"image_size\": \"2K\",\n \"image_list\": [\n {\n \"url\": \"https://example.com/portrait.png\"\n }\n ]\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.goenhance.ai/api/v1/images/generations")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"qwen-image-3-pro\",\n \"prompt\": \"Replace her outfit with a tailored charcoal blazer, keep the face unchanged\",\n \"ratio\": \"3:4\",\n \"image_size\": \"2K\",\n \"image_list\": [\n {\n \"url\": \"https://example.com/portrait.png\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.goenhance.ai/api/v1/images/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"qwen-image-3-pro\",\n \"prompt\": \"Replace her outfit with a tailored charcoal blazer, keep the face unchanged\",\n \"ratio\": \"3:4\",\n \"image_size\": \"2K\",\n \"image_list\": [\n {\n \"url\": \"https://example.com/portrait.png\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": 0,
"msg": "Success",
"data": {
"img_uuid": "c12b656c-747a-44fd-9c80-add79b0c52d5",
"cost": 5.82
}
}Headers
Body
Model name. Must be qwen-image-3-pro.
qwen-image-3-pro Text prompt describing the image.
1 - 2000Aspect ratio. Defaults to auto, which lets the model pick the resolution from the prompt. Note: 1:8 and 8:1 are only produced at the 1K tier.
auto, 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 1:2, 2:1, 1:4, 4:1, 1:8, 8:1 Output resolution tier, together with ratio it decides the exact pixel size. See the pricing note above — it also decides what you pay.
1K, 2K Optional reference images for image editing, [{"url": "https://..."}]. Up to 3 images, each under 10MB. The array order is the order the prompt refers to them in. Each one adds 0.19 tokens (= $0.0038).
1 - 3 elementsShow child attributes
Show child attributes
Optional. Describes what should not appear in the image.
2000Optional. Fixing the seed makes results more reproducible.
0 <= x <= 2147483647Prompt rewriting mode. agent rewrites more thoroughly but is text-to-image only — sending it together with image_list is rejected.
direct, agent Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.
"https://your-server.com/goenhance/callback"
