Qwen: Qwen Image 3
Qwen-Image-3.0 kombinerer bildegenerering og redigering for informasjonsrike oppsett, detaljerte scener og flerspråklig typografi. Standardutgaven balanserer kvalitet og hastighet og tar imot en tekstbeskrivelse eller opptil tre bilder med en redigeringsinstruksjon.
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 er Qwens tredjegenerasjons bildemodell, som kombinerer tekst-til-bilde-generering og referansebasert redigering i én modell. Standardutgaven balanserer bildekvalitet og responshastighet, mens Qwen-Image-3.0 Pro er den kvalitetsorienterte flaggskipvarianten. En forespørsel produserer et bilde: en plakat, en illustrert forklaring, en produktscene, et storyboard eller et bearbeidet fotografi, ikke et redigerbart dokument eller et fungerende grensesnitt.
Egenskapene for rikt innhold passer til et lerret med flere relaterte seksjoner eller et nestet visuelt oppsett. Klargjør overskrifter, nøyaktig ordlyd, hierarki og forholdet mellom panelene før du legger til stildetaljer. For en produktsammenligning angir en nyttig beskrivelse hovedvisningen av produktet, egenskapene som skal merkes, og leserekkefølgen for støttepanelene. For et storyboard beskriver du motiv, handling og bildetekst for hvert panel separat. Anbefalt maksimal promptlengde er 4 500 tokener; bruk plassen på innholdet og oppsettet bildet faktisk trenger.
Modellen støtter detaljerte teksturer, typografi ned til liten tekst demonstrert ved 10 piksler og innebygd gjengivelse på 12 språk med flere skrifttyper og kunstneriske stiler. Disse egenskapene kan kombinere et realistisk objekt med informasjonsrik grafikk i stedet for å tvinge frem et valg mellom et fotografi og et teksttungt oppsett. Oppgi de nøyaktige ordene og tallene som skal gjengis, det tiltenkte språket og hvor de skal stå. Behandle et generert grensesnitt som en visuell skisse: knapper, diagrammer og etiketter i bildet implementerer ikke funksjonaliteten til en applikasjon.
Redigering kan endre tekst, legge til eller fjerne objekter, flytte elementer, justere handlingen til et motiv, overføre en stil eller forbedre detaljene i et skadet bilde. Oppgi ett til tre bilder og én tydelig redigeringsinstruksjon. Bildenummereringen følger rekkefølgen bildene er oppgitt i, så angi hvilket bilde som bidrar med motivet, hvilket som gir et plagg eller objekt, og hvilket som gir omgivelsene. For en produktscene kan du be om å plassere objektet fra bilde 1 i miljøet fra bilde 2, samtidig som egenskapene som kjennetegner produktet, bevares. Gjør endringene og kravene til bevaring eksplisitte.
Den spesifikke arbeidsflyten for bildeinndata godtar JPG, JPEG, PNG, BMP, TIFF, WebP og GIF; bare den første rammen i en animert GIF behandles. Hvert bilde kan være opptil 10 MB. Det gjeldende API-et godtar dimensjoner fra 1 til 8 000 piksler med et forhold mellom lang- og kortside på høyst 10:1, og anbefaler 384–2 048 piksler for gode resultater. Velg et inndatabilde som tydelig viser detaljene som skal overføres eller redigeres. En tett beskåret referanse kan skjule den omkringliggende strukturen som trengs for å plassere et objekt naturlig.
Utdataformatet er PNG, med ett til seks bilder per forespørsel og ett som standard. Pikselarealet for utdata går fra 512 × 512 til 2 048 × 2 048, med sideforhold mellom 1:8 og 8:1; dette er arealgrenser, ikke en regel om at hver side må være høyst 2 048 piksler. Hvis det ikke oppgis en størrelse, anbefaler modellen en oppløsning ut fra prompten. Velg liggende, kvadratisk eller stående komposisjon for den tiltenkte bruken, og undersøk det returnerte bildet i den faktiske størrelsen slik at små etiketter og fine detaljer kan vurderes der de skal vises.
Omskriving av prompten er aktivert som standard i produsentens arbeidsflyt. Direkte forbedring fungerer både for generering og redigering; agentbasert forbedring er en mer omfattende omskrivingsmodus bare for tekst-til-bilde og avvises ved bilde-til-bilde-redigering. Resonnering er aktivert som standard, krever omskriving av prompten og øker genereringstiden. Negative prompter kan beskrive uønskede elementer, mens en fast seed-verdi hjelper med å sammenligne variasjoner. Oppgi utelatelser og nøyaktige krav til bevaring tydelig, fremfor å forvente at en seed-verdi får en beskrivelse som endres, til å returnere et identisk bilde.
For et nyttig sluttresultat undersøker du den gjengitte teksten, enhetene, panelrekkefølgen og detaljene som identifiserer motivet, og reviderer deretter den konkrete delen som ikke oppfylte beskrivelsen. Et svar med flere bilder gir alternativer å sammenligne; behold hvert returnerte bilde knyttet til prompten og referansene som produserte det. Produsentens bildeadresser utløper etter 24 timer, så behold selve bildefilen når resultatet blir en del av et prosjekt. Standardutgaven 3.0 er fortsatt atskilt fra Pro og fra Qwen 2.1-modeller med deres ulike antall referanser og funksjoner for gjennomsiktighet.
Ailoot Ultra · Bilder POST /v1/images/generations qwen/qwen-image-3
qwen/qwen-image-3Start
Qwen-Image-3.0 kombinerer bildegenerering og redigering for informasjonsrike oppsett, detaljerte scener og flerspråklig typografi. Standardutgaven balanserer kvalitet og hastighet og tar imot en tekstbeskrivelse eller opptil tre bilder med en redigeringsinstruksjon.
- 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 | 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.06 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', '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
Aliaser for metodestier
/v1/images
Tilknyttede anroper-ID-er
FAQ · Qwen: Qwen Image 3
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/images/generations·qwen/qwen-image-3:text,image→image- Hvilke felt bruker forespørselen?
POST /v1/images/generations·qwen/qwen-image-3:model,prompt,resolution,aspect_ratio,n,input_references,provider- Hvilke grenser gjelder?
POST /v1/images/generations·qwen/qwen-image-3:n.minimum:1;n.maximum:6