Qwen: Qwen Image 3 Pro
Qwen-Image-3.0 Pro er Qwens flaggskipmodell for bildegenerering og redigering med komplekse oppsett, realistiske detaljer og flerspråklig tekst. Bruk en presis beskrivelse eller én til tre referanser for å lage grafikk, en produktscene eller en avgrenset visuell redigering.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Qwen-Image-3.0 Pro er Qwens flaggskipmodell i tredje generasjon for bildegenerering og redigering. Den kombinerer komplekse oppsett, detaljerte realistiske teksturer, flerspråklig typografi og tett følging av en bildebeskrivelse. Pro og standardutgaven Qwen-Image-3.0 deler de dokumenterte genererings- og redigeringsmodusene; Pro vektlegger bildekvalitet, mens standardutgaven balanserer kvalitet og hastighet. Resultatet er et gjengitt bilde.
For informasjonsrik grafikk definerer du innholdet før utseendet: overskrift, støttetekst, tall, hierarki og forholdet mellom delene. En nyttig produktbeskrivelse kan kombinere et hovedobjekt, nærbilder av materialdetaljer og merkede egenskaper på ett lerret. For en pedagogisk illustrasjon angir du konseptet, diagramstrukturen og de nøyaktige bildetekstene i stedet for å la modellen finne på de underliggende faktaene. Komplekse oppsett kan også vise flere paneler eller nestede grensesnitt. Hold det anbefalte maksimumet på 4 500 tokener for instruksen rettet mot det som må vises og hvor det hører hjemme.
3.0-familien støtter innebygd typografi i 12 språk, flere skrifttyper og mer enn 100 kunstneriske stiler, sammen med fine teksturer som hår, hud eller stoff. Demonstrasjonene viser gjengivelse av liten tekst ned til 10 piksler. Dette støtter et design som blander bokstaver med et fysisk materiale eller kombinerer tekst med realistiske bilder. Gi den presise ordlyden, tallene og språket og beskriv den typografiske rollen til hver blokk. En avisside eller grensesnittskisse er fortsatt et bilde, så et senere redigerbart oppsett eller interaktiv oppførsel er et separat resultat som må bygges fra det.
Pro kan redigere tekst i et bilde, legge til, slette eller flytte elementer, endre et motivs handling, overføre visuell stil og forbedre detaljer. Redigering tar imot én til tre inngangsbilder med en instruksjon. Rekkefølgen bestemmer bilde 1, bilde 2 og bilde 3 i oppgavebeskrivelsen. Oppgi hvilken referanse som gir motivets identitet, hvilken som gir et objekt eller klær og hvilken som bidrar med en setting eller positur. En avgrenset redigering navngir både den ønskede endringen og egenskapene som skal bevares, slik at resultatbildet blir lettere å sammenligne med referansene.
Støttede inndataformater er JPG, JPEG, PNG, BMP, TIFF, WebP og GIF, med bare første ramme brukt for animerte GIF-er. Hvert inngangsbilde kan være opptil 10 MB. Den nøyaktige API-en tillater sider fra 1 til 8 000 piksler og et forhold mellom lengste og korteste side på høyst 10:1; det anbefalte området er 384–2 048 piksler. Redigeringsveiledningen anbefaler separat bilder opptil 3 072 piksler, så behandle inndatavalget som forberedelse til detaljene som trengs, ikke som en garanti for at hver oppløsning forbedrer resultatet. Bruk en lesbar referanse med egnet innramming for liten tekst eller materialegenskaper.
Utdata er PNG. Produsentens arbeidsflyt returnerer ett til seks alternativer, med ett som standard, og støtter et samlet pikselareal fra 512 × 512 til 2 048 × 2 048 med sideforhold fra 1:8 til 8:1. Pikselarealbudsjettet tillater enkelte ikke-kvadratiske dimensjoner der lengste side er over 2 048 piksler. Når størrelse ikke er angitt, anbefaler modellen en oppløsning basert på oppgavebeskrivelsen. Velg formen for den faktiske plasseringen, og sammenlign deretter de genererte alternativene for innholdsfullstendighet, motivdetaljer og typografi ved tiltenkt visningsstørrelse.
Intelligent omskriving av instruksen er aktivert som standard. Direkte forbedring er tilgjengelig både for generering og redigering, mens agentforbedring finpusser tekst-til-bilde-instrukser og ikke kan brukes til bilde-til-bilde-redigering. Thinking er også aktivert som standard og krever omskriving av instruksen; det legger til resonnement og genereringstid. Negative instrukser angir uønskede elementer, og en valgfri seed kan gjøre sammenligninger mellom varianter mer konsekvente. En tydelig positiv beskrivelse skal fortsatt fastsette motivet, komposisjonen og detaljene som skal beholdes.
Et praktisk gjennomgangstrinn kontrollerer den nøyaktige teksten, tallene, leserekkefølgen, samsvar med referansene og kantene eller teksturene som er viktige for designet. Når en bestemt del trenger revisjon, beholder du den vellykkede komposisjonen og beskriver den avgrensede endringen. Behold alle valgte bilder med instruksen og referansene, siden produsentens utdatalokasjoner utløper etter 24 timer. Pros dokumenterte moduser og grenser gjelder 3.0-utgaven; funksjonene med ti referanser og innebygd gjennomsiktighet som beskrives for Qwen 2.1, gjelder en annen utgave.
Ailoot Ultra · Bilder POST /v1/images/generations qwen/qwen-image-3-pro
qwen/qwen-image-3-proStart
Qwen-Image-3.0 Pro er Qwens flaggskipmodell for bildegenerering og redigering med komplekse oppsett, realistiske detaljer og flerspråklig tekst. Bruk en presis beskrivelse eller én til tre referanser for å lage grafikk, en produktscene eller en avgrenset visuell redigering.
- Godkjente inndata
- Tekst · Bilder
- Resultater
- Bilder
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Bilder POST /v1/images/generations
- Inndatatyper
text,image- Utdatatyper
image
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser qwen/qwen-image-3-pro | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser Minste lengde: 1 | Standard— |
Feltresolution | Typestring | KravValgfritt | Verdier & grenser 1K, 2K | Standard— |
Feltaspect_ratio | Typestring | KravValgfritt | Verdier & grenser 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— |
Feltn | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 1 Maksimum: 6 | Standard— |
Feltinput_references | Typearray | KravValgfritt | Verdier & grenser Minste antall elementer: 0 Maksimalt antall elementer: 4 | Standard— |
Feltprovider | Typeobject | KravValgfritt | Verdier & grenser | Standard— |
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt |
Parametermaterial_types | Avtaletext, image |
Livssyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktisk returnert task_id eller oppføring i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Faktureringsenhet | Kostnad |
|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Faktureringsenhet— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonInndatabilde | Prisplan— | Forventet mengde— | Faktureringsenhetper inndatabilde | Kostnad Inndata · inndatabilde · Estimat kun for sammenligning $0.006 per inndatabilde |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsenhet— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.08 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
Ailoot Ultra · Bilder
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
Motta og lagre resultater
Ailoot Ultra · Bilder
Last ned hvert returnerte bilde eller lagre Base64-innholdet
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Andre innholdslesinger
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.
Behold alle ferdige resultater
Lagre hvert ferdige bilde; hent hver returnerte URL eller dekod Base64-innholdet.
Bevar hele svaret og svarhodene, alle faktiske utdata, de opprinnelige returnerte identifikatorene og alle bruksfeltene. Hent den opprinnelige operasjonen igjen uten å sende opprettelsesforespørselen på nytt.
Hvis det opprinnelige svaret må kontrolleres
Bevar returnert X-Client-Request-ID for avstemming. Les bare faktisk returnerte task_id/asset_id-verdier eller egne oppføringer i mediebiblioteket; bygg aldri en oppgave-URL fra operasjons-ID-en, og send aldri opprettelsesforespørselen på nytt.
Svarfelter
| Felt | Type |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Aliaser
Modellaliaser
Ailoot Ultra qwen/qwen-image-3-pro
Aliaser for metodestier
/v1/images
Tilknyttede anroper-ID-er
FAQ · Qwen: Qwen Image 3 Pro
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/images/generations·qwen/qwen-image-3-pro:text,image→image- Hvilke felt bruker forespørselen?
POST /v1/images/generations·qwen/qwen-image-3-pro:model,prompt,resolution,aspect_ratio,n,input_references,provider- Hvilke grenser gjelder?
POST /v1/images/generations·qwen/qwen-image-3-pro:n.minimum:1;n.maximum:6