Qwen Image 3 Text to Image

Unganisha

Kitambulisho cha modeli alibaba/qwen-image-3/text-to-image

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/alibaba/qwen-image-3/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cozy bookstore window at dusk with a hand-painted wooden sign that reads \"Moonlight Books · 月光书店\", stacks of books, warm string lights, light rain on the glass, photorealistic."
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/alibaba/qwen-image-3/text-to-image?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "A cozy bookstore window at dusk with a hand-painted wooden sign that reads \"Moonlight Books · 月光书店\", stacks of books, warm string lights, light rain on the glass, photorealistic."
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "prompt": "A cozy bookstore window at dusk with a hand-painted wooden sign that reads \"Moonlight Books · 月光书店\", stacks of books, warm string lights, light rain on the glass, photorealistic.",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/alibaba/qwen-image-3/text-to-image", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/sw/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "alibaba/qwen-image-3/text-to-image",
  "input": {
    "prompt": "A cozy bookstore window at dusk with a hand-painted wooden sign that reads \"Moonlight Books · 月光书店\", stacks of books, warm string lights, light rain on the glass, photorealistic."
  }
}

Piga modeli ya Qwen Image 3 Text to Image (alibaba/qwen-image-3/text-to-image) kupitia Doitong API. Nyaraka za mawakala: https://doitong.com/sw/developers/models/alibaba/qwen-image-3/text-to-image.md

POST https://api.doitong.ru/v1/run/alibaba/qwen-image-3/text-to-image?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "prompt": "A cozy bookstore window at dusk with a hand-painted wooden sign that reads \"Moonlight Books · 月光书店\", stacks of books, warm string lights, light rain on the glass, photorealistic."
}

Ikiwa hali ya jibu ni "queued" au "running", piga GET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20 mara kwa mara hadi iwe "succeeded"; faili ziko kwenye outputs[].url. POST https://api.doitong.ru/v1/quote/alibaba/qwen-image-3/text-to-image yenye mwili uleule hurejesha bei kamili kabla ya kuendesha.

Ombi hili: $ 0.04 salio za API 40 · ≈ ₽ 4.29 Iendeshe kwenye ukurasa huu

Pata ufunguo wa API

Alibaba Maandishi hadi Picha #typography#bilingual#budget

Modeli ya picha ya Alibaba yenye maandishi bora ya lugha mbili, katika 1K au 2K.

OpenAPI Markdown

Mifano

Tokeo · ~125 s

MaelekezoA cozy bookstore window at dusk with a hand-painted wooden sign that reads "Moonlight Books · 月光书店", stacks of books, warm string lights, light rain on the glass, photorealistic.

$ 0.04 · salio za API 40

Bei

Bei halisi

kuanzia $ 0.04 / picha

salio za API 40 / picha · ≈ ₽ 4.29

Ombi hili: picha 1 × $ 0.04 $ 0.04 salio za API 40 · ≈ ₽ 4.29

Endesha · $ 0.04

Hutozwa tu ikifanikiwa, na kurejeshewa kiotomatiki ikishindwa.

image_size chaguomsingi square_hd

num_outputs chaguomsingi 1

Bei kulingana na daraja

`image_size` = `square_hd`	$ 0.04 / picha
`image_size` = `square`	$ 0.04 / picha
`image_size` = `portrait_4_3`	$ 0.04 / picha
`image_size` = `portrait_16_9`	$ 0.04 / picha
`image_size` = `landscape_4_3`	$ 0.04 / picha
`image_size` = `landscape_16_9`	$ 0.04 / picha
kiwango cha msingi	$ 0.075 / picha

Kichwa kinaonyesha daraja la chini zaidi; nukuu huweka bei ya ingizo lako halisi.

Hutozwa kwa kila picha iliyozalishwa.

Muda wa kawaida: ~90 s
Endpoint ya makadirio: POST /quote/{id}

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

prompt •inahitajika 178 / 5000

Maandishi yanayoeleza picha ya kuunda, kwa Kichina au Kiingereza, yenye kikomo cha herufi 5000.

negative_prompt 0 / 500

Maudhui ya kuondoa kwenye picha inayotokana, yenye kikomo cha herufi 500.

image_size chaguomsingi square_hd

Weka vipimo vya tokeo ili jumla ya pikseli za picha iwe kati ya 512 × 512 na 2048 × 2048.

num_outputs num_images chaguomsingi 1

Idadi ya picha iliyoombwa kwa uzalishaji.

Ya kina output_format · seed · enable_prompt_expansion

output_format chaguomsingi png

Muundo wa faili wa picha inayotokana.

seed

Seed ya nasibu inayowezesha matokeo yanayoweza kurudiwa, kutoka 0 hadi 2147483647.

POST /run/alibaba/qwen-image-3/text-to-image?wait=20 makadirio → $ 0.04

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/alibaba/qwen-image-3/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cozy bookstore window at dusk with a hand-painted wooden sign that reads \"Moonlight Books · 月光书店\", stacks of books, warm string lights, light rain on the glass, photorealistic."
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/alibaba/qwen-image-3/text-to-image?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "A cozy bookstore window at dusk with a hand-painted wooden sign that reads \"Moonlight Books · 月光书店\", stacks of books, warm string lights, light rain on the glass, photorealistic."
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "prompt": "A cozy bookstore window at dusk with a hand-painted wooden sign that reads \"Moonlight Books · 月光书店\", stacks of books, warm string lights, light rain on the glass, photorealistic.",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/alibaba/qwen-image-3/text-to-image", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "alibaba/qwen-image-3/text-to-image",
      "input": {
        "prompt": "A cozy bookstore window at dusk with a hand-painted wooden sign that reads \"Moonlight Books · 月光书店\", stacks of books, warm string lights, light rain on the glass, photorealistic."
      },
      "wait_seconds": 20
    }
  }
}

Endesha ombi hili

Ufunguo wa API

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Kumbuka katika kivinjari hiki Pata ufunguo wa API

Kuhusu Qwen Image 3 Text to Image

Qwen Image 3 ni bora hasa katika kuweka maandishi ya Kiingereza na Kichina yanayosomeka ndani ya picha: mabango, lebo, slidi na meme. Inakubali kidokezo hasi, upanuzi wa kiotomatiki wa kidokezo na mbegu ya hiari, na hurenda kuanzia pikseli 512x512 hadi 2048x2048. Hadi picha sita kwa ombi katika PNG, JPEG au WebP.

Vigezo

Tuma jina rasmi au jina asilia, si yote mawili. Majina rasmi

JinaAina ChaguomsingiInaruhusiwa Maelezo

promptinahitajika

Ainastring

≤ herufi 5,000

Maandishi yanayoeleza picha ya kuunda, kwa Kichina au Kiingereza, yenye kikomo cha herufi 5000.

negative_promptsi lazima

Ainastring | null

Chaguomsingi

≤ herufi 500

Maudhui ya kuondoa kwenye picha inayotokana, yenye kikomo cha herufi 500.

image_sizesi lazima

Ainaobject

Chaguomsingisquare_hd

square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9

Weka vipimo vya tokeo ili jumla ya pikseli za picha iwe kati ya 512 × 512 na 2048 × 2048.

enable_prompt_expansionsi lazima

Ainaboolean

Chaguomsingitrue

Hudhibiti uandikaji upya wa kidokezo kiotomatiki na LLM ili kuboresha matokeo.

seedsi lazima

Ainainteger | null

Seed ya nasibu inayowezesha matokeo yanayoweza kurudiwa, kutoka 0 hadi 2147483647.

num_imagessi lazima num_outputs

Ainainteger

Chaguomsingi1

1 – 6

Idadi ya picha iliyoombwa kwa uzalishaji.

output_formatsi lazima

Ainaenum

Chaguomsingipng

jpegpngwebp

Muundo wa faili wa picha inayotokana.

inahitajika Jina rasmi, pia linakubalika

Tokeo

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "alibaba/qwen-image-3/text-to-image",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 40,
    "usd": "0.04",
    "charged": 40,
    "refunded": 0
  },
  "input": {
    "prompt": "A cute baby koala on a water slide holding a card that says \"Summer starts now\", bright afternoon light",
    "negative_prompt": "low resolution, blurry, deformed",
    "image_size": "square_hd"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    ],
    "seed": 42
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}

Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.

Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.

Sehemu za tokeo

images: array of object {url, content_type, file_name, file_size}Picha zilizozalishwa.
seed: integerThamani ya seed inayotumika wakati wa uzalishaji.