Alibaba

Qwen Image 3.0

qwen-image-3.0/image-to-image

Das Bildgenerierungs- und -bearbeitungsmodell der dritten Alibaba-Generation zeichnet sich durch dichte Typografie und mehrsprachiges Text-Rendering bei langen Prompts aus und unterstützt die Bearbeitung anhand von Referenzbildern

qwen-image-3.0-pro/image-to-image qwen-image-3.0-pro/text-to-image qwen-image-3.0/image-to-image qwen-image-3.0/text-to-image

qwen-image-3.0/image-to-image ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

image

Fülle die Parameter aus und generiere – die Ergebnisse erscheinen hier.

Preise

qwen-image-3.0/image-to-image per image

Einzelpreis	$0.0358

Positionsübersicht

Ein Bildbearbeitungsmodell, das auf iterativen Änderungen anhand von Referenzbildern basiert und zur Qwen-Image-3.0-Serie gehört. Beim Aufruf übergibt man 1–3 Referenzbilder sowie einen positiven Prompt, der die beizubehaltenden und zu ändernden Inhalte beschreibt. So lassen sich Szene, Stil, Kleidung und Bildtext ändern, während die entscheidenden Details des Originalbildes erhalten bleiben, und es werden Bilder in 1K oder 2K ausgegeben. Geeignet für Entwickler, die vorhandenes Material schnell in Infografiken, Poster, UI-Konzeptentwürfe oder Produktpräsentationsbilder umwandeln möchten – insbesondere für Szenarien der Inhaltserstellung, die textreich sind und hohe Anforderungen an mehrsprachiges Layout stellen.

Zentrale Highlights

Iterative Bearbeitung mit Referenzbildern, Originaldetails bleiben erhalten – 1–3 Bilder dienen als Eingabe; Szene, Stil, Kleidung und Text werden gemäß Prompt geändert statt vollständig neu gezeichnet, was wiederholte Iterationen am selben Material erleichtert.
Dichte Layouts und Textrendering in kleinen Schriftgrößen – ausgelegt auf bildliche Gestaltung mit Informationsgehalt; Layout und mehrsprachiges Textrendering sind stabiler, ideal für textreiche Ergebnisse wie Infografiken und Interface-Entwürfe.
Prompts können komplexe Layouts beschreiben – der positive Prompt umfasst bis zu 18000 Zeichen, genug für mehrteilige Bildinhalte, Layoutstrukturen und bereichsbezogene Änderungswünsche.
Kontrollierbare Ausgabespezifikationen – Auflösungsstufen 1K/2K, 8 Seitenverhältnisse, Ausgabe als png oder jpeg, Zufalls-Seed und negativer Prompt; Ergebnisse lassen sich gut in Produktionsabläufe integrieren.

Funktionsbeschreibung

Bearbeitung mit Referenzbildern: 1–3 Referenzbilder zusammen mit einem Prompt übergeben, um Inhalte zu ändern und dabei die entscheidenden Informationen des Originalbildes zu bewahren – geeignet für gezielte Änderungen an vorhandenem Material statt Neuerzeugung.

Lange Prompts und negative Einschränkungen: Der positive Prompt unterstützt lange Beschreibungen von Layout sowie beizubehaltenden und zu ändernden Bereichen; ein negativer Prompt schließt unerwünschte Elemente aus, was eine präzise Steuerung des Bildes ermöglicht.

Layout und Textrendering: Erzeugt Bilder mit korrektem Layout und mehrsprachigem Text, passend für textreiche visuelle Inhalte wie Infografiken und Interface-Konzeptentwürfe.

Automatische Prompt-Optimierung: prompt_extend ist standardmäßig aktiviert und erweitert Prompts automatisch, wodurch bei kurzen Eingaben der Beschreibungsaufwand sinkt; es kann deaktiviert werden, um die Eingabe unverändert zu lassen.

Ausgabespezifikationen und Reproduzierbarkeit: Auflösungsstufe, Seitenverhältnis und Dateiformat lassen sich festlegen, und Ergebnisse sind über den Seed reproduzierbar – praktisch für die massenhafte Erzeugung von Material mit konsistentem Stil.

Anwendungsfälle

Designer überarbeiten bestehende Poster oder Infografiken – das originale Poster oder Layout hochladen und Texte, Stil oder Layout per Prompt anpassen, um eine aktualisierte, direkt einsetzbare visuelle Vorlage zu erhalten.
Produktteams iterieren an UI-Konzeptentwürfen – einen vorhandenen Interface-Screenshot als Referenzbild verwenden, Farben, Layout oder Text ändern und so ein hochauflösendes Interface-Konzeptbild für Reviews und Prototypdiskussionen erzeugen.
E-Commerce-Teams aktualisieren Produktpräsentationsbilder – ein Produktbild als Referenz nutzen, Szene, Hintergrund oder Kleidung des Models anpassen und Produktpräsentationsbilder für Detailseiten und Marketingmaterial erstellen.
Lokalisierung mehrsprachiger Materialien – chinesisches oder englisches Material als Referenzbild verwenden, Sprache und Stil ersetzen und Werbevisuals erzeugen, die zu verschiedenen Märkten passen.

Einschränkungen und Auswahlhinweise

Unterstützt ausschließlich Bildbearbeitung und besitzt keine Text-zu-Bild-Fähigkeit; für die reine Text-zu-Bild-Generierung ist eine Text-zu-Bild-Variante derselben Serie zu wählen. Referenzbilder sind auf 1–3 Stück begrenzt, jeweils höchstens 10 MB, und SVG wird nicht unterstützt; komplexe Kompositionen mit mehreren Bildern sind eingeschränkt. Die Lesbarkeit kleiner Schrift hängt von Layoutdichte und Sprache ab und sollte vor der Ausgabe Bild für Bild geprüft werden. Das Modell ist relativ neu, und öffentlich verfügbare unabhängige Bewertungen sind begrenzt; es wird empfohlen, die Ergebnisse zunächst mit wenigen Beispielen zu prüfen, bevor es in Batch-Prozesse eingebunden wird.

Neuigkeiten

Changelog ansehen →

Neues Modell Neues Modell verfügbar: qwen-image-3.0-pro/text-to-image Oct 31, 2026
Neues Modell qwen-image-3.0-pro Bild-zu-Bild-Modell ist verfügbar Oct 31, 2026
Neues Modell Neu: qwen-image-3.0/text-to-image… Aug 20, 2026

Häufige Fragen

Alle Fragen ansehen →

Wie viele Referenzbilder unterstützt die Bildbearbeitung mit Qwen Image 3.0?

Unterstützt 1 bis 3 Referenzbilder. Mindestens eines ist erforderlich, das API-Feld lautet input.image_urls.
Was ist der Unterschied zwischen der Standardversion und der Pro-Bildbearbeitung?

Die Standardversion legt den Schwerpunkt auf geringere Kosten und schnelle Iterationen; Pro eignet sich besser für präzisen Textaustausch, komplexe Materialien und das finale Layout.
Wie werden 1K, 2K und Referenzbilder abgerechnet?

1K und 2K verwenden dieselbe Ausgabestufe; für jedes Referenzbild wird ein zusätzlicher Aufpreis berechnet. Die genauen Beträge richten sich nach dem tagesaktuellen Preis auf dieser Seite.
Wie lassen sich Drift von Motiv, Layout oder Text reduzieren?

Liste im Prompt getrennt auf, welche Inhalte geändert werden sollen und welche Motive, Texte, Positionen, Materialien, Kamerawinkel und Lichtverhältnisse beibehalten werden müssen; wenn exakter Text benötigt wird, schreibe den Zieltext in Anführungszeichen.

Generierungsaufgabe erstellen

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.

Idempotency-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.

Body

modelstringPflicht

Aktueller Festwert: qwen-image-3.0/image-to-image

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für qwen-image-3.0/image-to-image und Route default — siehe Parametertabelle unten.

seedintegerOptionalmin 0max 2147483647

Zufälliger Seed zur Steuerung der Zufälligkeit der generierten Ergebnisse, Wertform ist eine Ganzzahl; derselbe Seed in Kombination mit denselben übrigen Parametern reproduziert ähnliche Ergebnisse.

promptstringPflichtminLength 1maxLength 18000

Positiver Prompt, beschreibt per Text, welche Inhalte beibehalten und welche geändert werden sollen, Wertform ist eine Zeichenkette.

image_urlsarrayPflichtminItems 1maxItems 3

Array von Referenzbild-URLs, Elemente sind Bildlink-Zeichenketten, 1–3 Bilder; unterstützt JPEG, PNG, WEBP, BMP, GIF, TIFF, jeweils maximal 10 MB, SVG wird nicht unterstützt.

Array [ string ]

resolutionstringOptionalStandard: "1K"

Auflösungsstufe der Ausgabe, Wertform ist eine Zeichenkette, Standard 1K.

Optionen:1K2K

aspect_ratiostringOptionalStandard: "1:1"

Seitenverhältnis (Breite zu Höhe) des Ausgabebilds, Wertform ist eine Zeichenkette, Standard 1:1.

Optionen:1:13:22:34:33:416:99:1621:9

output_formatstringOptionalStandard: "png"

Dateiformat des generierten Bildes, Wertform ist eine Zeichenkette, Standard png.

Optionen:pngjpeg

prompt_extendbooleanOptionalStandard: true

Ob der Prompt automatisch optimiert wird, Wertform ist ein boolescher Wert, Standard true.

negative_promptstringOptionalStandard: ""maxLength 500

Inhalte, die nicht im Bild erscheinen sollen, Wertform ist eine Zeichenkette, Standard leere Zeichenkette.

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.

urlstringPflicht

Pflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.

whenstringOptionalStandard: "final"

Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.

Optionen:final

storagestringOptionalStandard: "temp"

Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.

Optionen:temppersistent

Anfragebeispiele

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-3.0/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "png",
    "prompt_extend": true,
    "negative_prompt": ""
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "qwen-image-3.0/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "1K",
      "aspect_ratio": "1:1",
      "output_format": "png",
      "prompt_extend": true,
      "negative_prompt": ""
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "qwen-image-3.0/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "1K",
          "aspect_ratio": "1:1",
          "output_format": "png",
          "prompt_extend": True,
          "negative_prompt": ""
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Aufgabendetails abrufen

GET https://api.hiapi.ai/v1/tasks/:id

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

queued Eingereiht, noch nicht gestartet. handling In Verarbeitung. archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet. success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben). fail Endzustand: fehlgeschlagen (error wird zurückgegeben). Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-Sekunden des Endzustands; vor Abschluss stets 0.

outputarrayOptional

Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).

Array [ object ]

Array-Elemente

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

Antwortbeispiele

Erfolg

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In Bearbeitung (nicht final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fehlgeschlagen

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}