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.
qwen/qwen-image-3.0-proGehobene Stufeqwen/qwen-image-3.0StandardstufeAktuelle Preise finden Sie auf der Modellseite .
Unterschiede zu anderen Reihen
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
Python
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
n beträgt höchstens 6.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
input_images, höchstens 3; das Feld image wird nicht verwendet, und /v1/images/edits wird nicht unterstützt.Python
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_imagesist ein Array; jeder Eintrag ist eine Bild-URL oder ein String, der mitdata:image/...;base64,beginnt. Erlaubt sind 1 bis 3 Bilder; mehr als 3 liefern 400.imageist ein Feld nur für Seedream und wird von Qwen-Image nicht unterstützt.- Ohne
sizeliefert 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
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.