Bygg med CometAPITrenger du ett API for flere modeller?Test arbeidsflyten i Playground, og opprett deretter en API-nøkkel når modellen og kostnaden passer bruksområdet ditt.
Qwen Image 3.0 forener tekst-til-bilde-generering og referansestyrt redigering under variantene Standard (qwen-image-3.0) og Pro (qwen-image-3.0-pro). Start med en tekstprompt, velg utstørrelse, send en bildegenereringsforespørsel og lagre resultatet umiddelbart. For redigering legger du ved én til tre referansebilder og en eksplisitt bevaringsinstruks. På CometAPI bør du verifisere faktisk rute og kompatibelt forespørselsskjema før du tar i bruk eksempelkall.
Key Takeaways
Qwen Image 3.0-API-et støtter tekst-til-bilde-generering og referansestyrt redigering via Standard (qwen-image-3.0) og Pro (qwen-image-3.0-pro); standard utdataformat er PNG.
Tilgang til Qwen Image 3.0-API er tilgjengelig via CometAPI. Utviklere kan skaffe en API-nøkkel, verifisere støttet endepunkt og integrere bildegenerering i applikasjonene sine.
Qwen Image 3.0-API-priser starter på $0.024/forespørsel på CometAPI, sammenlignet med Alibaba Cloud Singapore som starter på $0.030 per Standard-utgangsbilde og $0.040 per Pro 1K-utgangsbilde.
Gjennomgått for klarhet, kildeangivelse og gjeldende API-terminologi.
Bilderedigering i Qwen Image 3.0 støtter opptil tre referansebilder via det opprinnelige Alibaba Cloud-API-et, mens generering støtter én til seks utganger per forespørsel.
Integrasjon mot Qwen Image 3.0-API krever at utviklere verifiserer leverandørspesifikke parametere, autentisering, faktureringsenheter og midlertidige bilde-URL-er før produksjonsutrulling.
What Is the Qwen Image 3.0 API?
Qwen Image 3.0-API-et forvandler tekstinstruksjoner til bilder og kan transformere innsendte fotografier eller designmateriale. Støttede scenarier inkluderer flerspråklige plakater, e-handelsfotografering, kampanjemockuper, bakgrunnsbytte og redigering av sammensatte bilder.
Qwen Image 3.0 Standard (qwen-image-3.0) er kostnadsfokusert grunnnivå for tekst-til-bilde-generering og referansestyrt redigering. Vurder den først for volumbaserte arbeidsflyter som e-handelsvariasjoner av bakgrunner, utkast til visuelle for sosiale medier og utforsking av kampanjekonsepter. Bruk for eksempel Standard til å produsere flere bakgrunnsalternativer for et produkt, vurder produktfidelitet og velg versjonene som er verdt å foredle.
Qwen Image 3.0 Pro (qwen-image-3.0-pro) støtter generering og referansestyrt redigering, med en høyere priset 2K-utdatanivå. Vurder den for kvalitetssensitive leveranser som hero-bilder i kampanjer, detaljerte produktkomposisjoner og promoteringplakater. Test for eksempel et shortlistet konsept med Pro når fin detalj eller layout er viktig, og sammenlign aksepterte resultater med Standard før du forplikter et større budsjett.
Hvordan velge: Start med Standard for kostnadssensitive utkast og variasjoner. Test Pro på samme brief for krevende sluttleveranser; velg den når den målte forbedringen rettferdiggjør den ekstra kostnaden. Ingen av betegnelsene erstatter applikasjonsspesifikk testing av typografi, produktfidelitet, antall objekter eller layoutnøyaktighet.
Specification
Qwen Image 3.0
Qwen Image 3.0 Pro
Model ID
qwen-image-3.0
qwen-image-3.0-pro
Generation / editing
Begge
Begge
Reference images for editing
1–3
1–3
Generated images per request
1–6
1–6
Output format
PNG
PNG
Output pixel area
512²–2048²
512²–2048²
Recommended prompt length
4,500 tokens
4,500 tokens
Primary selection rationale
Kostnadseffektiv gjennomstrømning
Premium utdatavurdering
What Parameters Does Qwen Image 3.0 API Support?
Bruk disse parametrene med Alibaba Clouds opprinnelige OpenAI-kompatible grensesnitt. Legg kun til leverandørspesifikke alternativer i CometAPI-forespørsler når valgt rute dokumenterer dem.
Gjelder begge varianter: qwen-image-3.0 (Standard) og qwen-image-3.0-pro (Pro) støtter de samme parameterne listet nedenfor på Alibaba Clouds opprinnelige OpenAI-kompatible grensesnitt. Velg variant med model; genererings- og redigeringskontrollene er felles. Dette innebærer ikke identisk utdatakvalitet eller prising, og garanterer ikke at alle CometAPI-ruter eksponerer alle opprinnelige parametere.
Parameter
Type / example
Purpose
model
qwen-image-3.0
Velg Standard eller Pro
prompt
string
Instruksjon og innhold
image
URL / base64 string or array
1–3 referanser for redigering; utelat for generering
size
1024x1024
Utdatadimensjoner; auto der det støttes
n
integer 1–6
Utganger per kall
negative_prompt
string
Beskriv hva som skal unngås
prompt_extend
boolean
Aktiver omskriving av prompt
prompt_extend_mode
direct / agent
Agent-modus er kun T2I
enable_thinking
boolean
Styring av resonnering, avhengig av forbedringer
watermark
boolean
Valgfri vannmerking
seed
integer
Hjelp til reproduserbarhet
For opprinnelige forespørsler må sideforholdet være mellom 1:8 og 8:1. Referansebilder må være maks 10 MB, med hver side mellom 1 og 8 000 piksler og et lengste-til-korteste-side-forhold på høyst 10:1. Bruk en data-URI for Base64-inndata. Resonnering krever prompt_extend=true; agentforbedring støtter kun tekst-til-bilde.
En kompatibel bildeforespørsel plasserer genereringsfelter på øverste nivå i JSON og formaterer dimensjoner som 1024x1024. Opprinnelig DashScope bruker nestet input/parameters og skriver ofte dimensjoner som 1024*1024. En forespørsel kopiert mellom disse endepunktene uten konvertering kan feile.
How Do You Call Qwen Image 3.0 API with CometAPI?
Denne gjennomgangen forutsetter Python 3, et Bash-kompatibelt terminalmiljø, en CometAPI-konto med modelltilgang og tilstrekkelig saldo. Den første forespørselen bruker kun feltene model og prompt som vist i leverandørens eksempel. Dokumentasjon sjekket 16. oktober 2026; disse eksemplene er ikke kjørt mot en betalt konto.
Create credentials
Opprett en server-side API-nøkkel i CometAPI-dashbordet. Aldri legg den i en web- eller mobilklient.
Utviklere kan få tilgang til Qwen Image 3.0-API i CometAPI ved å bruke den dokumenterte bildegenereringsruten. Start med den minimale forespørselen under før du innfører valgfrie parametere.
curl --fail-with-body https://api.cometapi.com/v1/images/generations \ -H "Authorization: Bearer $COMETAPI_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"qwen-image-3.0","prompt":"Premium skincare bottle on a stone pedestal, gentle studio lighting"}'
Save every returned image
Lagre følgende skript som generate.py og kjør python generate.py. Det sender en forespørsel, håndterer URL- eller Base64-bilderesultater og skriver hvert bilde lokalt. Hvis responsen inneholder oppgaveinformasjon i stedet for en data-tabell, stopper det i stedet for å gjette et polling-endepunkt; bruk den kontospesifikke asynkrone kontrakten for å hente ferdig resultat.
import base64import osfrom pathlib import Pathimport requestsresponse = requests.post( "https://api.cometapi.com/v1/images/generations", headers={"Authorization": f"Bearer {os.environ['COMETAPI_KEY']}"}, json={"model": "qwen-image-3.0", "prompt": "A sunny bookstore cafe, editorial photograph"}, timeout=(15, 600),)response.raise_for_status()result = response.json()images = result.get("data")if not isinstance(images, list) or not images: raise RuntimeError(f"No synchronous images; inspect task/error fields: {list(result)}")for index, item in enumerate(images, 1): if item.get("url"): download = requests.get(item["url"], timeout=(15, 120)) download.raise_for_status() content = download.content elif item.get("b64_json"): content = base64.b64decode(item["b64_json"], validate=True) else: raise RuntimeError(f"Image {index} has no URL or Base64 payload") path = Path(f"qwen_image_{index}.png") path.write_bytes(content) print(f"Saved {path}")
En vellykket kjøring produserer lokale bildefiler. Åpne dem for å bekrefte at de er lesbare og samsvarer med den forespurte scenen. Bevar forespørsels-ID og brukingsfelter i serverloggene dine uten å logge legitimasjon.
How Do You Generate Multiple Images with Qwen Image 3.0?
På Alibaba Clouds opprinnelige grensesnitt setter du n til to til seks for kreative variasjoner. For CometAPI aktiverer du n først etter å ha bekreftet støtte på valgt rute. Valider hver returnert ressurs separat; et høyere n garanterer ikke at alle resultater består nedstrømskontroll.
Du kan generere opptil 6 bilder i én forespørsel med Qwen Image 3.0 ved å sette parameteren n. Dette fungerer med både qwen-image-3.0 og qwen-image-3.0-pro, for tekst-til-bilde-generering og bilderedigering. Standardverdien er kun ett bilde.
Det er to hovedmåter: bruk et grafisk grensesnitt hvis plattformen eksponerer valget, eller kall API-et direkte.
Generate multiple images using the API
Åpne API-dokumentasjonen.
Få en API-nøkkel fra QwenCloud-konsollen/ CometAPI.
Velg qwen-image-3.0 eller qwen-image-3.0-pro.
Sett n til antall bilder du ønsker, fra 1 til 6.
Send inn prompten din og lagre de returnerte bildene.
For eksempel, sett "n": 4 for å be om fire variasjoner av samme prompt.
Python example
Her er et klart-til-tilpasning-eksempel ved bruk av OpenAI-kompatibelt API.
from openai import OpenAIimport requestsclient = OpenAI( api_key="YOUR_QWEN_API_KEY", base_url="https://maas.qwencloudapi.com/compatible-mode/v1")
result = client.images.generate( model="qwen-image-3.0-pro",
prompt=( "A cozy Japanese cafe on a rainy evening, " "warm glowing lights, cinematic photography, " "rich details, realistic reflections" ),
n=4,
size="1024x1024")# Save each generated image
for i, item in enumerate(result.data, start=1): response = requests.get(item.url) response.raise_for_status() with open(f"qwen_image_{i}.png", "wb")
as f:
f.write(response.content)print("Finished generating images!")
Installer nødvendige pakker først:
pip install openai requests
API-et returnerer en bilde-URL for hvert resultat. Genererte bilde-URL-er er midlertidige, så last ned bildene raskt.
Important settings
Parameter
What it does
n=4
Genererer fire utgangsbilder
model="qwen-image-3.0-pro"
Velger Pro-modellen
size="1024x1024"
Forespør firkantede bilder
seed=12345
Hjelper å gjøre resultater mer reproduserbare
negative_prompt
Ekskluderer uønskede visuelle elementer
Maksimalt antall utganger er seks per forespørsel. Husk at forespørsel om flere bilder øker genereringskostnaden.
En viktig forskjell: n=4 ber om fire variasjoner av én prompt. Hvis du vil ha fire forskjellige prompter, bør du gjøre separate forespørsler eller automatisere en løkke over promptene dine.
How Do You Edit Images with Qwen Image 3.0?
En redigering kombinerer én til tre bildereferanser med instruksjoner. Forklar både ønsket transformasjon og hva som ikke må endres—for eksempel produktetikett, farge, kameravinkel eller emballasjekonstruksjon.
Neste eksempel bruker Alibaba Cloud-legitimasjon og deres JSON image field for editing. Opprett en regional Model Studio-nøkkel, hent arbeidsområde-ID-en og konfigurer matchende endepunkt. Ikke erstatt med en CometAPI-nøkkel i denne forespørselen.
Referansebildet nedenfor kommer direkte fra det offisielle API-eksempelet. Det er et inputbilde, ikke et generert resultat fra denne artikkelen.
import os, requests
endpoint = os.environ["ALIBABA_IMAGE_ENDPOINT"]
# documented regional .../images/generations endpoint
payload = {
"model": "qwen-image-3.0",
"prompt": "Change the outfit to a charcoal business suit in a cafe. Preserve the face and hairstyle.",
"image": ["https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPYEaXdyOdv/img/33a80a19-7ac7-4c64-b0fa-7d685b7046a0.png"],
"size": "1024x1024",
"n": 1}
r = requests.post(endpoint, headers={
"Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}"}, json=payload, timeout=(15, 600))
r.raise_for_status()
print(r.json())
Det opprinnelige kompatible endepunktet bruker JSON på /images/generations, ikke multipart-opplastinger på /images/edits. Det støtter ikke masker eller strømming. Les den returnerte data-tabellen og lagre hver URL ved bruk av samme nedlastingsløkke som vist over.
For to referanser inkluderer du to URL-er i bildearrayet og spesifiserer rollene deres i prompten (f.eks. produkt fra bilde én, romsetting fra bilde to). Serien Qwen Image 3.0 aksepterer ikke mer enn tre referansebilder; bruk en annen modell eller en forhåndsbehandlingsflyt for større kildeutvalg.
How Much Does Qwen Image 3.0 API Cost?
Prisene for Qwen Image 3.0-API varierer etter modellvariant, utdataoppløsning og leverandør. Tabellen nedenfor supplerer den opprinnelige sammenligningen for Alibaba Cloud Singapore med CometAPI-satsene vist i vedlagt pristabell fra anmelderen. Vedlegget lister utdatapriser i USD per bilde og 20 % rabatt for alle fire kombinasjoner av modell/oppløsning. Disse satsene er ikke uavhengig revalidert mot faktiske kontobelastninger; bekreft gjeldende prisliste før produksjonsbruk.
Pricing item
Alibaba Cloud Standard
Alibaba Cloud Pro
CometAPI
Input reference image
$0.003/image
$0.003/image
$0.0024/image for Standard and Pro
Successful 1K output
$0.030/image
$0.040/image
Standard: $0.0240/image; Pro: $0.0320/image
Successful 2K output
$0.030/image
$0.075/image
Standard: $0.0240/image; Pro: $0.0600/image
100 successful 1K outputs
$3.00
$4.00
Standard: $2.40; Pro: $3.20 for 100 output images*
1,000 successful 2K outputs
$30.00
$75.00
Standard: $24.00; Pro: $60.00 for 1,000 output images*
Billing unit
Input/output image
Input/output image
Per billable input reference image and successful output image, according to the supplied pricing table
CometAPI output-price discount
20% at 1K and 2K
20% at 1K and 2K
Input and output rates are 80% of the corresponding official image prices in the supplied table
*The volume examples above cover output images only: 100 Standard 1K images cost $2.40 and 100 Pro 1K images cost $3.20; 1,000 Standard 2K images cost $24.00 and 1,000 Pro 2K images cost $60.00. For editing, add $0.0024 per billable input reference image. Failed-job rules, taxes, and account-specific adjustments are excluded.
Ved bruk av de oppgitte satsene for input- og utgangsbilder kan bildekostnader for begge leverandører estimeres slik:
For en jobb som faktureres for to inputreferansebilder og tre vellykkede Standard 1K-utganger, er Alibaba Cloud-bildefakturering (2 × $0.0030) + (3 × $0.0300) = $0.0960. Tilsvarende CometAPI-bildekostnader er (2 × $0.0024) + (3 × $0.0240) = $0.0768, basert på de oppgitte satsene.
CometAPI tar $0.0024 per inputreferansebilde for begge varianter. Utdataprisene er $0.0240 per Standard-bilde ved 1K eller 2K, $0.0320 per Pro-bilde ved 1K og $0.0600 per Pro-bilde ved 2K. Den oppgitte tabellen lister hver input- og utdatasats 20 % under tilsvarende offisiell bildepris. For samme antall fakturerbare bilder er disse bildekostnadene derfor 20 % lavere; tilleggsgebyrer eller kontobetingelser kan endre sluttfakturaen.
For budsjett i produksjon, verifiser valgt variant, bildeoppløsning, referansebildekostnader, antall utganger per forespørsel og relevante kontorabatter før du estimerer totale brukskostnader.
How Do You Handle Qwen Image 3.0 API Errors?
Symptom
Likely cause
Action
401/403
Ugyldig nøkkel eller feil region
Sjekk legitimasjon, tillatelser og distribusjonslokasjon
400 invalid image
Feil antall/type referanser
Bruk 1–3 bilder, gyldig URL/base64, støttede formater
400 invalid size
Ustøttet areal/sideforhold eller separator
Normaliser dimensjoner for endepunktet
Unexpected JSON
Feil endepunkt eller responskontrakt
Logg responsfelt og tilpass parser
Expired image URL
Bildet ikke lagret før utløp
Last ned og lagre så snart det produseres
Unexpected bill
Referansebilder eller utdatatrinn ikke medregnet
Bruk bildebruksfelter og gjeldende prisliste
Inconsistent brand text
Generative begrensninger
Bruk kontrollporter eller etterbehandling av tekstoverlegg
FAQ
Should I retry a Qwen Image 3.0 request after a timeout?
Et klienttidsavbrudd beviser ikke at genereringen stoppet. Bevar eventuell forespørsels- eller oppgave-ID, sjekk leverandørens jobbhistorikk eller dokumenterte status-API, og fastslå om utdata allerede eksisterer før du sender på nytt. Blinde retrier kan skape dupliserte jobber og ekstra kostnader. Bruk begrensede retrier for forbigående feil og følg leverandørens veiledning for idempotens der det finnes.
How can I use local reference images with Qwen Image 3.0?
For det opprinnelige kompatible grensesnittet, les filen som bytes, Base64-kod den og prefiks med en data-URI som data:image/png;base64,. Legg den komplette strengen i image. Base64-inndata må fortsatt oppfylle størrelses- og dimensjonsgrenser; en lokal filstilengde er ikke en URL tjenesten kan hente.
How do I pass Qwen-specific options through an OpenAI SDK?
Behold standard bildefelter i deres vanlige SDK-argumenter og legg Model Studio-utvidelsesfelter, som image og prompt_extend, i extra_body. Rå HTTP-forespørsler plasserer disse feltene direkte på øverste nivå i JSON. Denne veiledningen gjelder for det opprinnelige kompatible grensesnittet; sjekk valgt CometAPI-rute før du videresender leverandørspesifikke alternativer.
What should I do when Qwen Image 3.0 returns fewer images than requested?
Lagre de vellykkede utgangene først og registrer faktisk antall. For opprinnelig Alibaba Cloud-fakturering følger utdatakostnader de bildene som ble generert. Hvis du trenger flere ressurser, be kun om manglende antall etter å ha sjekket respons og bruksregistrering; CometAPI-fakturering må avstemmes mot egne kontobetingelser.
Conclusion
Qwen Image 3.0 er et praktisk valg for team som trenger generering og referansedrevne redigeringer i én modelfamilie. Bruk Standard som kostnadsfokusert grunnlinje, test Pro for mer krevende 2K- eller kreative oppgaver, og mål godkjent-utdatakostnad i stedet for å vurdere per-forespørselspris alene. Start med det minimale genereringskallet, persister utdataene, og legg deretter til redigering eller flere utganger via riktig leverandørkontrakt. Hold legitimasjon og forespørselsskjema separate, håndter feil eksplisitt, og avstem bildebruk med valgt prisliste.
