Qwen: Qwen Image 3 Pro

Qwen-Image-3.0 Pro är Qwens flaggskeppsmodell för bildgenerering och bildredigering med komplexa layouter, realistiska detaljer och flerspråkig text. Använd en precis uppgiftsbeskrivning eller en till tre referenser för att skapa en grafik, en produktscen eller en fokuserad visuell ändring.

Ailoot Ultra · Bilder POST /v1/images/generations qwen/qwen-image-3-pro

Om modellen

Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.

Qwen-Image-3.0 Pro är Qwens flaggskeppsmodell i tredje generationen för bildgenerering och bildredigering. Den kombinerar skapande av komplexa layouter, detaljerade realistiska texturer, flerspråkig typografi och noggrann följsamhet till bildbeskrivningen. Pro och standardversionen Qwen-Image-3.0 delar de dokumenterade genererings- och redigeringslägena; Pro betonar bildkvalitet, medan standardversionen balanserar kvalitet och hastighet. Resultatet är en renderad bild.

För informationsrik grafik ska du definiera innehållet före utseendet: rubrik, stödtext, siffror, hierarki och samband mellan avsnitt. En användbar produktbeskrivning kan kombinera ett huvudobjekt, närbilder av materialdetaljer och märkta funktioner på samma bildyta. För en pedagogisk illustration ska du ange begreppet, diagramstrukturen och de exakta bildtexterna i stället för att låta modellen hitta på de underliggande fakta. Komplexa layouter kan också visa flera paneler eller nästlade gränssnitt. Håll den rekommenderade maximala promptlängden på 4 500 token fokuserad på vad som måste synas och var det hör hemma.

3.0-familjen stöder inbyggd typografi på 12 språk, flera typsnitt och fler än 100 konstnärliga stilar samt fina texturer som hår, hud eller tyg. Rendering av liten text demonstreras ned till 10 pixlar. Det möjliggör en design som blandar bokstäver med ett fysiskt material eller kombinerar text med realistiska bilder. Ange exakt ordalydelse, siffror och språk och beskriv varje textblocks typografiska roll. En tidningssida eller gränssnittsmodell är fortfarande en bild, så en senare redigerbar layout eller interaktiv funktion är ett separat resultat som behöver byggas utifrån bilden.

Pro kan redigera text i en bild, lägga till, ta bort eller flytta element, ändra motivets handling, överföra visuell stil och förbättra detaljer. Redigering tar emot en till tre indatabilder med en instruktion. Deras ordning avgör bild 1, bild 2 och bild 3 i beskrivningen. Ange vilken referens som ger motivets identitet, vilken som tillhandahåller ett objekt eller kläder och vilken som bidrar med en miljö eller pose. En fokuserad redigering anger både den avsedda ändringen och de egenskaper som ska förbli intakta, vilket gör resultatbilden lättare att jämföra med referenserna.

Indataformat som stöds är JPG, JPEG, PNG, BMP, TIFF, WebP och GIF, där endast den första bildrutan används för animerade GIF-filer. Varje indatabild kan vara upp till 10 MB. Det exakta API:et accepterar sidor från 1 till 8 000 pixlar och ett förhållande mellan lång och kort sida på högst 10:1; det rekommenderade intervallet är 384–2 048 pixlar. Redigeringsguiden rekommenderar separat bilder upp till 3 072 pixlar, så behandla indatavalet som förberedelse för den detaljnivå som behövs snarare än som ett löfte om att varje upplösning förbättrar resultatet. Använd en läsbar referens med tillräcklig inramning för liten text eller materialegenskaper.

Utdata är PNG. Tillverkarens arbetsflöde returnerar ett till sex alternativ, med ett som standard, och stöder en total pixelyta från 512 × 512 till 2 048 × 2 048 med bildförhållanden från 1:8 till 8:1. Pixelytebudgeten tillåter vissa icke-kvadratiska dimensioner där den längre sidan överstiger 2 048 pixlar. När ingen storlek anges rekommenderar modellen en upplösning utifrån uppgiftsbeskrivningen. Välj formen efter den faktiska placeringen och jämför sedan de genererade alternativen utifrån innehållets fullständighet, motivdetaljer och typografi vid den avsedda visningsstorleken.

Intelligent omskrivning av prompten är aktiverad som standard. Direkt förbättring finns för både generering och redigering, medan agentbaserad förbättring förfinar text-till-bild-promptar och inte kan användas för bild-till-bild-redigering. Thinking är också aktiverat som standard och kräver promptomskrivning; det tillför resonemangsarbete och genereringstid. Negativa promptar anger oönskade element, och ett valfritt seed kan hjälpa till att göra jämförelser mellan varianter mer konsekventa. En tydlig positiv beskrivning ska ändå ange motiv, komposition och detaljer som ska bevaras.

En praktisk resultatgranskning kontrollerar den exakta texten, siffrorna, läsordningen, referenstroheten och de kanter eller texturer som är viktiga för designen. När en viss del behöver revideras ska du behålla den lyckade kompositionen och beskriva den fokuserade ändringen. Spara alla valda bilder med deras prompt och referenser, eftersom tillverkarens utdataplatser upphör att gälla efter 24 timmar. Pros dokumenterade lägen och gränser hör till 3.0-versionen; stödet för tio referenser och inbyggd transparens som beskrivs för Qwen 2.1 är separata versionsförmågor.

Ailoot Ultra · Bilder POST /v1/images/generations qwen/qwen-image-3-pro

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

Start

Godkända indata: Text · Bilder
Resultat: Bilder

Tillgängligt i Ailoot · indata & metoder

Ailoot Ultra · Bilder POST /v1/images/generations

Indatatyper: text, image
Utdatatyper: image

Fält	Typ	Krav	Värden & gränser	Standard
Fält`model`	Typ`string`	KravObligatoriskt	Värden & gränser qwen/qwen-image-3-pro	Standard—
Fält`prompt`	Typ`string`	KravObligatoriskt	Värden & gränser Minsta längd: 1	Standard—
Fält`resolution`	Typ`string`	KravValfritt	Värden & gränser 1K, 2K	Standard—
Fält`aspect_ratio`	Typ`string`	KravValfritt	Värden & gränser 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	Standard—
Fält`n`	Typ`integer`	KravValfritt	Värden & gränser Minimum: 1 Maximum: 6	Standard—
Fält`input_references`	Typ`array`	KravValfritt	Värden & gränser Minsta antal objekt: 0 Maximalt antal objekt: 4	Standard—
Fält`provider`	Typ`object`	KravValfritt	Värden & gränser	Standard—

Metodparametrar och livscykel

Parameter	Avtal
Parameter`content_type`	Avtalapplication/json
Parameter`required`	Avtalmodel, prompt
Parameter`material_types`	Avtaltext, image

Livscykel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Det task_id som faktiskt returnerades eller en post i mediebiblioteket

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Priser

Så beräknas slutavgiften

De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.

Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.

Snabbt läge: Ej angivet När snabbt läge är valt
Flex-läge: Ej angivet När läget flex är valt
Högsta resonemangsnivå: Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)

Uppskattade priser för jämförelse

Priser efter konfiguration

Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.

Konfiguration	Prislista	Prognostiserad mängd	Debiteringsenhet	Avgift
KonfigurationGrundpriser för token	PrislistaGrundpris	Prognostiserad mängd—	Debiteringsenhet—	Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token
Konfigurationindatabild	Prislista—	Prognostiserad mängd—	Debiteringsenhetper indatabild	Avgift Indata · indatabild · Uppskattning endast för jämförelse $0.006 per indatabild
KonfigurationUppskattad genereringskostnad	Prislista—	Prognostiserad mängduppskattning för en generering	Debiteringsenhet—	Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.08 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen.

Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →

Exempelbegäranden

Ailoot Ultra · Bilder

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

Ta emot och spara resultat

Ailoot Ultra · Bilder

Ladda ned varje returnerad bild eller spara dess Base64-innehåll

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

Andra innehållsläsningar

Läs befintliga resurser som tillhör dig

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.

Behåll alla färdiga resultat

Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.

Spara hela svaret med headers, samtliga faktiska resultat, de ursprungliga returnerade identifierarna och alla användningsfält. Hämta den ursprungliga operationen utan att skicka skapandeförfrågan igen.

Om det ursprungliga svaret behöver kontrolleras

Behåll det returnerade värdet för X-Client-Request-ID för avstämning. Läs endast av resultat via de task_id/asset_id-värden som faktiskt returnerades eller via det mediebibliotek som tillhör dig. Bygg aldrig en uppgifts-URL från operations-ID:t och skicka aldrig skapandeförfrågan igen.

Svarsfält

Fält	Typ
Fält`created`	Typ
Fält`data[].url`	Typ
Fält`data[].b64_json`	Typ
Fält`usage`	Typ

Alias

Modellalias

Ailoot Ultra qwen/qwen-image-3-pro

Alias för metodsökvägar

/v1/images

Relaterade anropar-ID:n

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

Vilka indata och resultat finns?: POST /v1/images/generations · qwen/qwen-image-3-pro: text, image → image
Vilka fält använder begäran?: POST /v1/images/generations · qwen/qwen-image-3-pro: model, prompt, resolution, aspect_ratio, n, input_references, provider
Vilka gränser gäller?: POST /v1/images/generations · qwen/qwen-image-3-pro: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3 Pro