Qwen: Qwen Image 3 Pro
Qwen-Image-3.0 Pro er Qwens flagskibsmodel til billedgenerering og redigering med komplekse layouts, realistiske detaljer og flersproget tekst. Brug en præcis opgavebeskrivelse eller en til tre referencer til at skabe grafik, en produktscene eller en fokuseret visuel ændring.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
Qwen-Image-3.0 Pro er Qwens flagskibsmodel i tredje generation til billedgenerering og redigering. Den kombinerer komplekse layouts, detaljerede realistiske teksturer, flersproget typografi og tæt efterlevelse af billedbeskrivelsen. Pro og standardversionen Qwen-Image-3.0 deler de dokumenterede genererings- og redigeringstilstande; Pro lægger vægt på billedkvalitet, mens standardversionen balancerer kvalitet og hastighed. Resultatet er et renderet billede.
Ved informationsrig grafik skal du definere indholdet før udseendet: overskrift, supplerende tekst, tal, hierarki og forholdet mellem afsnit. En nyttig produktbeskrivelse kan kombinere et hovedobjekt, nærbilleder af materialedetaljer og mærkede egenskaber på samme billedflade. Ved en undervisningsillustration skal du angive begrebet, diagramstrukturen og de præcise billedtekster frem for at lade modellen opfinde de underliggende fakta. Komplekse layouts kan også vise flere paneler eller indlejrede grænseflader. Hold den anbefalede maksimale promptlængde på 4.500 tokens fokuseret på, hvad der skal vises, og hvor det hører til.
3.0-familien understøtter indbygget typografi på 12 sprog, flere skrifttyper og mere end 100 kunstneriske stilarter samt fine teksturer som hår, hud eller stof. Gengivelse af lille tekst er demonstreret ned til 10 pixels. Det understøtter design, der blander bogstaver med et fysisk materiale eller kombinerer tekst med realistiske billeder. Giv den præcise ordlyd, tal og sprog, og beskriv hver tekstbloks typografiske rolle. En avisside eller en grænseflademockup er stadig et billede, så en senere redigerbar opsætning eller interaktiv funktion er et separat resultat, der skal bygges ud fra billedet.
Pro kan redigere tekst i et billede, tilføje, slette eller flytte elementer, ændre et motivs handling, overføre visuel stil og forbedre detaljer. Redigering modtager ét til tre inputbilleder med en instruktion. Deres rækkefølge bestemmer billede 1, billede 2 og billede 3 i opgavebeskrivelsen. Angiv, hvilken reference der giver motivets identitet, hvilken der leverer et objekt eller tøj, og hvilken der bidrager med omgivelser eller en positur. En fokuseret redigering nævner både den ønskede ændring og de egenskaber, der skal bevares, så det resulterende billede bliver lettere at sammenligne med referencerne.
Understøttede input er JPG, JPEG, PNG, BMP, TIFF, WebP og GIF, hvor kun det første billede bruges ved animerede GIF-filer. Hvert inputbillede kan være op til 10 MB. Det præcise API accepterer sidelængder fra 1 til 8.000 pixels og et forhold mellem lang og kort side på højst 10:1; det anbefalede interval er 384–2.048 pixels. Redigeringsvejledningen anbefaler separat billeder op til 3.072 pixels, så behandl inputvalget som forberedelse til de nødvendige detaljer, ikke som et løfte om, at enhver opløsning forbedrer resultatet. Brug en læsbar og tilstrækkeligt indrammet reference til lille tekst eller materialegenskaber.
Output er PNG. Producentens arbejdsgang returnerer ét til seks alternativer, som standard ét, og understøtter et samlet pixelareal fra 512 × 512 til 2.048 × 2.048 med sideforhold fra 1:8 til 8:1. Pixelarealbudgettet tillader visse ikke-kvadratiske dimensioner, hvor den lange side overstiger 2.048 pixels. Når der ikke angives en størrelse, anbefaler modellen en opløsning ud fra opgavebeskrivelsen. Vælg formen til den faktiske placering, og sammenlign derefter de genererede alternativer for indholdets fuldstændighed, motivdetaljer og typografi ved den tilsigtede visningsstørrelse.
Intelligent promptomskrivning er aktiveret som standard. Direkte forbedring er tilgængelig for både generering og redigering, mens agentforbedring forfiner tekst-til-billede-prompts og ikke kan bruges til billede-til-billede-redigering. Thinking er også aktiveret som standard og kræver promptomskrivning; det tilføjer ræsonnementsarbejde og genereringstid. Negative prompts angiver uønskede elementer, og et valgfrit seed kan gøre sammenligninger mellem varianter mere ensartede. En tydelig positiv opgavebeskrivelse skal stadig fastlægge motiv, komposition og detaljer, der skal bevares.
En praktisk resultatgennemgang kontrollerer præcis tekst, tal, læserækkefølge, referencetrohed og de kanter eller teksturer, der betyder noget for designet. Når en bestemt del skal revideres, skal du bevare den vellykkede komposition og beskrive den fokuserede ændring. Gem alle valgte billeder med deres prompt og referencer, da producentens outputplaceringer udløber efter 24 timer. Pros dokumenterede tilstande og grænser hører til 3.0-versionen; de ti referencer og den indbyggede transparens, der beskrives for Qwen 2.1, er separate versionsegenskaber.
Ailoot Ultra · Billeder POST /v1/images/generations qwen/qwen-image-3-pro
qwen/qwen-image-3-proStart
Qwen-Image-3.0 Pro er Qwens flagskibsmodel til billedgenerering og redigering med komplekse layouts, realistiske detaljer og flersproget tekst. Brug en præcis opgavebeskrivelse eller en til tre referencer til at skabe grafik, en produktscene eller en fokuseret visuel ændring.
- Accepterede input
- Tekst · Billeder
- Resultater
- Billeder
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Billeder POST /v1/images/generations
- Inputtyper
text,image- Outputtyper
image
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser qwen/qwen-image-3-pro | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Minimumslængde: 1 | Standard— |
Feltresolution | Typestring | KravValgfrit | Værdier og grænser 1K, 2K | Standard— |
Feltaspect_ratio | Typestring | KravValgfrit | Værdier og 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— |
Feltn | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 1 Maksimum: 6 | Standard— |
Feltinput_references | Typearray | KravValgfrit | Værdier og grænser Minimumsantal elementer: 0 Maksimalt antal elementer: 4 | Standard— |
Feltprovider | Typeobject | KravValgfrit | Værdier og grænser | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt |
Parametermaterial_types | Kontrakttext, image |
Livscyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · det faktisk returnerede task_id eller posten i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Sådan beregnes det endelige beløb
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Estimerede takster til sammenligning
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Afregningsenhed | Beløb |
|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Afregningsenhed— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| Konfigurationinputbillede | Takstplan— | Forventet mængde— | Afregningsenhedpr. inputbillede | Beløb Input · inputbillede · Estimat kun til sammenligning $0.006 pr. inputbillede |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregningsenhed— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.08 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Billeder
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
Hent og gem resultater
Ailoot Ultra · Billeder
Hent hvert returneret billede, eller gem dets Base64-indhold
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Læsning af andet indhold
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 færdige resultater
Gem hvert færdigt billede; hent hver returneret URL eller afkod dets Base64-indhold.
Gem hele svaret og alle headere, alle faktisk returnerede output, de oprindeligt returnerede identifikatorer og alle felter med forbrugsdata. Gendan den oprindelige operation uden at sende oprettelsesanmodningen igen.
Hvis det oprindelige svar skal kontrolleres
Gem det returnerede X-Client-Request-ID til afstemning. Brug kun faktisk returnerede task_id/asset_id-værdier eller dit eget mediebibliotek til læseanmodninger; opbyg aldrig en opgave-URL ud fra operations-ID’et, og send aldrig oprettelsesanmodningen igen.
Svarfelter
| Felt | Type |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Aliaser
Modelaliaser
Ailoot Ultra qwen/qwen-image-3-pro
Aliaser for metodestier
/v1/images
Relaterede kalder-ID’er
FAQ · Qwen: Qwen Image 3 Pro
- Hvilke input og resultater er tilgængelige?
POST /v1/images/generations·qwen/qwen-image-3-pro:text,image→image- Hvilke felter bruger anmodningen?
POST /v1/images/generations·qwen/qwen-image-3-pro:model,prompt,resolution,aspect_ratio,n,input_references,provider- Hvilke grænser gælder?
POST /v1/images/generations·qwen/qwen-image-3-pro:n.minimum:1;n.maximum:6