Generate or edit an image with Qwen Image 3.0

curl --request POST \
  --url https://api.magnific.com/v1/ai/text-to-image/qwen-image-3 \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "prompt": "A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene",
  "images": [
    "https://example.com/source.png"
  ],
  "aspect_ratio": "1:1",
  "negative_prompt": "blurry, low quality, watermark",
  "seed": 42,
  "webhook_url": "https://www.example.com/webhook"
}
'

import requests

url = "https://api.magnific.com/v1/ai/text-to-image/qwen-image-3"

payload = {
    "prompt": "A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene",
    "images": ["https://example.com/source.png"],
    "aspect_ratio": "1:1",
    "negative_prompt": "blurry, low quality, watermark",
    "seed": 42,
    "webhook_url": "https://www.example.com/webhook"
}
headers = {
    "x-magnific-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-magnific-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: 'A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene',
    images: ['https://example.com/source.png'],
    aspect_ratio: '1:1',
    negative_prompt: 'blurry, low quality, watermark',
    seed: 42,
    webhook_url: 'https://www.example.com/webhook'
  })
};

fetch('https://api.magnific.com/v1/ai/text-to-image/qwen-image-3', 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.magnific.com/v1/ai/text-to-image/qwen-image-3",
  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([
    'prompt' => 'A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene',
    'images' => [
        'https://example.com/source.png'
    ],
    'aspect_ratio' => '1:1',
    'negative_prompt' => 'blurry, low quality, watermark',
    'seed' => 42,
    'webhook_url' => 'https://www.example.com/webhook'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-magnific-api-key: <api-key>"
  ],
]);

$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.magnific.com/v1/ai/text-to-image/qwen-image-3"

	payload := strings.NewReader("{\n  \"prompt\": \"A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene\",\n  \"images\": [\n    \"https://example.com/source.png\"\n  ],\n  \"aspect_ratio\": \"1:1\",\n  \"negative_prompt\": \"blurry, low quality, watermark\",\n  \"seed\": 42,\n  \"webhook_url\": \"https://www.example.com/webhook\"\n}")

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

	req.Header.Add("x-magnific-api-key", "<api-key>")
	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.magnific.com/v1/ai/text-to-image/qwen-image-3")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene\",\n  \"images\": [\n    \"https://example.com/source.png\"\n  ],\n  \"aspect_ratio\": \"1:1\",\n  \"negative_prompt\": \"blurry, low quality, watermark\",\n  \"seed\": 42,\n  \"webhook_url\": \"https://www.example.com/webhook\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/text-to-image/qwen-image-3")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-magnific-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene\",\n  \"images\": [\n    \"https://example.com/source.png\"\n  ],\n  \"aspect_ratio\": \"1:1\",\n  \"negative_prompt\": \"blurry, low quality, watermark\",\n  \"seed\": 42,\n  \"webhook_url\": \"https://www.example.com/webhook\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "IN_PROGRESS"
  }
}

Qwen Image 3.0

Create Image

Generate an image with Qwen Image 3.0 from a text prompt, or edit up to 3 input images following the prompt.

Output: one image per request, delivered as a URL in the generated array of the task result.

Credits: a flat price per image. The parameters do not affect it.

The request is processed asynchronously: the endpoint returns a task_id immediately. Retrieve the result by polling GET /v1/ai/text-to-image/qwen-image-3/{task-id} or by providing an optional webhook_url.

POST

text-to-image

qwen-image-3

Generate or edit an image with Qwen Image 3.0

curl --request POST \
  --url https://api.magnific.com/v1/ai/text-to-image/qwen-image-3 \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "prompt": "A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene",
  "images": [
    "https://example.com/source.png"
  ],
  "aspect_ratio": "1:1",
  "negative_prompt": "blurry, low quality, watermark",
  "seed": 42,
  "webhook_url": "https://www.example.com/webhook"
}
'

import requests

url = "https://api.magnific.com/v1/ai/text-to-image/qwen-image-3"

payload = {
    "prompt": "A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene",
    "images": ["https://example.com/source.png"],
    "aspect_ratio": "1:1",
    "negative_prompt": "blurry, low quality, watermark",
    "seed": 42,
    "webhook_url": "https://www.example.com/webhook"
}
headers = {
    "x-magnific-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-magnific-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: 'A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene',
    images: ['https://example.com/source.png'],
    aspect_ratio: '1:1',
    negative_prompt: 'blurry, low quality, watermark',
    seed: 42,
    webhook_url: 'https://www.example.com/webhook'
  })
};

fetch('https://api.magnific.com/v1/ai/text-to-image/qwen-image-3', 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.magnific.com/v1/ai/text-to-image/qwen-image-3",
  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([
    'prompt' => 'A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene',
    'images' => [
        'https://example.com/source.png'
    ],
    'aspect_ratio' => '1:1',
    'negative_prompt' => 'blurry, low quality, watermark',
    'seed' => 42,
    'webhook_url' => 'https://www.example.com/webhook'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-magnific-api-key: <api-key>"
  ],
]);

$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.magnific.com/v1/ai/text-to-image/qwen-image-3"

	payload := strings.NewReader("{\n  \"prompt\": \"A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene\",\n  \"images\": [\n    \"https://example.com/source.png\"\n  ],\n  \"aspect_ratio\": \"1:1\",\n  \"negative_prompt\": \"blurry, low quality, watermark\",\n  \"seed\": 42,\n  \"webhook_url\": \"https://www.example.com/webhook\"\n}")

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

	req.Header.Add("x-magnific-api-key", "<api-key>")
	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.magnific.com/v1/ai/text-to-image/qwen-image-3")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene\",\n  \"images\": [\n    \"https://example.com/source.png\"\n  ],\n  \"aspect_ratio\": \"1:1\",\n  \"negative_prompt\": \"blurry, low quality, watermark\",\n  \"seed\": 42,\n  \"webhook_url\": \"https://www.example.com/webhook\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/text-to-image/qwen-image-3")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-magnific-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene\",\n  \"images\": [\n    \"https://example.com/source.png\"\n  ],\n  \"aspect_ratio\": \"1:1\",\n  \"negative_prompt\": \"blurry, low quality, watermark\",\n  \"seed\": 42,\n  \"webhook_url\": \"https://www.example.com/webhook\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "IN_PROGRESS"
  }
}

Authorizations

x-magnific-api-key

string

header

required

Your Magnific API key. Required for authentication. Learn how to obtain an API key

Body

application/json

A Qwen Image 3.0 request: generate an image from a text prompt, or edit one guided by up to three images.

The call is asynchronous: it returns a task_id, and the image arrives as a URL in the task's generated array. One image is generated per request.

prompt

string

required

Text description of the image to generate, or of the edit to apply. When images are sent, refer to them by position: "image 1" is the first one, "image 2" the second.

Required string length: 1 - 10000

Example:

"A vertical outdoor portrait photograph with the warm ambiance of an afternoon street scene"

images

string[]

Optional input images. Without them the request is text-to-image; with them the model edits or combines them following the prompt. Up to 3 images.

Each image is a public HTTPS URL, a base64-encoded string or an upload id (upl_...). At most 10 MB, ideally 384 to 2048 px per side.

Required array length: 1 - 3 elements

aspect_ratio

enum<string>

default:1:1

Aspect ratio of the generated image. 1:1 renders at 1024x1024.

Available options:

1:1,

16:9,

9:16,

4:3,

3:4,

3:2,

2:3,

1:2,

2:1,

4:5

Example:

"1:1"

negative_prompt

string

Content you do not want to appear in the image.

Maximum string length: 500

Example:

"blurry, low quality, watermark"

seed

integer

Seed for reproducible results. When omitted, a random seed is used.

Required range: 0 <= x <= 2147483647

Example:

42

webhook_url

string<uri>

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

Example:

"https://www.example.com/webhook"

Response

OK - The request has succeeded and the Qwen Image 3.0 process has started.

data

object

required

Show child attributes

Example:

{
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED",
  "generated": [
    "https://openapi-generator.tech",
    "https://openapi-generator.tech"
  ]
}

Get started

APIs

Create Image

Authorizations

Body

Response