TL;DR
Qwen Image 3.0 vereint Text-zu-Bild-Generierung und referenzgeführtes Editing in den Varianten Standard (qwen-image-3.0) und Pro (qwen-image-3.0-pro). Beginnen Sie mit einem Textprompt, wählen Sie eine Ausgabengröße, senden Sie eine Bildgenerierungsanfrage und speichern Sie die Ausgabe umgehend. Für Bearbeitungen fügen Sie ein bis drei Referenzbilder sowie eine explizite Erhaltungsanweisung hinzu. Prüfen Sie auf CometAPI vor dem Einsatz der Beispielaufrufe die tatsächlich verfügbare Route und das kompatible Request-Schema.
Key Takeaways
- Die Qwen Image 3.0 API unterstützt Text-zu-Bild-Generierung und referenzgeführtes Editing über Standard (qwen-image-3.0) und Pro (qwen-image-3.0-pro); das native Ausgabeformat ist PNG.
- Der Zugang zur Qwen Image 3.0 API ist über die CometAPI verfügbar. Entwickler können einen API-Schlüssel erhalten, den unterstützten Endpoint verifizieren und die Bildgenerierung in ihre Anwendungen integrieren.
- Die Qwen Image 3.0 API-Preise beginnen bei $0.024/Request auf CometAPI, im Vergleich zu Alibaba Cloud Singapore mit Preisen ab $0.030 pro Standard-Ausgabebild und $0.040 pro Pro-1K-Ausgabebild.
- Qwen Image 3.0 Bildbearbeitung unterstützt bis zu drei Referenzbilder über die native Alibaba-Cloud-API, während die Generierung pro Request ein bis sechs Ausgaben unterstützt.
- Die Integration der Qwen Image 3.0 API erfordert die Verifizierung anbieterspezifischer Parameter, Authentifizierung, Abrechnungseinheiten und temporärer Bild-URLs, bevor Produktions-Workflows ausgerollt werden.
What Is the Qwen Image 3.0 API?
Die Qwen Image 3.0 API wandelt Textanweisungen in Bilder um und kann bereitgestellte Fotos oder Design-Assets transformieren. Unterstützte Szenarien umfassen mehrsprachige Poster, E‑Commerce-Fotografie, Kampagnen-Mockups, Hintergrundaustausch und Compositing-Bearbeitung.
Qwen Image 3.0 Standard (qwen-image-3.0) ist die kostenzentrierte Basis für Text-zu-Bild-Generierung und referenzgeführtes Editing. Ziehen Sie sie zuerst für hochvolumige Workflows wie E‑Commerce-Hintergrundvarianten, Social-Media-Entwurfsvisuals und Kampagnenkonzept-Erkundung in Betracht. Beispiel: Nutzen Sie Standard, um mehrere Produkt-Hintergrundoptionen zu erzeugen, prüfen Sie anschließend die Produkttreue und wählen Sie die Versionen aus, die eine Verfeinerung wert sind.
Qwen Image 3.0 Pro (qwen-image-3.0-pro) unterstützt Generierung und referenzgeführtes Editing mit einer höher bepreisten nativen 2K-Ausgabestufe. Evaluieren Sie sie für qualitätssensitive Deliverables wie Kampagnen-Hauptmotive, detaillierte Produktkompositionen und Werbeposter. Beispiel: Testen Sie ein Shortlist-Konzept mit Pro, wenn feine Details oder Layout relevant sind, und vergleichen Sie die akzeptierten Ergebnisse mit Standard, bevor Sie das größere Budget binden.
So wählen Sie: Beginnen Sie mit Standard für kostensensitive Entwürfe und Varianten. Testen Sie Pro mit derselben Aufgabenstellung für anspruchsvolle finale Assets; wählen Sie Pro, wenn die messbare Verbesserung die zusätzlichen Kosten rechtfertigt. Keine Bezeichnung ersetzt anwendungsspezifische Tests von Typografie, Produkttreue, Objektanzahl oder Layoutgenauigkeit.
| Specification | Qwen Image 3.0 | Qwen Image 3.0 Pro |
|---|---|---|
| Model ID | qwen-image-3.0 | qwen-image-3.0-pro |
| Generation / editing | Beide | Beide |
| 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 Token | 4,500 Token |
| Primary selection rationale | Kosteneffizienter Durchsatz | Bewertung hochwertiger Ergebnisse |
What Parameters Does Qwen Image 3.0 API Support?
Verwenden Sie diese Parameter mit der OpenAI-kompatiblen nativen Schnittstelle von Alibaba Cloud. Fügen Sie anbieterspezifische Optionen in CometAPI-Anfragen nur hinzu, wenn die ausgewählte Route sie dokumentiert.
Gilt für beide Varianten: qwen-image-3.0 (Standard) und qwen-image-3.0-pro (Pro) unterstützen auf der nativen, OpenAI-kompatiblen Schnittstelle von Alibaba Cloud dieselben unten aufgeführten Parameter. Wählen Sie die Variante über model; die Steuerungen für Generierung und Editing sind gemeinsam. Dies impliziert keine identische Ausgabequalität oder Preisgestaltung und garantiert nicht, dass jede CometAPI-Route alle nativen Parameter bereitstellt.
| Parameter | Type / example | Purpose |
|---|---|---|
| model | qwen-image-3.0 | Standard oder Pro wählen |
| prompt | string | Anweisung und Inhalt |
| image | URL / base64 string or array | 1–3 Referenzen für Editing; für Generierung weglassen |
| size | 1024x1024 | Ausgabedimensionen; Auto, wo unterstützt |
| n | integer 1–6 | Ausgaben pro Aufruf |
| negative_prompt | string | Beschreibt, was vermieden werden soll |
| prompt_extend | boolean | Prompt-Rewriting aktivieren |
| prompt_extend_mode | direct / agent | Agent-Modus nur T2I |
| enable_thinking | boolean | Reasoning-Steuerung, abhängig von Enhancement-Settings |
| watermark | boolean | Optionales Wasserzeichen |
| seed | integer | Hilfe zur Reproduzierbarkeit |
Für native Requests muss das Seitenverhältnis zwischen 1:8 und 8:1 liegen. Referenzbilder dürfen höchstens 10 MB groß sein, jede Seite zwischen 1 und 8.000 Pixeln, und das Verhältnis der längsten zur kürzesten Seite darf 10:1 nicht überschreiten. Verwenden Sie für Base64-Eingaben einen Data-URI. Thinking erfordert prompt_extend=true; Agent-Enhancement unterstützt nur Text-zu-Bild.
Ein kompatibler Bildrequest platziert Generierungsfelder auf Top-Level-JSON und formatiert die Abmessungen als 1024x1024. Native DashScope verwendet verschachtelte input/parameters und schreibt Abmessungen häufig als 1024*1024. Ein zwischen diesen Endpoints kopierter Request kann ohne Umwandlung fehlschlagen.
How Do You Call Qwen Image 3.0 API with CometAPI?
Diese Anleitung setzt Python 3, ein Bash-kompatibles Terminal, ein CometAPI-Konto mit Modellzugriff und ausreichendes Guthaben voraus. Die erste Anfrage nutzt nur die Felder model und prompt aus dem Anbieterbeispiel. Dokumentation geprüft am 16. Oktober 2026; diese Beispiele wurden nicht gegen ein bezahltes Konto ausgeführt.
Create credentials
Erstellen Sie einen serverseitigen API-Schlüssel in Ihrem CometAPI-Dashboard. Verteilen Sie ihn niemals in einem Web- oder Mobile-Client.
export COMETAPI_KEY="your_api_key"python -m pip install requests
Submit a minimal generation request
Entwickler können über die dokumentierte Bildgenerierungsroute auf CometAPI auf die Qwen Image 3.0 API zugreifen. Beginnen Sie mit dem minimalen Request unten, bevor Sie optionale Parameter hinzufügen.
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
Speichern Sie das folgende Skript als generate.py und führen Sie python generate.py aus. Es sendet eine Anfrage, verarbeitet URL- oder Base64-Bildergebnisse und schreibt jedes Bild lokal. Wenn die Antwort statt eines data-Arrays Aufgabeninformationen enthält, stoppt es, anstatt einen Polling-Endpoint zu raten; verwenden Sie den kontospezifischen asynchronen Vertrag, um das fertige Ergebnis abzurufen.
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}")
Ein erfolgreicher Lauf erzeugt lokale Bilddateien. Öffnen Sie sie, um zu bestätigen, dass sie lesbar sind und der angeforderten Szene entsprechen. Bewahren Sie die Request-ID und die Nutzungsfelder in Ihren Server-Logs auf, ohne Anmeldedaten zu protokollieren.
How Do You Generate Multiple Images with Qwen Image 3.0?
Auf der nativen Schnittstelle von Alibaba Cloud setzen Sie n auf zwei bis sechs für kreative Variationen. Aktivieren Sie n bei CometAPI erst, nachdem Sie die Unterstützung auf Ihrer ausgewählten Route bestätigt haben. Validieren Sie jedes zurückgegebene Asset separat; ein höheres n garantiert nicht, dass jedes Ergebnis die nachgelagerte Prüfung besteht.
Sie können mit Qwen Image 3.0 bis zu 6 Bilder in einer einzelnen Anfrage generieren, indem Sie den Parameter n setzen. Das funktioniert mit sowohl qwen-image-3.0 als auch qwen-image-3.0-pro für Text-zu-Bild-Generierung und Bildbearbeitung. Der Standardwert ist nur ein Bild.
Es gibt zwei Hauptwege: Verwenden Sie eine grafische Oberfläche, sofern Ihre Plattform die Option anbietet, oder rufen Sie die API direkt auf.
Generate multiple images using the API
- Öffnen Sie die API-Dokumentation.
- Holen Sie sich einen API-Schlüssel aus der QwenCloud-Konsole/ CometAPI.
- Wählen Sie
qwen-image-3.0oderqwen-image-3.0-pro. - Setzen Sie
nauf die gewünschte Bildanzahl von1bis6. - Senden Sie Ihren Prompt und speichern Sie die zurückgegebenen Bilder.
Beispiel: Setzen Sie "n": 4, um vier Variationen desselben Prompts anzufordern.
Python example
Hier ist ein anpassbares Beispiel mit der OpenAI-kompatiblen 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!")
Installieren Sie zuerst die notwendigen Pakete:
pip install openai requests
Die API gibt für jedes Ergebnis eine Bild-URL zurück. Generierte Bild-URLs sind temporär, laden Sie die Bilder daher umgehend herunter.
Important settings
| Parameter | What it does |
|---|---|
| n=4 | Generiert vier Ausgabebilder |
| model="qwen-image-3.0-pro" | Wählt das Pro-Modell |
| size="1024x1024" | Fordert quadratische Bilder an |
| seed=12345 | Verbessert die Reproduzierbarkeit |
| negative_prompt | Schließt unerwünschte Bildelemente aus |
Die maximale Ausgabemenge beträgt sechs pro Request. Beachten Sie, dass die Anforderung von mehr Bildern die Generierungskosten erhöht.
Ein wichtiger Unterschied: n=4 fordert vier Variationen eines Prompts an. Wenn Sie vier unterschiedliche Prompts möchten, sollten Sie separate Requests stellen oder eine Schleife über Ihre Prompts automatisieren.
How Do You Edit Images with Qwen Image 3.0?
Eine Bearbeitung kombiniert ein bis drei Bildreferenzen mit Anweisungen. Erklären Sie sowohl die gewünschte Transformation als auch, was sich nicht ändern darf—zum Beispiel das Produktlabel, die Farbe, der Kamerawinkel oder die Verpackungsgeometrie.
Das nächste Beispiel verwendet Alibaba-Cloud-Zugangsdaten und das JSON-Bildfeld für Editing. Erstellen Sie einen regionalen Model-Studio-Schlüssel, beziehen Sie Ihre Workspace-ID und konfigurieren Sie den passenden Endpoint. Verwenden Sie für diese Anfrage keinen CometAPI-Schlüssel.
export DASHSCOPE_API_KEY="your_model_studio_key"export ALIBABA_WORKSPACE_ID="your_workspace_id"export ALIBABA_IMAGE_ENDPOINT="https://${ALIBABA_WORKSPACE_ID}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/images/generations"
Das Referenzbild unten stammt direkt aus dem offiziellen API-Beispiel. Es ist ein Eingabebild, nicht ein in diesem Artikel generiertes Ergebnis.
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())
Der native, kompatible Endpoint verwendet JSON auf /images/generations, keine Multipart-Uploads auf /images/edits. Masks oder Streaming werden nicht unterstützt. Lesen Sie das zurückgegebene data-Array und speichern Sie jede URL mit derselben Download-Schleife wie oben.
Für zwei Referenzen fügen Sie zwei URLs in das image-Array ein und spezifizieren deren Rollen im Prompt (z. B. Produkt aus Bild eins, Raumsetting aus Bild zwei). Die Qwen Image 3.0 Serie akzeptiert höchstens drei Referenzbilder; verwenden Sie für größere Quellmengen ein anderes Modell oder einen Vorverarbeitungs-Workflow.
How Much Does Qwen Image 3.0 API Cost?
Die Preise der Qwen Image 3.0 API variieren nach Modellvariante, Auflösung und Anbieter. Die Tabelle unten ergänzt den ursprünglichen Vergleich von Alibaba Cloud Singapore um die CometAPI-Sätze aus der vom Prüfer beigefügten Preistabelle. Der Anhang listet Ausgabepreise in USD pro Bild und einen 20%-Rabatt für alle vier Kombinationen aus Modell/Auflösung. Diese angegebenen Sätze wurden nicht unabhängig gegen Live-Kontobuchungen verifiziert; bestätigen Sie die geltende Preisliste vor der produktiven Nutzung.
| 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 |
*Die obigen Mengenausgaben beziehen sich nur auf Ausgabebilder: 100 Standard-1K-Bilder kosten $2.40 und 100 Pro-1K-Bilder kosten $3.20; 1.000 Standard-2K-Bilder kosten $24.00 und 1.000 Pro-2K-Bilder kosten $60.00. Für Bearbeitungen fügen Sie $0.0024 pro abrechenbarem Eingangsreferenzbild hinzu. Regeln für fehlgeschlagene Jobs, Steuern und kontospezifische Anpassungen sind ausgeschlossen.
Unter Verwendung der angegebenen Eingangs- und Ausgabebildpreise berechnen Sie die Bildkosten für beide Anbieter wie folgt:
Gesamtkosten = (abrechenbare Referenzbilder × Preis pro Eingabebild) + (erfolgreiche Ausgaben × Preis pro Ausgabebild).
Für einen Job mit zwei abgerechneten Eingangsreferenzbildern und drei erfolgreichen Standard-1K-Ausgaben ergeben sich bei Alibaba Cloud Bildkosten von (2 × $0.0030) + (3 × $0.0300) = $0.0960. Die entsprechenden CometAPI-Bildkosten betragen (2 × $0.0024) + (3 × $0.0240) = $0.0768, basierend auf den angegebenen Sätzen.
CometAPI berechnet $0.0024 pro Eingangsreferenzbild für beide Varianten. Ausgabepreise betragen $0.0240 pro Standardbild bei 1K oder 2K, $0.0320 pro Pro-Bild bei 1K und $0.0600 pro Pro-Bild bei 2K. Die bereitgestellte Tabelle weist jeden Eingangs- und Ausgabesatz 20% unterhalb des entsprechenden offiziellen Preises aus. Bei gleichen abrechenbaren Bildanzahlen sind diese Bildkosten daher um 20% niedriger; zusätzliche Gebühren oder Kontobedingungen können die endgültige Rechnung verändern.
Für die Budgetierung in der Produktion verifizieren Sie die gewählte Variante, Bildauflösung, Referenzbildgebühren, Anzahl der Ausgaben pro Request und anwendbare Kontorabatte, bevor Sie die Gesamtnutzungskosten schätzen.
How Do You Handle Qwen Image 3.0 API Errors?
| Symptom | Likely cause | Action |
|---|---|---|
| 401/403 | Ungültiger Schlüssel oder falsche Region | Zugangsdaten, Berechtigungen und Bereitstellungsregion prüfen |
| 400 invalid image | Falsche Anzahl/Art der Referenzen | 1–3 Bilder, gültige URL/Base64, unterstützte Formate verwenden |
| 400 invalid size | Nicht unterstützte Fläche/Seitenverhältnis oder Separator | Dimensionen für den Endpoint normalisieren |
| Unexpected JSON | Falscher Endpoint oder Response-Vertrag | Response-Felder protokollieren und Parser anpassen |
| Expired image URL | Bild nicht vor Ablauf gespeichert | Bilder sofort nach Erstellung herunterladen und speichern |
| Unexpected bill | Referenzbilder oder Ausgabestufe nicht berücksichtigt | Bildnutzungsfelder und aktuelle Preisliste verwenden |
| Inconsistent brand text | Generative Einschränkungen | Review-Gates nutzen oder Text in der Postproduktion überlagern |
FAQ
Should I retry a Qwen Image 3.0 request after a timeout?
Ein Client-Timeout beweist nicht, dass die Generierung gestoppt wurde. Bewahren Sie eine Request- oder Task-ID auf, prüfen Sie den Jobverlauf des Anbieters oder die dokumentierte Status-API und bestimmen Sie, ob bereits Ausgaben existieren, bevor Sie erneut senden. Blindes Wiederholen kann doppelte Jobs und zusätzliche Kosten verursachen. Verwenden Sie begrenzte Retries für transiente Fehler und befolgen Sie die Idempotenzrichtlinien des Anbieters, sofern verfügbar.
How can I use local reference images with Qwen Image 3.0?
Für die native, kompatible Schnittstelle lesen Sie die Datei als Bytes, Base64-kodieren sie und fügen einen Data-URI wie data:image/png;base64, voran. Platzieren Sie diesen vollständigen String in image. Base64-Eingaben müssen weiterhin die Größen- und Dimensionsgrenzen einhalten; ein lokaler Dateipfad ist keine URL, die der Dienst abrufen kann.
How do I pass Qwen-specific options through an OpenAI SDK?
Belassen Sie Standard-Bildfelder in den üblichen SDK-Argumenten und platzieren Sie Model-Studio-Erweiterungsfelder wie image und prompt_extend in extra_body. Rohes HTTP platziert diese Felder direkt auf Top-Level-JSON. Diese Anleitung gilt für die native, kompatible Schnittstelle; prüfen Sie die ausgewählte CometAPI-Route, bevor Sie anbieterspezifische Optionen durchreichen.
What should I do when Qwen Image 3.0 returns fewer images than requested?
Speichern Sie zuerst die erfolgreichen Ausgaben und protokollieren Sie die tatsächliche Anzahl. Bei der nativen Abrechnung von Alibaba Cloud folgen die Ausgabekosten den erfolgreich generierten Bildern. Wenn weitere Assets benötigt werden, fordern Sie nach Prüfung der Antwort und des Nutzungsdatensatzes nur die fehlende Menge erneut an; die CometAPI-Abrechnung muss gegen deren eigene Kontobedingungen abgeglichen werden.
Conclusion
Qwen Image 3.0 ist eine praxisnahe Wahl für Teams, die Generierung und referenzgetriebene Bearbeitungen innerhalb einer Modellfamilie benötigen. Verwenden Sie Standard als kostenfokussierte Basis, testen Sie Pro für anspruchsvollere 2K- oder Kreativaufgaben und messen Sie die Kosten akzeptierter Ausgaben statt nur den Preis pro Request. Starten Sie mit dem minimalen Generierungsaufruf, persistieren Sie die Ausgaben und fügen Sie dann Editing oder mehrere Ausgaben über den passenden Anbietervertrag hinzu. Trennen Sie Zugangsdaten und Request-Schemata, behandeln Sie Fehler explizit und gleichen Sie die Bildnutzung mit der ausgewählten Preisliste ab.