Qwen: Qwen Image 3 Pro

Qwen-Image-3.0 Pro — күрделі орналасуларға, шынайы бөлшектерге және көптілді мәтінге арналған Qwen жетекші сурет жасау және өңдеу моделі. Графика, өнім көрінісі немесе нақты визуалды өңдеу жасау үшін дәл тапсырманы не бірден үшке дейін үлгі суретті пайдаланыңыз.

Ailoot Ultra · Суреттер POST /v1/images/generations qwen/qwen-image-3-pro

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

Qwen-Image-3.0 Pro — Qwen үшінші буынның жетекші сурет жасау және өңдеу моделі. Ол күрделі орналасулар жасауды, егжей-тегжейлі шынайы текстураларды, көптілді типографияны және сурет тапсырмасын дәл орындауды біріктіреді. Pro және стандартты Qwen-Image-3.0 құжатталған жасау және өңдеу режимдерін бірге қолдайды; Pro сурет сапасына мән береді, ал стандартты нұсқа сапа мен жылдамдықты теңестіреді. Нәтиже — рендерленген сурет файлы.

Ақпаратқа бай графика үшін сыртқы көріністен бұрын мазмұнды анықтаңыз: тақырып, қосымша мәтін, сандар, иерархия және бөлімдер арасындағы байланыс. Пайдалы өнім тапсырмасы бір кенепте негізгі нысанды, жақыннан көрсетілген материал бөлшектерін және белгіленген ерекшеліктерді біріктіре алады. Оқу иллюстрациясы үшін бастапқы деректерді модель өзі ойлап табады деп күтпей, ұғымды, сызба құрылымын және нақты жазуларды көрсетіңіз. Күрделі орналасулар бірнеше панельді немесе ішкі интерфейстерді де көрсете алады. Ұсынылған 4 500 токендік промпт шегін не көрсетілуі тиіс және қайда орналасатыны туралы ақпаратқа бағыттаңыз.

3.0 тобы 12 тілдегі төл типографияны, бірнеше қаріпті және 100-ден астам көркемдік стильді, сондай-ақ шаш, тері немесе мата сияқты нәзік текстураларды қолдайды. Ұсақ мәтінді көрсету 10 пиксельге дейінгі өлшемде көрсетілген. Бұл әріптерді физикалық материалмен ұштастыратын немесе мәтінді шынайы суретпен біріктіретін дизайн жасауға көмектеседі. Дәл сөздерді, сандарды және тілді беріп, әр блоктың типографиялық рөлін сипаттаңыз. Газет беті немесе интерфейс макеті бәрібір сурет болып қалады, сондықтан кейінгі өңделетін орналасу немесе интерактивті мінез-құлық одан бөлек жасалатын нәтиже.

Pro сурет ішіндегі мәтінді өңдей алады, элементтерді қоса, жоя немесе жылжыта алады, нысанның әрекетін өзгерте алады, визуалды стильді көшіріп, бөлшектерді жақсарта алады. Өңдеу бірден үшке дейін кіріс суретті нұсқаумен бірге қабылдайды. Олардың реті тапсырмадағы image 1, image 2 және image 3 белгілерін анықтайды. Қай үлгі нысанның сәйкестігін беретінін, қайсысы нысан не киім беретінін, қайсысы орта немесе қалып беретінін көрсетіңіз. Нақты өңдеу қажетті өзгерісті де, сақталуы тиіс ерекшеліктерді де атайды, бұл алынған суретті үлгілермен салыстыруды жеңілдетеді.

Қолдау көрсетілетін кіріс пішімдері — JPG, JPEG, PNG, BMP, TIFF, WebP және GIF; анимациялық GIF үшін тек бірінші кадр пайдаланылады. Әр кіріс сурет 10 MB-қа дейін болуы мүмкін. Нақты API қабырғаларды 1-ден 8 000 пиксельге дейін және ұзын қабырғаның қысқа қабырғаға қатынасын 10:1-ден аспайтын түрде қабылдайды; ұсынылған диапазон 384–2 048 пиксель. Өңдеу нұсқаулығы бөлек 3 072 пиксельге дейінгі суреттерді ұсынады, сондықтан кірісті таңдауды әр ажыратымдылық нәтижені жақсартады деген уәде емес, қажетті бөлшекке дайындық ретінде қарастырыңыз. Ұсақ мәтін немесе материал ерекшеліктері үшін анық әрі дұрыс жақтауланған үлгіні пайдаланыңыз.

Шығыстар PNG пішімінде. Өндірушінің үдерісі бірден алтыға дейін балама береді, әдепкіде біреуін қайтарады және жалпы пиксель ауданын 512 × 512-ден 2 048 × 2 048-ге дейін, жақтар арақатынасын 1:8-ден 8:1-ге дейін қолдайды. Пиксель ауданының көлемі ұзын қабырғасы 2 048 пиксельден асатын кейбір шаршы емес өлшемдерге мүмкіндік береді. Өлшем берілмесе, модель тапсырмаға сүйеніп ажыратымдылық ұсынады. Нақты орналастыруға сәйкес пішінді таңдап, жасалған баламаларды мазмұн толықтығы, нысан бөлшектері және көзделген көрсету өлшеміндегі типография бойынша салыстырыңыз.

Промптты интеллектуалды қайта жазу әдепкіде қосылған. Тікелей жақсарту жасауға да, өңдеуге де қолжетімді, ал агенттік жақсарту мәтіннен сурет жасау промпттарын жетілдіреді және суреттен сурет өңдеуге қолданылмайды. Thinking режимі де әдепкіде қосылған және промптты қайта жазуды қажет етеді; ол пайымдау жұмысын және генерация уақытын қосады. Теріс промпттар қажетсіз элементтерді анықтайды, ал қосымша seed нұсқалар арасындағы салыстыруды біріздірек етуге көмектесе алады. Анық оң тапсырма бәрібір нысанды, композицияны және сақталатын бөлшектерді белгілеуі тиіс.

Практикалық нәтижені тексеру қадамы дәл мәтінді, сандарды, оқу ретін, үлгіге сәйкестікті және дизайн үшін маңызды жиектер мен текстураларды қарайды. Белгілі бір бөлікке түзету қажет болса, сәтті композицияны сақтап, нақты өзгерісті сипаттаңыз. Таңдалған барлық суретті олардың промптымен және үлгілерімен бірге сақтаңыз, өйткені өндірушінің нәтиже орналасқан мекенжайлары 24 сағаттан кейін жарамдылығын жоғалтады. Pro нұсқасының құжатталған режимдері мен шектеулері 3.0 нұсқасына жатады; Qwen 2.1 үшін сипатталған он үлгі сурет пен мөлдірлікті тікелей қолдау мүмкіндіктері бөлек нұсқаның мүмкіндіктері.

Ailoot Ultra · Суреттер POST /v1/images/generations qwen/qwen-image-3-pro

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

Бастау

Қабылданатын кіріс деректері: Мәтін · Суреттер
Нәтижелер: Суреттер

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Суреттер POST /v1/images/generations

Кіріс: text, image
Шығыс: image

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер qwen/qwen-image-3-pro	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Ең аз ұзындық: 1	Әдепкі—
Өріс`resolution`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 1K, 2K	Әдепкі—
Өріс`aspect_ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9	Әдепкі—
Өріс`n`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 6	Әдепкі—
Өріс`input_references`	Түрі`array`	ТалапМіндетті емес	Мәндер мен шектеулер Элементтердің ең аз саны: 0 Элементтердің ең көп саны: 4	Әдепкі—
Өріс`provider`	Түрі`object`	ТалапМіндетті емес	Мәндер мен шектеулер	Әдепкі—

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыmodel, prompt
Параметр`material_types`	Параметр талаптарыtext, image

Өмірлік цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Нақты қайтарылған task_id немесе медиатека жазбасы

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифтер

Қорытынды төлем қалай есептеледі

Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим: Көрсетілмеген Жылдам режим таңдалғанда
Икемді режим: Көрсетілмеген flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Салыстыруға арналған болжамды мөлшерлемелер

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

Баптау	Мөлшерлемелер кестесі	Болжамды мөлшер	Есептеу бірлігі	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Болжамды мөлшер—	Есептеу бірлігі—	Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен
Баптаукіріс суреті	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Есептеу бірлігікіріс суреті үшін	Төлем Кіріс · кіріс кескін · Тек салыстыруға арналған бағалау $0.006 кіріс суреті үшін
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Есептеу бірлігі—	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.08 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · Суреттер

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'qwen/qwen-image-3-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Нәтижелерді алу және сақтау

Ailoot Ultra · Суреттер

Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Басқа мазмұнды оқу

Өзіңізге тиесілі қолда бар материалдарды оқу

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Барлық дайын нәтижені сақтау

Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.

Толық жауапты және тақырыптарды, алынған әрбір нәтижені, бастапқыда қайтарылған идентификаторларды және пайдалану туралы барлық өрістерді сақтаңыз. Жасау сұрауын қайта жібермей, бастапқы операцияны қалпына келтіріңіз.

Бастапқы жауапты тексеру қажет болса

Есептерді салыстырып тексеру үшін қайтарылған X-Client-Request-ID мәнін сақтаңыз. Тек нақты қайтарылған task_id/asset_id мәндері арқылы немесе өзіңізге тиесілі медиатекадан оқыңыз; операция ID мәнінен тапсырманың URL мекенжайын ешқашан құрастырмаңыз және жасау сұрауын ешқашан қайта жібермеңіз.

Жауап өрістері

Өріс	Түрі
Өріс`created`	Түрі
Өріс`data[].url`	Түрі
Өріс`data[].b64_json`	Түрі
Өріс`usage`	Түрі

Балама атаулар

Модельдердің балама атаулары

Ailoot Ultra qwen/qwen-image-3-pro

Әдіс жолдарының балама атаулары

/v1/images

Шақыруға арналған байланысты ID

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/images/generations · qwen/qwen-image-3-pro: text, image → image
Сұрау қандай өрістерді пайдаланады?: POST /v1/images/generations · qwen/qwen-image-3-pro: model, prompt, resolution, aspect_ratio, n, input_references, provider
Қандай шектеулер қолданылады?: POST /v1/images/generations · qwen/qwen-image-3-pro: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3 Pro