Qwen: Qwen Image 3
Qwen-Image-3.0 verbindet Bilderzeugung und -bearbeitung für informationsreiche Layouts, detailreiche Szenen und mehrsprachige Typografie. Die Standardausgabe bietet ein Gleichgewicht aus Qualität und Geschwindigkeit und akzeptiert eine Textvorgabe oder bis zu drei Bilder mit einer Bearbeitungsanweisung.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Qwen-Image-3.0 ist Qwens Bildmodell der dritten Generation und vereint Text-zu-Bild-Erzeugung und referenzbasierte Bearbeitung in einem Modell. Die Standardausgabe bietet ein Gleichgewicht zwischen Bildqualität und Antwortgeschwindigkeit, während Qwen-Image-3.0 Pro die auf höchste Qualität ausgerichtete Schwesterausgabe ist. Eine Anfrage erzeugt ein Bild: ein Poster, eine illustrierte Erklärung, eine Produktszene, ein Storyboard oder ein überarbeitetes Foto, nicht jedoch ein bearbeitbares Dokument oder eine funktionsfähige Benutzeroberfläche.
Seine Fähigkeiten für inhaltsreiche Darstellungen eignen sich für eine Bildfläche mit mehreren zusammengehörigen Abschnitten oder einem verschachtelten visuellen Layout. Bereiten Sie Überschriften, exakte Formulierungen, Hierarchie und die Beziehungen zwischen Bildfeldern vor, bevor Sie stilistische Details ergänzen. Für einen Produktvergleich legt eine nützliche Vorgabe die Hauptansicht des Produkts, die zu beschriftenden Eigenschaften und die Lesereihenfolge der ergänzenden Bildfelder fest. Beschreiben Sie bei einem Storyboard Motiv, Handlung und Bildunterschrift jedes Feldes getrennt. Die empfohlene Höchstlänge eines Prompts beträgt 4.500 Token; nutzen Sie diesen Platz für die Inhalte und das Layout, die das Bild tatsächlich benötigt.
Das Modell unterstützt detaillierte Texturen, Typografie bis hin zu kleiner Schrift, die mit 10 Pixeln demonstriert wird, sowie die native Darstellung in 12 Sprachen mit mehreren Schriftarten und künstlerischen Stilen. Diese Fähigkeiten ermöglichen es, ein realistisches Objekt mit einer informationsreichen Grafik zu verbinden, statt sich zwischen einem Foto und einem textlastigen Layout entscheiden zu müssen. Geben Sie die exakten Wörter und Ziffern, ihre vorgesehene Sprache und ihre Platzierung an. Behandeln Sie eine erzeugte Benutzeroberfläche als visuelles Mockup: Schaltflächen, Diagramme und Beschriftungen im Bild implementieren kein Anwendungsverhalten.
Bei der Bearbeitung lassen sich Texte ändern, Objekte hinzufügen oder entfernen, Elemente verschieben, Handlungen eines Motivs anpassen, Stile übertragen oder Details eines beschädigten Bildes verbessern. Stellen Sie ein bis drei Bilder und eine einzige klare Bearbeitungsanweisung bereit. Die Bildnummerierung folgt der übermittelten Reihenfolge. Geben Sie daher an, welches Bild das Motiv, welches ein Kleidungsstück oder Objekt und welches die Umgebung liefert. Bitten Sie bei einer Produktszene darum, das Objekt aus Bild 1 in die Umgebung aus Bild 2 zu setzen und dabei die Merkmale zu erhalten, die das Produkt auszeichnen. Formulieren Sie Änderungen und Anforderungen an den Erhalt von Details ausdrücklich.
Der genaue Bildeingabeablauf akzeptiert JPG, JPEG, PNG, BMP, TIFF, WebP und GIF; bei einem animierten GIF wird nur das erste Einzelbild verarbeitet. Jedes Bild darf bis zu 10 MB groß sein. Die aktuelle API akzeptiert Abmessungen von 1 bis 8.000 Pixeln bei einem Verhältnis der langen zur kurzen Seite von höchstens 10:1 und empfiehlt für gute Ergebnisse 384–2.048 Pixel. Wählen Sie eine Eingabe, auf der die zu übertragenden oder zu bearbeitenden Details klar zu erkennen sind. Eine eng zugeschnittene Referenz kann die umgebende Struktur verbergen, die für eine natürliche Platzierung des Objekts benötigt wird.
Die Ausgabe erfolgt als PNG, mit ein bis sechs Bildern pro Anfrage und einem Bild als Standard. Die Pixelfläche der Ausgabe reicht von 512 × 512 bis 2.048 × 2.048, bei Seitenverhältnissen zwischen 1:8 und 8:1; dies sind Flächengrenzen und keine Vorgabe, dass jede Seite höchstens 2.048 Pixel lang sein darf. Wird keine Größe angegeben, empfiehlt das Modell anhand des Prompts eine Auflösung. Wählen Sie für den vorgesehenen Zweck eine Querformat-, Quadrat- oder Hochformatkomposition und prüfen Sie das zurückgegebene Bild anschließend in dieser tatsächlichen Größe, damit sich kleine Beschriftungen und feine Details an ihrem späteren Einsatzort beurteilen lassen.
Die Überarbeitung des Prompts ist im Herstellerablauf standardmäßig aktiviert. Die direkte Optimierung funktioniert sowohl bei der Erzeugung als auch bei der Bearbeitung; die agentengestützte Optimierung ist ein aufwendigerer Überarbeitungsmodus ausschließlich für Text-zu-Bild und wird bei Bild-zu-Bild-Bearbeitungen abgelehnt. Thinking ist standardmäßig aktiviert, setzt die Prompt-Überarbeitung voraus und verlängert die Erzeugungszeit. Negativ-Prompts können unerwünschte Elemente beschreiben, während ein fester Seed den Vergleich von Varianten erleichtert. Formulieren Sie Ausschlüsse und genaue Anforderungen an unveränderte Bestandteile klar, statt von einem Seed zu erwarten, dass er bei einer veränderten Vorgabe dasselbe Bild erzeugt.
Prüfen Sie für ein brauchbares Endergebnis die dargestellten Wörter, Einheiten, die Reihenfolge der Bildfelder und die Details, die das Motiv kennzeichnen. Überarbeiten Sie anschließend gezielt den Teil, der die Vorgabe verfehlt hat. Eine Antwort mit mehreren Bildern bietet Alternativen zum Vergleich; ordnen Sie jedes zurückgegebene Bild dem Prompt und den Referenzen zu, aus denen es entstanden ist. Die Bildadressen des Herstellers verfallen nach 24 Stunden. Bewahren Sie deshalb die eigentliche Bilddatei auf, wenn das Ergebnis Teil eines Projekts wird. Die Standardausgabe 3.0 bleibt von Pro und von den Qwen-2.1-Modellen mit ihren anderen Referenzanzahlen und Transparenzfunktionen getrennt.
Ailoot Ultra · Bilder POST /v1/images/generations qwen/qwen-image-3
qwen/qwen-image-3Start
Qwen-Image-3.0 verbindet Bilderzeugung und -bearbeitung für informationsreiche Layouts, detailreiche Szenen und mehrsprachige Typografie. Die Standardausgabe bietet ein Gleichgewicht aus Qualität und Geschwindigkeit und akzeptiert eine Textvorgabe oder bis zu drei Bilder mit einer Bearbeitungsanweisung.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Bilder POST /v1/images/generations
- Eingabetypen
text,image- Ausgabetypen
image
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits qwen/qwen-image-3 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 1K, 2K | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9 | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 6 | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 0 Maximale Anzahl Elemente: 4 | Standard— |
Feldprovider | Typobject | AnforderungOptional | Werte und Limits | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parametermaterial_types | Vertragtext, image |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Abrechnungseinheit | Gebühr |
|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationEingabebild | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Eingabebild | Gebühr Eingabe · Eingabebild · Schätzung nur zum Vergleich $0.006 pro Eingabebild |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.06 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Bilder
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'qwen/qwen-image-3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · Bilder
Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.
Wenn die ursprüngliche Antwort geprüft werden muss
Die zurückgegebene X-Client-Request-ID zum Abgleich aufbewahren. Nur tatsächlich zurückgegebene task_id-/asset_id-Werte oder die eigene Medienbibliothek abfragen; niemals eine Aufgaben-URL aus der Vorgangs-ID bilden und die Erstellung niemals erneut anfordern.
Antwortfelder
| Feld | Typ |
|---|---|
Feldcreated | Typ |
Felddata[].url | Typ |
Felddata[].b64_json | Typ |
Feldusage | Typ |
Aliasnamen
Modellaliasnamen
Ailoot Ultra qwen/qwen-image-3
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · Qwen: Qwen Image 3
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·qwen/qwen-image-3:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·qwen/qwen-image-3:model,prompt,resolution,aspect_ratio,n,input_references,provider- Welche Grenzen gelten?
POST /v1/images/generations·qwen/qwen-image-3:n.minimum:1;n.maximum:6