Qwen: Qwen Image 3 Pro
Qwen-Image-3.0 Pro is Qwens vlaggenschipmodel voor beeldgeneratie en -bewerking, met complexe indelingen, realistische details en meertalige tekst. Gebruik een nauwkeurig verzoek of één tot drie referenties voor een grafisch ontwerp, productscène of gerichte visuele bewerking.
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 Qwens vlaggenschipmodel van de derde generatie voor beeldgeneratie en -bewerking. Het combineert het maken van complexe indelingen, gedetailleerde realistische texturen, meertalige typografie en nauwkeurig volgen van een beeldopdracht. Pro en de standaardeditie Qwen-Image-3.0 delen de gedocumenteerde generatie- en bewerkingsmodi; Pro benadrukt beeldkwaliteit, terwijl de standaardeditie kwaliteit en snelheid in evenwicht brengt. Het resultaat is een gerenderde afbeelding.
Definieer bij een informatierijk ontwerp eerst de inhoud en daarna de vorm: de kop, ondersteunende tekst, cijfers, hiërarchie en relaties tussen onderdelen. Een bruikbare productopdracht kan op één canvas een hoofdobject, materiaalclose-ups en gelabelde kenmerken 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 indelingen kunnen ook meerdere panelen of geneste interfaces tonen. Richt het aanbevolen promptmaximum van 4.500 tokens 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. De demonstraties tonen tekstweergave tot een grootte van slechts 10 pixels. Dit ondersteunt een ontwerp dat letters in een fysiek materiaal verwerkt of tekst met realistische beelden combineert. Geef de exacte formulering, cijfers en taal aan en beschrijf de typografische rol van elk blok. Een krantenpagina of interfacemock-up blijft een afbeelding; een latere bewerkbare indeling of interactief gedrag is een afzonderlijk resultaat dat op basis daarvan moet worden gebouwd.
Pro kan tekst in een afbeelding bewerken, elementen toevoegen, verwijderen of verplaatsen, de handeling van een onderwerp wijzigen, 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 pose. Een gerichte bewerking noemt zowel de gewenste wijziging als de kenmerken die intact moeten blijven, zodat de resulterende afbeelding gemakkelijker 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 zijn. De exacte API accepteert zijden van 1 tot 8.000 pixels en een verhouding tussen lange en korte zijde van hoogstens 10:1; het aanbevolen bereik is 384–2.048 pixels. De bewerkingsgids beveelt apart afbeeldingen tot 3.072 pixels aan, dus behandel de invoerkeuze als voorbereiding op de benodigde details en niet als een belofte dat elke resolutie het resultaat verbetert. Gebruik voor kleine tekst of materiaalkenmerken een leesbare, goed gekaderde referentie.
De uitvoer is PNG. De werkwijze van de producent retourneert één tot zes alternatieven, standaard één, en ondersteunt een totaal pixeloppervlak van 512 × 512 tot 2.048 × 2.048 met beeldverhoudingen van 1:8 tot 8:1. Het pixeloppervlakbudget staat sommige niet-vierkante afmetingen toe waarvan de langste zijde langer is dan 2.048 pixels. Wanneer geen formaat wordt aangegeven, beveelt 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 van de inhoud, details van het onderwerp en typografie op de bedoelde weergavegrootte.
Intelligente promptherschrijving staat standaard aan. Directe verbetering is beschikbaar voor zowel generatie als bewerking; agentverbetering verfijnt tekst-naar-beeldprompts en kan niet voor beeld-naar-beeldbewerking worden gebruikt. Thinking staat ook standaard aan en vereist promptherschrijving; het voegt redeneerwerk en generatietijd toe. Negatieve prompts geven ongewenste elementen aan, en een optionele seed kan vergelijkingen tussen varianten consistenter maken. Een duidelijke positieve opdracht moet nog steeds het onderwerp, de compositie en de te behouden details vastleggen.
Een praktische beoordeling van het resultaat controleert de exacte tekst, cijfers, leesvolgorde, overeenstemming met referenties en randen of texturen die belangrijk zijn voor het ontwerp. Behoud bij een gewenste herziening van een bepaald deel de geslaagde compositie en beschrijf de gerichte wijziging. Bewaar alle gekozen afbeeldingen met hun prompt en referenties, omdat de uitvoerlocaties van de producent na 24 uur verlopen. De gedocumenteerde modi en limieten van Pro horen bij de 3.0-editie; de tien-referentie- en native transparantiefuncties die voor Qwen 2.1 worden beschreven, zijn mogelijkheden van een andere editie.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations qwen/qwen-image-3-pro
qwen/qwen-image-3-proAan de slag
Qwen-Image-3.0 Pro is Qwens vlaggenschipmodel voor beeldgeneratie en -bewerking, met complexe indelingen, realistische details en meertalige tekst. Gebruik een nauwkeurig verzoek of één tot drie referenties voor een grafisch ontwerp, productscène of gerichte visuele bewerking.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Afbeeldingen POST /v1/images/generations
- Invoertypen
text,image- Uitvoertypen
image
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten qwen/qwen-image-3-pro | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldresolution | Typestring | VereisteOptioneel | Waarden en limieten 1K, 2K | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden 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— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 6 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 4 | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het 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 weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn 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 is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij 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.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte 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 |
| Configuratieinvoerafbeelding | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper invoerafbeelding | Kosten Invoer · invoerafbeelding · Schatting uitsluitend ter vergelijking $0.006 per invoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.08 schatting vóór generatie Deze schatting is geen extra bedrag 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
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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lezen van andere inhoud
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 het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde 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
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra qwen/qwen-image-3-pro
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
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