Byg med CometAPIHar du brug for én API til flere modeller?Test workflowet i Playground, og opret derefter en API-nøgle, når model og pris passer til dit brugsscenarie.
Qwen Image 3.0 samler tekst-til-billede-generering og referencebaseret redigering under Standard (qwen-image-3.0) og Pro (qwen-image-3.0-pro) varianterne. Start med en tekstprompt, vælg en outputstørrelse, send en billedgenereringsanmodning, og gem outputtet med det samme. Til redigering skal du inkludere én til tre referencebilleder og en eksplicit bevaringsinstruktion. På CometAPI skal du verificere den faktiske rute og kompatible anmodningsskema, før du implementerer de eksempelopkald.
Key Takeaways
Qwen Image 3.0 API understøtter tekst-til-billede-generering og referencebaseret redigering via Standard (qwen-image-3.0) og Pro (qwen-image-3.0-pro); native output er PNG.
Adgang til Qwen Image 3.0 API er tilgængelig via CometAPI. Udviklere kan få en API-nøgle, verificere den understøttede endpoint og integrere billedgenerering i deres applikationer.
Priser for Qwen Image 3.0 API starter ved $0.024/anmodning på CometAPI, sammenlignet med Alibaba Cloud Singapore-priser fra $0.030 pr. Standard-outputbillede og $0.040 pr. Pro 1K-outputbillede.
Gennemgået for klarhed, kildeangivelse og aktuel API-terminologi.
Qwen Image 3.0 billedredigering understøtter op til tre referencebilleder via den native Alibaba Cloud API, mens generering understøtter én til seks outputs pr. anmodning.
Integration af Qwen Image 3.0 API kræver, at udviklere verificerer udbyderspecifikke parametre, autentificering, afregningsenheder og midlertidige billed-URL'er, før produktionsarbejdsgange implementeres.
What Is the Qwen Image 3.0 API?
Qwen Image 3.0 API omsætter tekstinstruktioner til billeder og kan transformere medsendte fotografier eller designaktiver. Understøttede scenarier inkluderer flersprogede plakater, e-handelsfotografering, kampagnemockups, baggrundsudskiftning og sammensat billedredigering.
Qwen Image 3.0 Standard (qwen-image-3.0) er den omkostningsfokuserede basis for tekst-til-billede-generering og referencebaseret redigering. Overvej den først til højvolumen-arbejdsgange som e-handelsbaggrundsvariationer, visuelle udkast til sociale medier og udforskning af kampagnekoncepter. Brug f.eks. Standard til at producere flere produkt-baggrundsmuligheder, gennemgå produktfidelitet og udvælg de versioner, der er værd at finpudse.
Qwen Image 3.0 Pro (qwen-image-3.0-pro) understøtter generering og referencebaseret redigering, med et dyrere native 2K-outputniveau. Evaluer den til kvalitetsfølsomme leverancer såsom kampagnens hero-billeder, detaljerede produktkompositioner og reklamemasker. Test f.eks. et shortlistet koncept med Pro, når fine detaljer eller layout er afgørende, og sammenlign de accepterede resultater med Standard, før du forpligter det større budget.
How to choose: Start med Standard til omkostningsfølsomme udkast og variationer. Test Pro på samme brief for krævende endelige aktiver; vælg den, når den målte forbedring retfærdiggør den ekstra omkostning. Ingen af betegnelserne erstatter applikationsspecifik test af typografi, produktfidelitet, objektantal eller layoutnøjagtighed.
Specifikation
Qwen Image 3.0
Qwen Image 3.0 Pro
Model-ID
qwen-image-3.0
qwen-image-3.0-pro
Generering/redigering
Begge
Begge
Referencebilleder til redigering
1–3
1–3
Genererede billeder pr. anmodning
1–6
1–6
Outputformat
PNG
PNG
Output-pixelareal
512²–2048²
512²–2048²
Anbefalet promptlængde
4,500 tokens
4,500 tokens
Primær udvælgelsesbegrundelse
Omkostningseffektiv kapacitet
Premium-outputevaluering
What Parameters Does Qwen Image 3.0 API Support?
Brug disse parametre med Alibaba Clouds native OpenAI-kompatible interface. Tilføj udbyderspecifikke muligheder til CometAPI-anmodninger kun når den valgte rute dokumenterer dem.
Gælder for begge varianter: qwen-image-3.0 (Standard) og qwen-image-3.0-pro (Pro) understøtter de samme parametre nedenfor på Alibaba Clouds native OpenAI-kompatible interface. Vælg varianten med model; genererings- og redigeringskontrollerne er fælles. Dette indebærer ikke identisk outputkvalitet eller prisfastsættelse, eller garanterer at hver CometAPI-rute eksponerer alle native parametre.
Parameter
Type/eksempel
Formål
model
qwen-image-3.0
Vælg Standard eller Pro
prompt
string
Instruktion og indhold
image
URL / base64 string or array
1–3 referencer til redigering; udelad ved generering
size
1024x1024
Outputdimensioner; automatisk hvor understøttet
n
integer 1–6
Output pr. kald
negative_prompt
string
Beskriv hvad der skal undgås
prompt_extend
boolean
Aktiver omskrivning af prompt
prompt_extend_mode
direct / agent
Agenttilstand er kun T2I
enable_thinking
boolean
Kontrol af ræsonnering, afhænger af forbedringsindstillinger
watermark
boolean
Valgfri vandmærke
seed
integer
Hjælp til reproducerbarhed
For native anmodninger skal output-aspektforholdet forblive mellem 1:8 og 8:1. Referencebilleder må højst være 10 MB, med hver side mellem 1 og 8.000 pixels og et længste-til-korteste-sideforhold på højst 10:1. Brug en data-URI til Base64-input. Thinking kræver prompt_extend=true; agentforbedring understøtter kun tekst-til-billede.
En kompatibel billedeanmodning placerer genereringsfelter på JSON-topniveauet og formaterer dimensioner som 1024x1024. Native DashScope bruger indlejret input/parameters og skriver ofte dimensioner som 1024*1024. En anmodning kopieret mellem disse endpoints uden konvertering kan fejle.
How Do You Call Qwen Image 3.0 API with CometAPI?
Denne gennemgang forudsætter Python 3, en Bash-kompatibel terminal, en CometAPI-konto med modeladgang og tilstrækkelig saldo. Den første anmodning bruger kun felterne model og prompt vist i udbyderens eksempel. Dokumentation kontrolleret 16. oktober 2026; disse eksempler er ikke blevet eksekveret mod en betalt konto.
Create credentials
Opret en server-side API-nøgle i dit CometAPI-dashboard. Send den aldrig med i en web- eller mobilklient.
Udviklere kan få adgang til Qwen Image 3.0 API i CometAPI ved hjælp af den dokumenterede billedgenereringsrute. Begynd med den minimale anmodning nedenfor, før du introducerer valgfrie parametre.
Gem følgende script som generate.py og kør python generate.py. Det sender en anmodning, håndterer URL- eller Base64-billedresultater og skriver hvert billede lokalt. Hvis svaret indeholder opgaveinformation i stedet for et data-array, stopper det i stedet for at gætte et polling-endpoint; brug den kontospecifikke asynkrone kontrakt til at hente det færdige 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": "En solrig boghandlercafé, redaktionelt fotografi"}, 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"Ingen synkrone billeder; inspicér task-/fejl-felter: {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"Billede {index} har ingen URL eller Base64-payload") path = Path(f"qwen_image_{index}.png") path.write_bytes(content) print(f"Gemt {path}")
Et vellykket run producerer lokale billedfiler. Åbn dem for at bekræfte, at de kan læses og matcher den ønskede scene. Bevar anmodnings-id’et og brugsfelterne i dine serverlogs uden at logge legitimationsoplysninger.
How Do You Generate Multiple Images with Qwen Image 3.0?
På Alibaba Clouds native interface skal du sætte n til to til seks for kreative variationer. For CometAPI skal du kun aktivere n efter at have bekræftet støtte på din valgte rute. Validér hvert returneret aktiv separat; et større n garanterer ikke, at alle resultater passerer downstream-gennemgang.
Du kan generere op til 6 billeder i en enkelt anmodning med Qwen Image 3.0 ved at sætte parameteren n. Dette fungerer med både qwen-image-3.0 og qwen-image-3.0-pro, til tekst-til-billede-generering og billedredigering. Standard er kun ét billede.
Der er to hovedmåder at gøre det på: brug en grafisk grænseflade, hvis din platform eksponerer muligheden, eller kald API’et direkte.
Generate multiple images using the API
Åbn API-dokumentationen.
Få en API-nøgle fra QwenCloud-konsollen/ CometAPI.
Vælg qwen-image-3.0 eller qwen-image-3.0-pro.
Sæt n til det antal billeder, du ønsker, fra 1 til 6.
Send din prompt og gem de returnerede billeder.
For eksempel: sæt "n": 4 for at anmode om fire variationer af samme prompt.
Python example
Her er et klar-til-tilpasningseksempel med den OpenAI-kompatible 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=( "En hyggelig japansk café på en regnfuld aften, " "varme glødende lys, filmisk fotografering, " "rige detaljer, realistiske refleksioner" ),
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("Færdig med at generere billeder!")
Installer de nødvendige pakker først:
pip install openai requests
API’en returnerer en billed-URL for hvert resultat. Genererede billed-URL’er er midlertidige, så download billederne hurtigt.
Important settings
Parameter
Funktion
n=4
Genererer fire outputbilleder
model="qwen-image-3.0-pro"
Vælger Pro-modellen
size="1024x1024"
Anmoder om kvadratiske billeder
seed=12345
Hjælper med at gøre resultaterne mere reproducerbare
negative_prompt
Udelukker uønskede visuelle elementer
Det maksimale outputantal er seks pr. anmodning. Husk, at anmodning om flere billeder øger genereringsomkostningen.
En vigtig forskel: n=4 anmoder om fire variationer af én prompt. Hvis du ønsker fire forskellige prompts, skal du lave separate anmodninger eller automatisere en løkke over dine prompts.
How Do You Edit Images with Qwen Image 3.0?
En redigering kombinerer én til tre billedreferencer med instruktioner. Forklar både den ønskede transformation og hvad der ikke må ændres—f.eks. produktlabel, farve, kamera vinkel eller emballagegeometri.
Det næste eksempel bruger Alibaba Cloud-legitimationsoplysninger og deres JSON-billedfelt til redigering. Opret en regional Model Studio-nøgle, hent dit workspace-id, og konfigurer den matchende endpoint. Erstat ikke en CometAPI-nøgle i denne anmodning.
Referencebilledet nedenfor kommer direkte fra det officielle API-eksempel. Det er et inputbillede, ikke et genereret resultat fra denne artikel.
import os, requests
endpoint = os.environ["ALIBABA_IMAGE_ENDPOINT"]
# documented regional .../images/generations endpoint
payload = {
"model": "qwen-image-3.0",
"prompt": "Skift outfittet til en kulgrå business-suit i en café. Bevar ansigtet og frisuren.",
"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())
Den native kompatible endpoint bruger JSON på /images/generations, ikke multipart uploads på /images/edits. Den understøtter ikke masker eller streaming. Læs det returnerede data-array og gem hver URL ved hjælp af den samme downloadløkke vist ovenfor.
Ved to referencer skal du inkludere to URL’er i image-arrayet og angive deres roller i prompten (f.eks. produkt fra billede ét, rumindstilling fra billede to). Qwen Image 3.0-serien accepterer højst tre referencebilleder; brug en anden model eller en forbehandlingsarbejdsgang til større kildesæt.
How Much Does Qwen Image 3.0 API Cost?
Priser for Qwen Image 3.0 API varierer efter modelvariant, outputopløsning og udbyder. Tabellen nedenfor supplerer den oprindelige Alibaba Cloud Singapore-sammenligning med CometAPI-taksterne vist i anmelderens vedhæftede pristabel. Vedhæftningen viser outputpriser i USD pr. billede og 20% rabat for alle fire model/opløsningskombinationer. Disse tilvejebragte takster er ikke uafhængigt genvalideret mod live kontofakturering; bekræft det gældende ratekort før produktionsbrug.
Prispost
Alibaba Cloud Standard
Alibaba Cloud Pro
CometAPI
Input-referencebillede
$0.003/image
$0.003/image
$0.0024/image for Standard and Pro
Vellykket 1K-output
$0.030/image
$0.040/image
Standard: $0.0240/image; Pro: $0.0320/image
Vellykket 2K-output
$0.030/image
$0.075/image
Standard: $0.0240/image; Pro: $0.0600/image
100 vellykkede 1K-output
$3.00
$4.00
Standard: $2.40; Pro: $3.20 for 100 outputbilleder*
1.000 vellykkede 2K-output
$30.00
$75.00
Standard: $24.00; Pro: $60.00 for 1,000 outputbilleder*
Faktureringsenhed
Input/output image
Input/output image
Per billable input reference image and successful output image, according to the supplied pricing table
CometAPI-rabat på outputpris
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
*Volumene eksemplerne ovenfor dækker kun outputbilleder: 100 Standard 1K-billeder koster $2.40 og 100 Pro 1K-billeder koster $3.20; 1.000 Standard 2K-billeder koster $24.00 og 1.000 Pro 2K-billeder koster $60.00. Til redigering lægges $0.0024 pr. fakturerbart input-referencebillede til. Regler for fejlede jobs, skatter og kontospecifikke justeringer er udeladt.
Ved brug af de tilvejebragte input- og outputbilledrater kan billedomkostninger estimeres for begge udbydere som følger:
For et job faktureret for to input-referencebilleder og tre vellykkede Standard 1K-output er Alibaba Cloud-billedomkostningerne (2 × $0.0030) + (3 × $0.0300) = $0.0960. De tilsvarende CometAPI-billedomkostninger er (2 × $0.0024) + (3 × $0.0240) = $0.0768, baseret på de tilvejebragte takster.
CometAPI tager $0.0024 pr. input-referencebillede for begge varianter. Outputpriserne er $0.0240 pr. Standardbillede ved 1K eller 2K, $0.0320 pr. Probillede ved 1K, og $0.0600 pr. Probillede ved 2K. Den tilvejebragte tabel viser hver input- og outputrate 20% under den tilsvarende officielle billedpris. For de samme fakturerbare billedantal er disse billedomkostninger derfor 20% lavere; yderligere gebyrer eller kontobetingelser kan ændre den endelige faktura.
Til budgettering i produktion skal du verificere den valgte variant, billedopløsning, referencebillede-gebyrer, antal output pr. anmodning og gældende kontorabatter, før du estimerer de samlede brugsomkostninger.
How Do You Handle Qwen Image 3.0 API Errors?
Symptom
Sandsynlig årsag
Handling
401/403
Ugyldig nøgle eller forkert region
Tjek legitimationsoplysninger, tilladelser og lokation
400 invalid image
Forkert antal/type referencer
Brug 1–3 billeder, gyldig URL/base64, understøttede formater
400 invalid size
Ikke-understøttet areal/aspektforhold eller separator
Normalisér dimensioner til endpoint
Unexpected JSON
Forkert endpoint eller svarkontrakt
Log svarfelter og tilpas parser
Expired image URL
Billede ikke gemt før udløb
Download og gem så snart det er produceret
Unexpected bill
Referencebilleder eller output-niveau ikke medregnet
Brug billedbrugsfelter og aktuelt ratekort
Inconsistent brand text
Generative begrænsninger
Brug review-gates eller efterproduktionstekst-overlay
FAQ
Should I retry a Qwen Image 3.0 request after a timeout?
En klient-timeout beviser ikke, at genereringen stoppede. Bevar enhver anmodnings- eller opgaveidentifikator, tjek udbyderens jobhistorik eller dokumenterede status-API, og afgør om output allerede findes, før du sender igen. Blinde retries kan skabe duplikatjobs og ekstra omkostninger. Brug begrænsede retries til forbigående fejl og følg udbyderens idempotensvejledning, hvor den er tilgængelig.
How can I use local reference images with Qwen Image 3.0?
Til den native kompatible interface: læs filen som bytes, Base64-kod den, og foranstil en data-URI såsom data:image/png;base64,. Sæt den komplette streng i image. Base64-input skal stadig opfylde billedstørrelses- og dimensionsgrænser; en lokal filsti er ikke en URL, som tjenesten kan hente.
How do I pass Qwen-specific options through an OpenAI SDK?
Hold standard billedfelter i deres sædvanlige SDK-argumenter og læg Model Studio-udvidelsesfelter, såsom image og prompt_extend, i extra_body. Rå HTTP-anmodninger placerer disse felter direkte på JSON-topniveauet. Denne vejledning gælder for den native kompatible interface; tjek den valgte CometAPI-rute, før du videresender udbyderspecifikke muligheder.
What should I do when Qwen Image 3.0 returns fewer images than requested?
Gem de vellykkede outputs først og registrer det faktiske antal. For native Alibaba Cloud-fakturering følger outputgebyrer vellykkeligt genererede billeder. Hvis der er behov for yderligere aktiver, skal du kun anmode om den manglende mængde efter at have tjekket svaret og brugsregistreringen; CometAPI-fakturering skal afstemmes mod sine egne kontobetingelser.
Conclusion
Qwen Image 3.0 er et praktisk valg for teams, der har brug for generering og referencebaserede redigeringer inden for én modelfamilie. Brug Standard som omkostningsfokuseret basis, test Pro til mere krævende 2K- eller kreative opgaver, og mål accepteret-output-omkostning i stedet for at vurdere ud fra pris pr. anmodning alene. Start med det minimale genereringsopkald, persistér outputs, og tilføj dernæst redigering eller flere outputs gennem den passende udbyderkontrakt. Hold legitimationsoplysninger og anmodningsskemaer adskilt, håndtér fejl eksplicit, og afstem billedbrug med det valgte ratekort.
Sådan bruger du Qwen Image 3.0 API: generering, redigering og prissætning - CometAPI
