Bouwen met CometAPIHeb je één API voor meerdere modellen nodig?Test de workflow in Playground en maak daarna een API-sleutel aan wanneer het model en de kosten passen bij je use case.
Qwen Image 3.0 verenigt tekst-naar-afbeeldinggeneratie en referentiegestuurde bewerking onder de varianten Standard (qwen-image-3.0) en Pro (qwen-image-3.0-pro). Begin met een tekstprompt, kies een uitvoergrootte, dien een afbeeldingsgeneratieaanvraag in en sla de uitvoer direct op. Voor bewerking voegt u één tot drie referentieafbeeldingen toe en een expliciete instructie wat behouden moet blijven. Controleer op CometAPI de daadwerkelijke route en compatibel verzoekschema voordat u de voorbeeldaanroepen inzet.
Belangrijkste punten
De Qwen Image 3.0 API ondersteunt tekst-naar-afbeeldinggeneratie en referentiegestuurde bewerking via Standard (qwen-image-3.0) en Pro (qwen-image-3.0-pro); native uitvoer is PNG.
Toegang tot de Qwen Image 3.0 API is beschikbaar via CometAPI. Ontwikkelaars kunnen een API-sleutel verkrijgen, het ondersteunde endpoint verifiëren en afbeeldingsgeneratie integreren in hun applicaties.
Qwen Image 3.0 API-prijzen beginnen vanaf $0.024/verzoek op CometAPI, vergeleken met Alibaba Cloud Singapore-tarieven vanaf $0.030 per Standard-uitvoerafbeelding en $0.040 per Pro 1K-uitvoerafbeelding.
Gecontroleerd op duidelijkheid, bronvermelding en actuele API-terminologie.
Qwen Image 3.0-afbeeldingsbewerking ondersteunt maximaal drie referentieafbeeldingen via de native Alibaba Cloud API, terwijl genereren één tot zes outputs per verzoek ondersteunt.
Integratie van de Qwen Image 3.0 API vereist dat ontwikkelaars providerspecifieke parameters, authenticatie, factureringsunits en tijdelijke afbeeldings-URL’s verifiëren voordat zij productie-workflows inzetten.
Wat is de Qwen Image 3.0 API?
De Qwen Image 3.0 API zet tekstinstructies om in afbeeldingen en kan aangeleverde foto’s of ontwerpmaterialen transformeren. Ondersteunde scenario’s omvatten meertalige posters, e-commercefotografie, campagne-mockups, achtergrondvervanging en composietafbeeldingsbewerking.
Qwen Image 3.0 Standard (qwen-image-3.0) is de kostengerichte basis voor tekst-naar-afbeeldinggeneratie en referentiegestuurde bewerking. Overweeg deze eerst voor high-volume workflows zoals e-commerceachtergrondvariaties, visuele concepten voor sociale media en campagnemockups. Gebruik Standard bijvoorbeeld om meerdere product-achtergrondopties te produceren, controleer daarna de productgetrouwheid en selecteer de versies die het waard zijn om te verfijnen.
Qwen Image 3.0 Pro (qwen-image-3.0-pro) ondersteunt genereren en referentiegestuurde bewerking, met een duurdere native 2K-uitvoertier. Evalueer deze voor kwaliteitssensitieve deliverables zoals campagne-hero-afbeeldingen, gedetailleerde productcomposities en promotionele posters. Test bijvoorbeeld een shortlist-concept met Pro wanneer fijne details of lay-out belangrijk zijn, en vergelijk de geaccepteerde resultaten met Standard voordat u het hogere budget toewijst.
Hoe te kiezen: Begin met Standard voor kostengevoelige concepten en variaties. Test Pro met dezelfde briefing voor veeleisende definitieve assets; selecteer deze wanneer de gemeten verbetering de extra kosten rechtvaardigt. Geen van beide aanduidingen vervangt applicatiespecifiek testen van typografie, productgetrouwheid, objectaantal of lay-outnauwkeurigheid.
Specificatie
Qwen Image 3.0
Qwen Image 3.0 Pro
Model-ID
qwen-image-3.0
qwen-image-3.0-pro
Generatie/bewerking
Beide
Beide
Referentieafbeeldingen voor bewerking
1–3
1–3
Gegenereerde afbeeldingen per verzoek
1–6
1–6
Uitvoerformaat
PNG
PNG
Uitvoer-pixeloppervlak
512²–2048²
512²–2048²
Aanbevolen promptlengte
4.500 tokens
4.500 tokens
Primaire selectierationale
Kostenefficiënte throughput
Premium uitvoer-evaluatie
Welke parameters ondersteunt de Qwen Image 3.0 API?
Gebruik deze parameters met Alibaba Cloud’s native OpenAI-compatibele interface. Voeg providerspecifieke opties alleen toe aan CometAPI-verzoeken wanneer de geselecteerde route deze documenteert.
Van toepassing op beide varianten: qwen-image-3.0 (Standard) en qwen-image-3.0-pro (Pro) ondersteunen dezelfde parameters hieronder op Alibaba Cloud’s native OpenAI-compatibele interface. Selecteer de variant met model; de generatie- en bewerkingsregelaars zijn gedeeld. Dit impliceert niet identieke uitvoerkwaliteit of prijsstelling, noch garandeert het dat elke CometAPI-route alle native parameters blootlegt.
Parameter
Type/voorbeeld
Doel
model
qwen-image-3.0
Kies Standard of Pro
prompt
string
Instructie en inhoud
image
URL / base64-string of array
1–3 referenties voor bewerking; weglaten voor genereren
size
1024x1024
Uitvoerdimensies; auto waar ondersteund
n
integer 1–6
Aantal outputs per call
negative_prompt
string
Beschrijf wat vermeden moet worden
prompt_extend
boolean
Prompt herschrijven inschakelen
prompt_extend_mode
direct / agent
Agent-modus is alleen T2I
enable_thinking
boolean
Redeneercontrole, afhankelijk van enhancement-instellingen
watermark
boolean
Optioneel watermerk
seed
integer
Hulpmiddel voor reproduceerbaarheid
Voor native verzoeken moet de uitvoerbeeldverhouding tussen 1:8 en 8:1 blijven. Referentieafbeeldingen mogen maximaal 10 MB zijn, met elke zijde tussen 1 en 8.000 pixels en een verhouding langste/kortste zijde niet groter dan 10:1. Gebruik een data-URI voor Base64-invoer. Thinking vereist prompt_extend=true; agent-enhancement ondersteunt alleen text-to-image.
Een compatibel afbeeldingsverzoek plaatst generatievelden op het JSON-topniveau en formatteert dimensies als 1024x1024. Native DashScope gebruikt geneste input/parameters en schrijft dimensies vaak als 1024*1024. Een verzoek dat tussen deze endpoints wordt gekopieerd zonder conversie kan mislukken.
Hoe roept u de Qwen Image 3.0 API aan met CometAPI?
Deze walkthrough gaat uit van Python 3, een Bash-compatibele terminal, een CometAPI-account met modeltoegang en voldoende saldo. De eerste aanvraag gebruikt alleen de model- en promptvelden die in het providervoorbeeld worden getoond. Documentatie gecontroleerd op 16 oktober 2026; deze voorbeelden zijn niet uitgevoerd tegen een betaald account.
Maak inloggegevens aan
Maak een server-side API-sleutel in uw CometAPI-dashboard. Lever deze nooit mee in een web- of mobiele client.
Ontwikkelaars hebben toegang tot de Qwen Image 3.0 API in CometAPI via de gedocumenteerde route voor afbeeldingsgeneratie. Begin met de minimale aanvraag hieronder voordat u optionele parameters toevoegt.
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"}'
Sla elke geretourneerde afbeelding op
Sla het volgende script op als generate.py en voer python generate.py uit. Het dient een verzoek in, verwerkt URL- of Base64-afbeeldingsresultaten en schrijft elke afbeelding lokaal weg. Als de response taak-informatie bevat in plaats van een data-array, stopt het in plaats van een polling-endpoint te raden; gebruik het account-specifieke asynchrone contract om het voltooide resultaat op te halen.
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}")
Een succesvolle run produceert lokale afbeeldingsbestanden. Open ze om te bevestigen dat ze leesbaar zijn en overeenkomen met de gevraagde scène. Bewaar de aanvraag-ID en usage-velden in uw serverlogs zonder inloggegevens te loggen.
Hoe genereert u meerdere afbeeldingen met Qwen Image 3.0?
Op Alibaba Cloud’s native interface stelt u n in op twee tot zes voor creatieve variaties. Voor CometAPI schakelt u n alleen in nadat u ondersteuning op uw geselecteerde route hebt bevestigd. Valideer elke geretourneerde asset afzonderlijk; een grotere n garandeert niet dat elk resultaat downstream-review doorstaat.
U kunt tot 6 afbeeldingen genereren in één verzoek met Qwen Image 3.0 door de parameter n in te stellen. Dit werkt met zowel qwen-image-3.0 als qwen-image-3.0-pro, voor tekst-naar-afbeeldinggeneratie en afbeeldingsbewerking. De standaardwaarde is slechts één afbeelding.
Er zijn twee hoofdmanieren om dit te doen: gebruik een grafische interface als uw platform de optie biedt, of roep de API rechtstreeks aan.
Meerdere afbeeldingen genereren met de API
Open de API-documentatie.
Haal een API-sleutel op uit de QwenCloud-console/ CometAPI.
Selecteer qwen-image-3.0 of qwen-image-3.0-pro.
Stel n in op het aantal gewenste afbeeldingen, van 1 tot 6.
Dien uw prompt in en sla de geretourneerde afbeeldingen op.
Stel bijvoorbeeld "n": 4 in om vier variaties van dezelfde prompt aan te vragen.
Python-voorbeeld
Hier is een klaar-om-te-aanpassen voorbeeld met de OpenAI-compatibele 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!")
Installeer eerst de vereiste pakketten:
pip install openai requests
De API retourneert voor elk resultaat een afbeeldings-URL. Gegenereerde afbeeldings-URL’s zijn tijdelijk, dus download de afbeeldingen direct.
Belangrijke instellingen
Parameter
Wat het doet
n=4
Genereert vier uitvoerafbeeldingen
model="qwen-image-3.0-pro"
Selecteert het Pro-model
size="1024x1024"
Vraagt vierkante afbeeldingen aan
seed=12345
Helpt resultaten reproduceerbaarder te maken
negative_prompt
Sluit ongewenste visuele elementen uit
Het maximum aantal outputs is zes per verzoek. Houd er rekening mee dat het aanvragen van meer afbeeldingen de generatiekosten verhoogt.
Een belangrijk verschil: n=4 vraagt vier variaties van één prompt. Als u vier verschillende prompts wilt, moet u afzonderlijke verzoeken indienen of een loop over uw prompts automatiseren.
Hoe bewerkt u afbeeldingen met Qwen Image 3.0?
Een bewerking combineert één tot drie afbeeldingsreferenties met instructies. Leg zowel de gewenste transformatie uit als wat niet mag veranderen—bijvoorbeeld het productlabel, de kleur, de camerapositie of de verpakkingsgeometrie.
Het volgende voorbeeld gebruikt Alibaba Cloud-credentials en het JSON-afbeeldingsveld voor bewerking. Maak een regionale Model Studio-sleutel, verkrijg uw workspace-ID en configureer het bijpassende endpoint. Vervang een CometAPI-sleutel niet in deze aanvraag.
De referentieafbeelding hieronder komt rechtstreeks uit het officiële API-voorbeeld. Het is een invoerafbeelding, niet een gegenereerd resultaat uit dit artikel.
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())
Het native compatibele endpoint gebruikt JSON op /images/generations, niet multipart-uploads op /images/edits. Het ondersteunt geen masks of streaming. Lees de geretourneerde data-array en sla elke URL op met dezelfde download-loop als hierboven.
Voor twee referenties voegt u twee URL’s toe in de image-array en specificeert u hun rollen in de prompt (bijv. product uit afbeelding één, kameropstelling uit afbeelding twee). De Qwen Image 3.0-serie accepteert niet meer dan drie referentieafbeeldingen; gebruik een ander model of preprocessing-workflow voor grotere bronsets.
Wat kost de Qwen Image 3.0 API?
Qwen Image 3.0 API-prijzen variëren per modelvariant, uitvoerresolutie en provider. De onderstaande tabel vult de oorspronkelijke vergelijking van Alibaba Cloud Singapore aan met de CometAPI-tarieven uit de door de reviewer bijgevoegde prijstabel. De bijlage vermeldt uitvoerprijzen in USD per afbeelding en een korting van 20% voor alle vier model-/resolutiecombinaties. Deze aangeleverde tarieven zijn niet onafhankelijk opnieuw gevalideerd tegen live accountfacturering; bevestig de toepasselijke tariefkaart vóór productiegebruik.
Standard: $2.40; Pro: $3.20 voor 100 uitvoerafbeeldingen*
1.000 succesvolle 2K-outputs
$30.00
$75.00
Standard: $24.00; Pro: $60.00 voor 1.000 uitvoerafbeeldingen*
Factureringsunit
Invoer/uitvoerafbeelding
Invoer/uitvoerafbeelding
Per factureerbare invoerreferentieafbeelding en succesvolle uitvoerafbeelding, volgens de aangeleverde prijstabel
CometAPI-korting op uitvoerprijs
20% bij 1K en 2K
20% bij 1K en 2K
Invoer- en uitvoertarieven zijn 80% van de corresponderende officiële beeldprijzen in de aangeleverde tabel
*De volumecases hierboven beslaan alleen uitvoerafbeeldingen: 100 Standard 1K-afbeeldingen kosten $2.40 en 100 Pro 1K-afbeeldingen kosten $3.20; 1.000 Standard 2K-afbeeldingen kosten $24.00 en 1.000 Pro 2K-afbeeldingen kosten $60.00. Voor bewerking voegt u $0.0024 toe per factureerbare invoerreferentieafbeelding. Regels voor mislukte jobs, belastingen en account-specifieke aanpassingen zijn uitgesloten.
Gebruik de aangeleverde invoer- en uitvoerbeeldtarieven om beeldkosten voor beide providers als volgt te schatten:
Voor een job die wordt gefactureerd voor twee invoerreferentieafbeeldingen en drie succesvolle Standard 1K-outputs zijn de beeldkosten bij Alibaba Cloud (2 × $0.0030) + (3 × $0.0300) = $0.0960. De corresponderende CometAPI-beeldkosten zijn (2 × $0.0024) + (3 × $0.0240) = $0.0768, gebaseerd op de aangeleverde tarieven.
CometAPI rekent $0.0024 per invoerreferentieafbeelding voor beide varianten. Uitvoerprijzen zijn $0.0240 per Standard-afbeelding bij 1K of 2K, $0.0320 per Pro-afbeelding bij 1K, en $0.0600 per Pro-afbeelding bij 2K. De aangeleverde tabel vermeldt elk invoer- en uitvoertarief 20% onder het corresponderende officiële tarief. Voor dezelfde factureerbare aantallen zijn deze beeldkosten daarom 20% lager; aanvullende kosten of accountvoorwaarden kunnen de uiteindelijke factuur wijzigen.
Voor productie-begroting: verifieer de geselecteerde variant, beeldresolutie, kosten voor referentieafbeeldingen, aantal outputs per verzoek en toepasselijke accountkortingen voordat u totale gebruikskosten schat.
Hoe gaat u om met Qwen Image 3.0 API-fouten?
Symptoom
Waarschijnlijke oorzaak
Actie
401/403
Ongeldige sleutel of verkeerde regio
Controleer credential, permissies en deploylocatie
400 invalid image
Verkeerd aantal/type referenties
Gebruik 1–3 afbeeldingen, geldige URL/base64, ondersteunde formats
400 invalid size
Niet-ondersteund oppervlak/beeldverhouding of scheidingsteken
Normaliseer dimensies voor het endpoint
Unexpected JSON
Verkeerd endpoint of responsecontract
Log responsevelden en pas parser aan
Expired image URL
Afbeelding niet opgeslagen vóór verloop
Download en sla op zodra geproduceerd
Unexpected bill
Referentieafbeeldingen of uitvoertier niet meegerekend
Gebruik image usage-velden en actuele tariefkaart
Inconsistent brand text
Generatieve beperkingen
Gebruik review-gates of postproductie tekstoverlay
FAQ
Moet ik een Qwen Image 3.0-aanvraag opnieuw proberen na een timeout?
Een cliënt-timeout bewijst niet dat de generatie is gestopt. Bewaar eventuele aanvraag- of taak-ID, controleer de jobgeschiedenis van de provider of de gedocumenteerde status-API, en bepaal of er al uitvoer bestaat voordat u opnieuw indient. Blinde retries kunnen dubbele jobs en extra kosten veroorzaken. Gebruik begrensde retries voor tijdelijke fouten en volg waar beschikbaar de idempotency-richtlijnen van de provider.
Hoe gebruik ik lokale referentieafbeeldingen met Qwen Image 3.0?
Voor de native compatibele interface leest u het bestand als bytes, codeert u het Base64 en plakt u een data-URI zoals data:image/png;base64, ervoor. Plaats die volledige string in image. Base64-invoer moet nog steeds aan de afbeeldingsgrootte- en dimensielimieten voldoen; een lokaal bestandspad is geen URL die de service kan ophalen.
Hoe geef ik Qwen-specifieke opties door via een OpenAI-SDK?
Houd standaard beeldvelden in hun gebruikelijke SDK-argumenten en plaats Model Studio-uitbreidingsvelden, zoals image en prompt_extend, in extra_body. Ruwe HTTP-verzoeken plaatsen deze velden direct op het JSON-topniveau. Deze richtlijn is van toepassing op de native compatibele interface; controleer de geselecteerde CometAPI-route voordat u providerspecifieke opties doorstuurt.
Wat moet ik doen wanneer Qwen Image 3.0 minder afbeeldingen retourneert dan aangevraagd?
Sla de succesvolle outputs eerst op en noteer het daadwerkelijke aantal. Voor native Alibaba Cloud-facturering volgen uitvoerkosten succesvolle gegenereerde afbeeldingen. Als aanvullende assets nodig zijn, vraag dan alleen de ontbrekende hoeveelheid aan nadat u de response en usage-record hebt gecontroleerd; CometAPI-facturering moet worden verzoend met de eigen accountvoorwaarden.
Conclusie
Qwen Image 3.0 is een praktische keuze voor teams die generatie en referentiegestuurde bewerkingen binnen één modelfamilie nodig hebben. Gebruik Standard als kostengerichte basis, test Pro voor meer veeleisende 2K- of creatieve taken, en meet de kosten van geaccepteerde outputs in plaats van te oordelen op prijs per verzoek. Begin met de minimale generatieaanroep, bewaar de outputs, en voeg vervolgens bewerking of meerdere outputs toe via het juiste providercontract. Houd credentials en verzoekschema’s gescheiden, behandel fouten expliciet en reconcilieer image usage met de geselecteerde tariefkaart.
