modely

Qwen: Qwen Image 3

Markdown · JSON

Qwen: Qwen Image 3

Qwen-Image-3.0 spojuje generování a úpravy obrázků pro rozvržení bohatá na informace, detailní scény a vícejazyčnou typografii. Standardní edice vyvažuje kvalitu a rychlost a přijímá textové zadání nebo až tři obrázky s pokynem k úpravě.

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

Qwen-Image-3.0 je třetí generace obrazového modelu Qwen, která v jednom modelu spojuje tvorbu obrázků z textu a úpravy podle referencí. Standardní edice vyvažuje kvalitu obrazu a rychlost odezvy, zatímco Qwen-Image-3.0 Pro je příbuznou vlajkovou edicí zaměřenou na kvalitu. Výsledkem požadavku je obrázek: plakát, ilustrované vysvětlení, produktová scéna, storyboard nebo upravená fotografie, nikoli upravitelný dokument či funkční rozhraní.

Jeho schopnosti vytvářet bohatý obsah se hodí pro plátno s několika souvisejícími oddíly nebo vnořeným vizuálním rozvržením. Než přidáte stylistické podrobnosti, připravte nadpisy, přesné znění, hierarchii a vztahy mezi jednotlivými panely. Pro srovnání produktů je užitečné zadání, které určí hlavní pohled na produkt, vlastnosti k označení a pořadí čtení doplňujících panelů. U storyboardu popište zvlášť námět, děj a popisek každého panelu. Doporučená maximální délka promptu je 4 500 tokenů; tento prostor využijte pro obsah a rozvržení, které obrázek skutečně potřebuje.

Model podporuje detailní textury, typografii až po drobný text předvedený při velikosti 10 pixelů a nativní vykreslování ve 12 jazycích s různými písmy a uměleckými styly. Tyto schopnosti umožňují spojit realistický objekt s grafikou bohatou na informace místo nutnosti volit mezi fotografií a rozvržením s velkým množstvím textu. Zadejte přesná slova a číslice, které se mají zobrazit, jejich jazyk a umístění. Vygenerované rozhraní berte jako vizuální návrh: tlačítka, grafy a popisky v obrázku neimplementují chování aplikace.

Úpravy mohou měnit text, přidávat či odstraňovat objekty, přesouvat prvky, upravovat činnost zobrazeného subjektu, přenášet styl nebo vylepšovat detaily poškozeného obrázku. Poskytněte jeden až tři obrázky a jeden jasný pokyn k úpravě. Číslování obrázků odpovídá pořadí, v němž je dodáte; určete tedy, který obrázek poskytuje subjekt, který oděv nebo objekt a který prostředí. U produktové scény požádejte o umístění objektu z obrázku 1 do prostředí z obrázku 2 při zachování znaků, které produkt odlišují. Výslovně uveďte požadované změny i to, co má zůstat zachováno.

Tento konkrétní postup pro vstupní obrázky přijímá JPG, JPEG, PNG, BMP, TIFF, WebP a GIF; u animovaného GIF se zpracovává pouze první snímek. Každý obrázek může mít až 10 MB. Aktuální API přijímá rozměry od 1 do 8 000 pixelů s poměrem delší a kratší strany nejvýše 10:1 a pro dobré výsledky doporučuje 384–2 048 pixelů. Vyberte vstup, na němž jsou jasně vidět detaily, které se mají přenést nebo upravit. Příliš těsný ořez reference může skrýt okolní strukturu potřebnou k přirozenému umístění objektu.

Výstup je ve formátu PNG, s jedním až šesti obrázky na požadavek a výchozím počtem jeden. Plocha výstupu v pixelech se pohybuje od 512 × 512 do 2 048 × 2 048, s poměrem stran od 1:8 do 8:1; jde o limity plochy, nikoli o pravidlo, že každá strana smí mít nejvýše 2 048 pixelů. Pokud velikost nezadáte, model doporučí rozlišení podle promptu. Zvolte kompozici na šířku, čtvercovou nebo na výšku podle zamýšleného použití a poté vrácený obrázek prohlédněte v této skutečné velikosti, abyste mohli posoudit drobné popisky a jemné detaily tam, kde se budou zobrazovat.

Přepisování promptu je v postupu výrobce ve výchozím nastavení zapnuto. Přímé vylepšení funguje pro generování i úpravy; vylepšení pomocí agenta je propracovanější režim přepisování určený pouze pro tvorbu obrázku z textu a při úpravách obrázku podle obrázku je odmítnuto. Uvažování je ve výchozím nastavení zapnuto, vyžaduje přepisování promptu a prodlužuje dobu generování. Negativní prompty mohou popsat nežádoucí prvky, zatímco pevný seed pomáhá porovnávat varianty. Výslovně uveďte vyloučené prvky a přesné požadavky na zachování místo očekávání, že seed při měnícím se zadání zajistí totožný obrázek.

Pro užitečný výsledný výstup zkontrolujte vykreslená slova, jednotky, pořadí panelů a detaily, podle nichž lze subjekt poznat, a poté opravte konkrétní část, která zadání nesplnila. Odpověď s více obrázky nabízí alternativy k porovnání; u každého vráceného obrázku uchovejte spojení s promptem a referencemi, z nichž vznikl. Umístění obrázků u výrobce přestávají platit po 24 hodinách, proto uchovejte samotný obrazový soubor, jakmile se výsledek stane součástí projektu. Standardní edice 3.0 zůstává odlišná od Pro i od modelů Qwen 2.1, které mají jiné počty referencí a funkce průhlednosti.

Ailoot Ultra · Obrázky POST /v1/images/generations qwen/qwen-image-3

qwen/qwen-image-3

Alibaba /qwen/qwen-image-3

Úvod

Qwen-Image-3.0 spojuje generování a úpravy obrázků pro rozvržení bohatá na informace, detailní scény a vícejazyčnou typografii. Standardní edice vyvažuje kvalitu a rychlost a přijímá textové zadání nebo až tři obrázky s pokynem k úpravě.

Přijímané vstupy
Text · Obrázky
Výsledky
Obrázky

Dostupné v Ailoot · vstupy a metody

Ailoot Ultra · Obrázky POST /v1/images/generations
Vstup
text, image
Výstup
image
PoleTypPožadavekHodnoty a limityVýchozí
PolemodelTypstringPožadavekPovinnéHodnoty a limity
qwen/qwen-image-3
Výchozí—
PolepromptTypstringPožadavekPovinnéHodnoty a limity
Minimální délka: 1
Výchozí—
PoleresolutionTypstringPožadavekVolitelnéHodnoty a limity
1K, 2K
Výchozí—
Poleaspect_ratioTypstringPožadavekVolitelnéHodnoty a limity
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
Výchozí—
PolenTypintegerPožadavekVolitelnéHodnoty a limity
Minimum: 1
Maximum: 6
Výchozí—
Poleinput_referencesTyparrayPožadavekVolitelnéHodnoty a limity
Minimální počet položek: 0
Maximální počet položek: 4
Výchozí—
PoleproviderTypobjectPožadavekVolitelnéHodnoty a limityVýchozí—
Parametry a životní cyklus metody
ParametrKontrakt
Parametrcontent_typeKontraktapplication/json
ParametrrequiredKontraktmodel, prompt
Parametrmaterial_typesKontrakttext, image

Životní cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutečně vrácené task_id nebo záznam v knihovně médií

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim
Neuvedeno Při výběru rychlého režimu
Režim flex
Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování
Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

KonfiguraceTabulka sazebPředpokládané množstvíÚčtovací jednotkaPoplatek
KonfiguraceZákladní sazby za tokenyTabulka sazebZákladní sazbaPředpokládané množství—Účtovací jednotka—Poplatek
Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů
Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů
Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů
Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů
Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
Konfiguracevstupní obrázekTabulka sazeb—Předpokládané množství—Účtovací jednotkaza vstupní obrázekPoplatek
Vstup · vstupní obrázek · Odhad pouze pro srovnání $0.006 za vstupní obrázek
KonfiguraceOdhadovaná cena generováníTabulka sazeb—Předpokládané množstvíodhad pro jedno generováníÚčtovací jednotka—Poplatek
Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.06 odhad před generováním

Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Příklady požadavků

Ailoot Ultra · Obrázky

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

Přijímání a ukládání výsledků

Ailoot Ultra · Obrázky

Stáhněte každý vrácený obrázek nebo uložte jeho obsah Base64

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Další načtení obsahu
Načíst existující soubory, které vám patří
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.
Uchovejte všechny dokončené výsledky

Uložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte obsah Base64.

Uchovejte úplnou odpověď a hlavičky, všechny skutečné výstupy, původní vrácené identifikátory a všechna pole s údaji o využití. Obnovte původní operaci bez opětovného odeslání požadavku na vytvoření.

Pokud je nutné ověřit původní odpověď

Uchovejte vrácené X-Client-Request-ID pro spárování záznamů. Načítejte pouze skutečně vrácené hodnoty task_id/asset_id nebo vlastní knihovnu médií; nikdy nevytvářejte URL úlohy z ID operace a nikdy znovu neodesílejte požadavek na vytvoření.

Pole odpovědi
PoleTyp
PolecreatedTyp
Poledata[].urlTyp
Poledata[].b64_jsonTyp
PoleusageTyp

Aliasy

Aliasy modelu

Ailoot Ultra qwen/qwen-image-3

Aliasy cest metod

/v1/images

Související ID modelů

qwen/qwen-image-3

FAQ · Qwen: Qwen Image 3
Jaké vstupy a výsledky jsou dostupné?

POST /v1/images/generations · qwen/qwen-image-3: text, image → image

Jaká pole požadavek používá?

POST /v1/images/generations · qwen/qwen-image-3: model, prompt, resolution, aspect_ratio, n, input_references, provider

Jaké limity platí?

POST /v1/images/generations · qwen/qwen-image-3: n.minimum: 1; n.maximum: 6

Další podrobnosti

Připojte Ailoot k Claude Code, OpenCode, Hermes nebo vlastní aplikaci.

Společnost a její portfolio projektů

Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.

Nakupujte tokeny se slevou.

Sleva předplatného pro pravidelnou práci. Promo kódy až 50% na nákup tokenů.

Předplatné
Pro pravidelné požadavky vyberte tarif se slevou.
Promo kód až 50%
Při nákupu zadejte kód. Cena se přepočítá podle probíhající akce.
Výdaje v historii
U každého požadavku se uloží model, tokeny a částka.

Vybrat předplatné · Zobrazit ceny modelů

Připojte API k produktu, který prodáváte.

SaaS, aplikace a boti podle nabídky a licenční smlouvy Ailoot. Pro přeprodej požádejte o licenci přeprodejce.

Komerční aplikace
Začleňte generování textu, obrázků, videa a zvuku do placených funkcí své služby.
Licence pro přeprodejce
Pošlete popis projektu a způsob poskytování přístupu. Vyžádejte písemné podmínky použití a přeprodeje.
Dokumenty na webu
Nabídka, licenční smlouva a zásady zpracování dat jsou dostupné před připojením.

Požádat o licenci přeprodejce · Nabídka a licenční smlouva