models

Qwen: Qwen Image 3 Pro

Markdown · JSON

Qwen: Qwen Image 3 Pro

Qwen-Image-3.0 Pro is het vlaggenschipmodel van Qwen voor beeldgeneratie en -bewerking met complexe lay-outs, realistische details en meertalige tekst. Gebruik een precieze opdracht of één tot drie referenties om een grafisch ontwerp, productscène of gerichte visuele bewerking te maken.

Over het model

Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.

Qwen-Image-3.0 Pro is het vlaggenschipmodel van de derde generatie van Qwen voor beeldgeneratie en -bewerking. Het combineert complexe lay-outs, gedetailleerde realistische texturen, meertalige typografie en nauwkeurige opvolging van een beeldopdracht. Pro en de standaardversie Qwen-Image-3.0 delen de gedocumenteerde generatie- en bewerkingsmodi; Pro benadrukt beeldkwaliteit, terwijl de standaardeditie kwaliteit en snelheid afweegt. Het resultaat is een gerenderd beeldbestand.

Definieer bij een informatierijk ontwerp eerst de inhoud en dan de uitstraling: de hoofdtitel, ondersteunende tekst, cijfers, hiërarchie en samenhang tussen onderdelen. Een nuttige productopdracht kan een hoofdobject, materiaalclose-ups en gelabelde kenmerken op één canvas combineren. Benoem bij een educatieve illustratie het concept, de diagramstructuur en de exacte bijschriften, in plaats van het model de onderliggende feiten te laten verzinnen. Complexe lay-outs kunnen ook meerdere panelen of geneste interfaces tonen. Houd de aanbevolen promptlimiet van 4.500 tokens gericht op wat moet verschijnen en waar het hoort.

De 3.0-familie ondersteunt native typografie in 12 talen, meerdere lettertypen en meer dan 100 artistieke stijlen, naast fijne texturen zoals haar, huid of stof. Weergave van kleine tekst is gedemonstreerd tot 10 pixels. Dat ondersteunt een ontwerp dat letters met een fysiek materiaal verweeft of tekst met realistische beelden combineert. Geef de precieze bewoording, cijfers en taal op en beschrijf de typografische rol van elk blok. Een krantenpagina of interfacemock-up blijft een afbeelding; een later bewerkbare lay-out of interactief gedrag is dus een afzonderlijk resultaat dat daarop gebaseerd moet worden.

Pro kan tekst in een afbeelding bewerken, elementen toevoegen, verwijderen of verplaatsen, de handeling van een onderwerp veranderen, een visuele stijl overbrengen en details verbeteren. Bewerking accepteert één tot drie invoerafbeeldingen met een instructie. Hun volgorde bepaalt afbeelding 1, afbeelding 2 en afbeelding 3 in de opdracht. Geef aan welke referentie de identiteit van het onderwerp levert, welke een object of kleding en welke een omgeving of houding. Een gerichte bewerking benoemt zowel de gewenste verandering als de kenmerken die intact moeten blijven, zodat het resultaat eenvoudiger met de referenties te vergelijken is.

Ondersteunde invoerformaten zijn JPG, JPEG, PNG, BMP, TIFF, WebP en GIF; bij geanimeerde GIF's wordt alleen het eerste frame gebruikt. Elke invoerafbeelding mag maximaal 10 MB groot zijn. De specifieke API accepteert zijden van 1 tot 8.000 pixels en een verhouding tussen de lange en korte zijde van maximaal 10:1; het aanbevolen bereik is 384–2.048 pixels. De bewerkingsgids raadt afzonderlijk afbeeldingen tot 3.072 pixels aan. Beschouw de invoerkeuze daarom als voorbereiding op de benodigde details, niet als een belofte dat elke resolutie het resultaat verbetert. Gebruik voor kleine tekst of materiaalkenmerken een leesbare, goed gekadreerde referentie.

Uitvoer is PNG. De werkwijze van de ontwikkelaar retourneert één tot zes alternatieven, standaard één, en ondersteunt een totale pixeloppervlakte van 512 × 512 tot 2.048 × 2.048 bij beeldverhoudingen van 1:8 tot 8:1. Het pixeloppervlaktebudget staat enkele niet-vierkante afmetingen toe waarvan de lange zijde groter is dan 2.048 pixels. Als geen formaat is opgegeven, raadt het model op basis van de opdracht een resolutie aan. Kies de vorm voor de daadwerkelijke plaatsing en vergelijk daarna de gegenereerde alternatieven op volledigheid, onderwerpsdetails en typografie bij het beoogde weergaveformaat.

Intelligent herschrijven van de prompt is standaard ingeschakeld. Directe verbetering is beschikbaar voor zowel generatie als bewerking, terwijl verbetering via een agent tekst-naar-beeldprompts verfijnt en niet voor beeld-naar-beeldbewerking gebruikt kan worden. Thinking is ook standaard ingeschakeld en vereist promptherschrijving; het voegt redeneerwerk en generatietijd toe. Negatieve prompts benoemen ongewenste elementen, en een optionele seed kan vergelijkingen tussen varianten consistenter maken. Een duidelijke positieve opdracht hoort nog steeds het onderwerp, de compositie en de te behouden details vast te leggen.

Een praktische resultaatcontrole kijkt naar de exacte tekst, cijfers, leesvolgorde, trouw aan de referenties en randen of texturen die voor het ontwerp belangrijk zijn. Behoud bij een gerichte herziening de geslaagde compositie en beschrijf de gewenste plaatselijke verandering. Bewaar alle gekozen afbeeldingen met hun prompt en referenties, want de uitvoerlocaties van de ontwikkelaar vervallen na 24 uur. De gedocumenteerde modi en limieten van Pro horen bij de 3.0-editie; de tien referenties en native ondersteuning voor transparantie die voor Qwen 2.1 worden beschreven, zijn mogelijkheden van een afzonderlijke editie.

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

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

Aan de slag

Qwen-Image-3.0 Pro is het vlaggenschipmodel van Qwen voor beeldgeneratie en -bewerking met complexe lay-outs, realistische details en meertalige tekst. Gebruik een precieze opdracht of één tot drie referenties om een grafisch ontwerp, productscène of gerichte visuele bewerking te maken.

Toegestane invoer
Tekst · Afbeeldingen
Resultaten
Afbeeldingen

Beschikbaar in Ailoot · invoer en methoden

Ailoot Ultra · Afbeeldingen POST /v1/images/generations
Invoer
text, image
Uitvoer
image
VeldTypeVereisteWaarden en limietenStandaard
VeldmodelTypestringVereisteVereistWaarden en limieten
qwen/qwen-image-3-pro
Standaard—
VeldpromptTypestringVereisteVereistWaarden en limieten
Minimumlengte: 1
Standaard—
VeldresolutionTypestringVereisteOptioneelWaarden en limieten
1K, 2K
Standaard—
Veldaspect_ratioTypestringVereisteOptioneelWaarden en limieten
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
Standaard—
VeldnTypeintegerVereisteOptioneelWaarden en limieten
Minimum: 1
Maximum: 6
Standaard—
Veldinput_referencesTypearrayVereisteOptioneelWaarden en limieten
Minimumaantal items: 0
Maximumaantal items: 4
Standaard—
VeldproviderTypeobjectVereisteOptioneelWaarden en limietenStandaard—
Methodeparameters en levenscyclus
ParameterContract
Parametercontent_typeContractapplication/json
ParameterrequiredContractmodel, prompt
Parametermaterial_typesContracttext, image

Levenscyclus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · daadwerkelijk teruggegeven task_id of record in de mediabibliotheek

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarieven

Zo worden de uiteindelijke kosten berekend

De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.

Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.

Snelle modus
Niet opgegeven Wanneer de snelle modus geselecteerd is
Flex-modus
Niet opgegeven Wanneer de flex-modus geselecteerd is
Maximale redeneerinspanning
Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt

Geschatte tarieven ter vergelijking

Prijzen per configuratie

Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.

ConfiguratieTariefstaffelVerwachte hoeveelheidRekeneenheidKosten
ConfiguratieBasistarieven voor tokensTariefstaffelBasistariefVerwachte hoeveelheid—Rekeneenheid—Kosten
Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens
Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens
Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens
Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens
Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens
ConfiguratieinvoerafbeeldingTariefstaffel—Verwachte hoeveelheid—Rekeneenheidper invoerafbeeldingKosten
Invoer · invoerafbeelding · Schatting uitsluitend ter vergelijking $0.006 per invoerafbeelding
ConfiguratieGeschatte generatiekostenTariefstaffel—Verwachte hoeveelheidschatting voor één generatieRekeneenheid—Kosten
Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.08 schatting vóór generatie

Deze raming is geen extra kost of vast tarief voor de voltooide generatie.

Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →

Voorbeeldverzoeken

Ailoot Ultra · Afbeeldingen

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

Resultaten ophalen en opslaan

Ailoot Ultra · Afbeeldingen

Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Lezen van andere inhoud
Bestaande eigen bestanden ophalen
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.
Alle voltooide resultaten bewaren

Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.

Bewaar de volledige respons en headers, iedere daadwerkelijke uitvoer, de oorspronkelijk teruggegeven identificatoren en alle verbruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.

Als het oorspronkelijke antwoord moet worden gecontroleerd

Bewaar de teruggegeven X-Client-Request-ID voor de reconciliatie. Lees uitsluitend daadwerkelijk teruggegeven task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.

Antwoordvelden
VeldType
VeldcreatedType
Velddata[].urlType
Velddata[].b64_jsonType
VeldusageType

Aliasnamen

Modelaliasnamen

Ailoot Ultra qwen/qwen-image-3-pro

Aliasnamen voor methodepaden

/v1/images

Gerelateerde aanroeper-ID’s

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro
Welke invoer en resultaten zijn beschikbaar?

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

Welke velden gebruikt het verzoek?

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

Welke limieten gelden?

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

Meer details

Verbind Ailoot met Claude Code, OpenCode, Hermes of je eigen applicatie.

Het bedrijf en zijn projectenportefeuille

Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.

Koop tokens met korting.

Abonnementsvoordeel voor regelmatig gebruik. Promotiecodes geven tot 50% korting op tokens.

Abonnement
Kies een abonnement met korting voor je terugkerende verzoeken.
Promotiecode tot 50%
Vul de code bij aankoop in. De prijs wordt volgens de lopende actie herberekend.
Kosten in de geschiedenis
Model, tokens en bedrag worden per verzoek bewaard.

Kies een abonnement · Bekijk modelprijzen

Verbind de API met het product dat je verkoopt.

SaaS, apps en bots volgens de openbare aanbodvoorwaarden en licentieovereenkomst van Ailoot. Vraag voor doorverkoop een resellerlicentie aan.

Commerciële applicatie
Voeg tekst-, beeld-, video- en geluidsgeneratie aan betaalde functies van je service toe.
Resellerlicentie
Stuur een projectbeschrijving en toegangsschema. Vraag schriftelijke voorwaarden voor gebruik en doorverkoop.
Documenten op de site
Aanbodvoorwaarden, licentieovereenkomst en gegevensbeleid zijn vóór het verbinden beschikbaar.

Vraag een resellerlicentie aan · Aanbodvoorwaarden en licentieovereenkomst