Qwen: Qwen Image 3 Pro
Qwen-Image-3.0 Pro ist Qwens Spitzenmodell für Bildgenerierung und Bildbearbeitung mit komplexen Layouts, realistischen Details und mehrsprachigem Text. Nutzen Sie einen präzisen Auftrag oder ein bis drei Referenzen für eine Grafik, eine Produktszene oder eine gezielte Bildänderung.
Ü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 Pro ist Qwens Spitzenmodell der dritten Generation für Bildgenerierung und Bildbearbeitung. Es verbindet komplexe Layouts, detaillierte realistische Texturen, mehrsprachige Typografie und die genaue Umsetzung eines Bildauftrags. Pro und das Standardmodell Qwen-Image-3.0 teilen die dokumentierten Generierungs- und Bearbeitungsmodi; Pro betont Bildqualität, die Standardedition den Ausgleich zwischen Qualität und Geschwindigkeit. Das Ergebnis ist ein gerendertes Bildartefakt.
Definieren Sie bei einer informationsreichen Grafik zunächst den Inhalt, dann das Erscheinungsbild: Überschrift, Begleittext, Zahlen, Hierarchie und Beziehungen zwischen Abschnitten. Ein sinnvoller Produktauftrag kann Hauptobjekt, Materialdetails in Nahaufnahme und beschriftete Eigenschaften auf einer Fläche verbinden. Benennen Sie bei einer Lehrillustration Konzept, Diagrammstruktur und genaue Beschriftungen, statt die zugrunde liegenden Fakten vom Modell erfinden zu lassen. Komplexe Layouts können mehrere Felder oder verschachtelte Oberflächen zeigen. Konzentrieren Sie die empfohlene Prompt-Obergrenze von 4’500 Tokens darauf, was erscheinen muss und wohin es gehört.
Die 3.0-Familie unterstützt native Typografie in 12 Sprachen, mehrere Schriftarten und mehr als 100 künstlerische Stile sowie feine Texturen wie Haar, Haut oder Stoff. Kleine Schrift wird bis hinunter zu 10 Pixeln demonstriert. Das ermöglicht Designs, die Schrift mit einem physischen Material oder Text mit realistischen Bildern verbinden. Geben Sie genauen Wortlaut, Ziffern und Sprache an und beschreiben Sie die typografische Rolle jedes Blocks. Eine Zeitungsseite oder ein Oberflächenentwurf bleibt ein Bild; ein späteres bearbeitbares Layout oder interaktives Verhalten ist ein eigenes, daraus zu erstellendes Artefakt.
Pro kann Text im Bild bearbeiten, Elemente hinzufügen, löschen oder verschieben, die Handlung eines Motivs ändern, visuellen Stil übertragen und Details verbessern. Die Bearbeitung nimmt ein bis drei Eingabebilder mit einer Anweisung entgegen. Ihre Reihenfolge bestimmt Bild 1, Bild 2 und Bild 3 im Auftrag. Legen Sie fest, welche Referenz die Identität des Motivs, welche ein Objekt oder Kleidung und welche Umgebung oder Pose liefert. Eine gezielte Bearbeitung nennt sowohl die gewünschte Änderung als auch zu bewahrende Merkmale und erleichtert so den Vergleich mit den Referenzen.
Unterstützte Eingaben sind JPG, JPEG, PNG, BMP, TIFF, WebP und GIF; bei animierten GIFs wird nur das erste Frame verwendet. Jedes Eingabebild darf bis zu 10 MB gross sein. Die genaue Hersteller-API akzeptiert Seiten von 1 bis 8’000 Pixeln und ein Verhältnis der langen zur kurzen Seite von höchstens 10:1; empfohlen werden 384–2’048 Pixel. Die Bearbeitungsanleitung empfiehlt separat Bilder bis zu 3’072 Pixeln. Betrachten Sie die Eingabeauswahl daher als Vorbereitung auf den nötigen Detailgrad, nicht als Versprechen, dass jede höhere Auflösung das Ergebnis verbessert. Nutzen Sie für kleine Schrift oder Materialmerkmale eine lesbare, passend eingerahmte Referenz.
Ausgaben sind PNG. Der Herstellerablauf liefert eine bis sechs Alternativen, standardmässig eine, und unterstützt eine Gesamtpixelfläche von 512 × 512 bis 2’048 × 2’048 bei Seitenverhältnissen von 1:8 bis 8:1. Das Pixelflächenbudget erlaubt einige nichtquadratische Abmessungen, deren längere Seite 2’048 Pixel übersteigt. Ohne Grössenangabe empfiehlt das Modell anhand des Auftrags eine Auflösung. Wählen Sie die Form für den tatsächlichen Einsatzort und vergleichen Sie die Alternativen auf Vollständigkeit, Motivdetails und Typografie in der vorgesehenen Anzeigegrösse.
Intelligente Prompt-Überarbeitung ist standardmässig aktiv. Direkte Verbesserung ist für Generierung und Bearbeitung verfügbar; Agentenverbesserung verfeinert Text-to-Image-Prompts und lässt sich nicht für Image-to-Image-Bearbeitung verwenden. Thinking ist ebenfalls standardmässig aktiv und erfordert die Prompt-Überarbeitung; es ergänzt Schlussfolgerungsarbeit und Generierungszeit. Negative Prompts benennen unerwünschte Elemente, und ein optionaler Seed kann Variantenvergleiche konsistenter machen. Ein klarer positiver Auftrag sollte trotzdem Motiv, Komposition und zu bewahrende Details festlegen.
Eine praktische Ergebnisprüfung kontrolliert den genauen Text, Zahlen, Lesereihenfolge, Referenztreue und wichtige Kanten oder Texturen. Bewahren Sie bei einer punktuellen Überarbeitung die gelungene Komposition und beschreiben Sie die gezielte Änderung. Speichern Sie alle ausgewählten Bilder mit Prompt und Referenzen, da die Ausgabeorte des Herstellers nach 24 Stunden ablaufen. Die dokumentierten Pro-Modi und Grenzen gehören zur 3.0-Edition; die für Qwen 2.1 beschriebenen zehn Referenzen und native Transparenz sind Fähigkeiten einer anderen Edition.
Ailoot Ultra · Bilder POST /v1/images/generations qwen/qwen-image-3-pro
qwen/qwen-image-3-proEinstieg
Qwen-Image-3.0 Pro ist Qwens Spitzenmodell für Bildgenerierung und Bildbearbeitung mit komplexen Layouts, realistischen Details und mehrsprachigem Text. Nutzen Sie einen präzisen Auftrag oder ein bis drei Referenzen für eine Grafik, eine Produktszene oder eine gezielte Bildänderung.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Bilder POST /v1/images/generations
- Eingabe
text,image- Ausgabe
image
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits qwen/qwen-image-3-pro | 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 |
|---|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationEingabebild | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Eingabebild | Gebühr Eingabe · Eingabebild · Schätzung nur zum Vergleich $0.006 pro Eingabebild |
| KonfigurationGeschätzte Erzeugungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.08 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 abschliessenden 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-pro', '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-pro
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · Qwen: Qwen Image 3 Pro
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·qwen/qwen-image-3-pro:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·qwen/qwen-image-3-pro:model,prompt,resolution,aspect_ratio,n,input_references,provider- Welche Grenzen gelten?
POST /v1/images/generations·qwen/qwen-image-3-pro:n.minimum:1;n.maximum:6