Skip to Content
ModelleQwen-Image

Reihe Qwen-Image

Die Tongyi-Bildmodelle von Alibaba, insgesamt zwei. Sie werden über den OpenAI-kompatiblen Endpunkt /v1/images/generations aufgerufen; Text zu Bild und Bearbeitung laufen beide über diesen Endpunkt.

Modellwahl

Beide Modelle haben exakt dieselben Parameter. Pro ist die höherwertige Version mit besserer Textdarstellung und Bildqualität.

Modell-IDs (beim Aufruf exakt kopieren)
Qwen-Image 3.0 Proqwen/qwen-image-3.0-proGehobene Stufe
Qwen-Image 3.0qwen/qwen-image-3.0Standardstufe

Aktuelle Preise finden Sie auf der Modellseite .

Unterschiede zu anderen Reihen

Kurz gesagtLiefert einen Bildlink statt base64; der Link läuft nach 24 Stunden ab.
Qwen-ImageGPT Image, Seedream u. a.
Rückgabedata[].url, temporärer Link auf Alibaba Cloud OSSdata[].b64_json
Feld für Referenzbilderinput_imagesSeedream verwendet image
/v1/images/editsNicht unterstütztVon GPT Image unterstützt

Gültigkeitsdauer des Links: Der Parameter Expires im Link liegt 24 Stunden nach der Generierung. Für eine längerfristige Nutzung laden Sie das Bild rechtzeitig herunter und speichern es selbst; schreiben Sie den Link nicht direkt in eine Datenbank.

Text zu Bild

qwen_image.py
import urllib.request from openai import OpenAI client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600) resp = client.images.generate( model="qwen/qwen-image-3.0-pro", prompt="Ein roter Apfel auf einem weißen Tisch, daneben eine Karte mit der Aufschrift „OfoxAI“", size="1024x1024", ) # Zurückgegeben wird ein temporärer Link; innerhalb von 24 Stunden herunterladen urllib.request.urlretrieve(resp.data[0].url, "output.png")

Größe und Anzahl

Kurz gesagtDie Gesamtpixelzahl muss zwischen 512×512 und 2560×2560 liegen; n beträgt höchstens 6.
ParameterWertHinweis
sizeWIDTHxHEIGHTGesamtpixelzahl 262.144 (512×512) bis 6.553.600 (2560×2560); außerhalb des Bereichs 400
Ohne size—Gemessene Ausgabe 2048×2048
n1–6Liefert mehrere Links pro Anfrage; 7 oder mehr liefert 400

2560x1440 funktioniert gemessen. Zur Dauer: 1024×1024 etwa 10 bis 60 Sekunden, 2560×1440 etwa 60 Sekunden, Bearbeitung etwa 50 bis 100 Sekunden. Empfohlen ist ein Client-Timeout von mindestens 300 Sekunden.

Bearbeitung und mehrere Referenzbilder

Kurz gesagtReferenzbilder stehen in input_images, höchstens 3; das Feld image wird nicht verwendet, und /v1/images/edits wird nicht unterstützt.
qwen_edit.py
import base64 import urllib.request from openai import OpenAI client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600) with open("apple.jpg", "rb") as f: ref = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode() resp = client.images.generate( model="qwen/qwen-image-3.0-pro", prompt="Färbe den Apfel lila, lass alles andere unverändert", extra_body={"input_images": [ref]}, ) urllib.request.urlretrieve(resp.data[0].url, "apple_purple.png")
  • input_images ist ein Array; jeder Eintrag ist eine Bild-URL oder ein String, der mit data:image/...;base64, beginnt. Erlaubt sind 1 bis 3 Bilder; mehr als 3 liefern 400.
  • image ist ein Feld nur für Seedream und wird von Qwen-Image nicht unterstützt.
  • Ohne size liefert die Bearbeitung gemessen 2048×2048, was vom Original abweichen kann. Wenn Sie die Größe beibehalten möchten, geben Sie sie explizit an.

Weitere Parameter

negative_prompt (unerwünschte Inhalte) und prompt_extend (ob das Modell den Prompt automatisch erweitert) lassen sich gemessen normal übergeben. Die Parameterdefinitionen finden Sie in der offiziellen Dokumentation von Alibaba Cloud Model Studio .

Häufige Fehler

Fehlermeldung (Auszug)UrsacheLösung
Image area must be between 262144 (512x512) and 6553600 (2560x2560) pixels for t2i requestsGröße zu klein oder zu großIn den gültigen Bereich bringen, z. B. 1024x1024 oder 2560x1440
Input should be less than or equal to 6: parameters.nn größer als 6Auf höchstens 6 setzen; für mehr Bilder in mehreren Anfragen
supports 0~3 image content items. Got 4 image items.Mehr als 3 ReferenzbilderAuf höchstens 3 reduzieren
does not support the /v1/images/edits endpointBearbeitungs-Endpunkt aufgerufeninput_images von /v1/images/generations verwenden
Referenzbild wirkt nichtFeld image verwendetinput_images verwenden
Bildlink nicht erreichbarDer Link ist nach 24 Stunden abgelaufenNeu generieren; Bilder nach Erhalt des Links rechtzeitig herunterladen und speichern

Das in der Fehlermeldung genannte qwen-image-3.0-distill ist ein interner Modellname des Upstream-Anbieters; beim Aufruf verwenden Sie weiterhin die auf dieser Seite aufgeführten Modell-IDs.

Fehlermeldungen im Wortlaut

Image area must be between 262144 (512x512) and 6553600 (2560x2560) pixels for t2i requests. Got area=10000 (width=100, height=100). Input should be less than or equal to 6: parameters.n Model 'qwen-image-3.0-distill' supports 0~3 image content items. Got 4 image items. (0 images = T2I mode, 1~3 images = I2I mode)

Häufige Fragen

Warum liefert Qwen-Image eine url statt b64_json?

Qwen-Image liefert einen temporären Bildlink auf Alibaba Cloud OSS (data[].url), kein base64. Der Link läuft nach 24 Stunden ab; laden Sie das Bild nach Erhalt möglichst schnell herunter und speichern Sie es.

Wie bearbeite ich Bilder mit Qwen-Image?

Senden Sie an /v1/images/generations das Feld input_images (ein Array mit 1 bis 3 Bildern; jeder Eintrag ist eine Bild-URL oder base64, das mit data:image beginnt). image ist ein Feld von Seedream und wird von Qwen-Image nicht unterstützt; /v1/images/edits ebenfalls nicht.

Qwen-Image meldet Image area must be between 262144 and 6553600 pixels?

Die Gesamtpixelzahl muss zwischen 512x512 und 2560x2560 liegen. 100x100 ist zum Beispiel zu klein, 3000x3000 zu groß. Verwenden Sie etwa 1024x1024, 2048x2048 oder 2560x1440.

Wie viele Bilder kann Qwen-Image pro Anfrage höchstens generieren?

n beträgt höchstens 6; 7 oder mehr liefert 400. Für mehr Bilder senden Sie mehrere Anfragen.

Der Bildlink von Qwen-Image lässt sich nicht mehr öffnen?

Der Parameter Expires im Link liegt 24 Stunden nach der Generierung; danach ist kein Download mehr möglich, und Sie müssen das Bild neu generieren. Laden Sie Bilder nach Erhalt des Links rechtzeitig herunter und speichern Sie sie in Ihrem eigenen Speicher.

Zuletzt aktualisiert am