Qwen: Qwen Image 3

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

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

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

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

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

Оның мазмұны бай кескіндер жасау мүмкіндіктері өзара байланысты бірнеше бөлімі бар кескін алаңына немесе бірінің ішінде бірі орналасқан визуалды макетке лайық. Стильдік бөлшектерді қоспас бұрын тақырыптарды, нақты мәтінді, иерархияны және панельдер арасындағы байланысты дайындаңыз. Өнімдерді салыстыру тапсырмасында өнімнің негізгі көрінісін, белгіленетін сипаттарын және қосымша панельдерді оқу ретін көрсету пайдалы. Кадрлар жоспары үшін әр панельдегі нысанды, әрекетті және жазуды бөлек сипаттаңыз. Промптқа ұсынылатын ең үлкен көлем — 4 500 токен; бұл орынды кескінге шынымен қажет мазмұн мен макетке жұмсаңыз.

Модель егжей-тегжейлі текстураларды, демонстрацияда 10 пиксель өлшеміне дейін көрсетілген ұсақ мәтінді және бірнеше қаріп пен көркем стильді қолданып, 12 тілде тікелей мәтін бейнелеуді қолдайды. Бұл мүмкіндіктер фотосурет пен мәтіні көп макеттің бірін таңдауға мәжбүрлемей, шынайы нысанды ақпаратқа бай графикамен біріктіруге мүмкіндік береді. Кескінге түсірілетін сөздер мен сандарды дәл беріп, олардың тілін және орналасатын жерін көрсетіңіз. Жасалған интерфейсті визуалды макет ретінде қарастырыңыз: кескіндегі түймелер, диаграммалар мен белгілер қолданба әрекеттерін іске асырмайды.

Өңдеу арқылы мәтінді өзгертуге, нысандарды қосуға немесе жоюға, элементтерді жылжытуға, нысанның әрекетін түзетуге, стильді көшіруге немесе зақымдалған кескіннің бөлшектерін жақсартуға болады. Бірден үшке дейін кескін мен бір анық өңдеу нұсқауын беріңіз. Кескіндер берілген ретімен нөмірленеді, сондықтан қай кескін нысанды, қайсысы киімді немесе затты, ал қайсысы ортаны беретінін көрсетіңіз. Өнім көрінісі үшін 1-кескіндегі затты 2-кескіндегі ортаға орналастырып, өнімді өзгелерден ажырататын сипаттарын сақтауды сұраңыз. Өзгертілетін және сақталатын нәрселерді нақты жазыңыз.

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

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

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

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

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

qwen/qwen-image-3

Alibaba /qwen/qwen-image-3

Бастау

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

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

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

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

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер qwen/qwen-image-3	Әдепкі—
Өріс`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.06 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

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', '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

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

/v1/images

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

qwen/qwen-image-3

FAQ · Qwen: Qwen Image 3

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

Qwen: Qwen Image 3

Qwen: Qwen Image 3

Бастау

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

Тарифтер

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

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

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

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

Ailoot Ultra · Суреттер

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

Ailoot Ultra · Суреттер

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

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

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

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

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

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

Компания және оның жобалар портфелі

Токенді жеңілдікпен сатып алыңыз.

API-ді сататын өніміңізге қосыңыз.