Skip to main content
POST

Unterstützte Modelle

Bevorzugen Sie -pro bei dichtem Text/Layout. Verwenden Sie qwen-image-3.0 für allgemeine Bilder. Prompt max. ca. 4.5k Tokens. Modellnamen sind nicht mit der 2.0-Serie austauschbar.

Authorizations

string
erforderlich
Alle Endpunkte erfordern eine Bearer-Token-AuthentifizierungHolen Sie Ihren API-Key von der API-Key-Verwaltungsseite:

Body

string
erforderlich
Modellname
  • qwen-image-3.0 - Standard
  • qwen-image-3.0-pro - Pro (dichter Text / Layout)
string
erforderlich
Textbeschreibung für die Bildgenerierung, max. ca. 4.5k Tokens
string[]
Array mit Referenzbild-URLs (Bild-zu-Bild / Bearbeitung), 1-3 Bilder
  • Öffentliche http(s)://-URL oder data:image/png;base64,... (Base64 wird zuerst neu hochgeladen)
  • Formate: JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF
  • Pro Datei ≤ 10MB; Breite/Höhe empfohlen 384-2048 px
string
Standard:"1K"
Auflösungsstufe (beeinflusst die Abrechnungsstufe)
  • 1K (Standard; Kleinbuchstaben akzeptiert)
  • 2K
Sie können die Stufe weglassen und Pixel in size angeben (z. B. 1600x900). Bei Rohpixeln wird eine Fläche > 2.25M Pixel als 2K abgerechnet.
string
Standard:"1:1"
Seitenverhältnis oder explizite PixelgrößeUnterstützte Verhältnisse:
  • 1:1 (Standard)
  • 4:3 / 3:4
  • 16:9 / 9:16
  • 3:2 / 2:3
Auch 16x9-Stil oder Pixel wie 1024x1024. Bei benutzerdefinierten Pixeln muss jede Kante (Breite und Höhe) 512–2048 sein, Seitenverhältnis 1:8 ~ 8:1.Wenn weder size noch resolution gesetzt sind, ist die Ausgabe fest 1024×1024.
integer
Standard:"1"
Anzahl der Bilder, 1-6. Werte über 6 werden auf 6 begrenzt.
string
Negativer Prompt: zu vermeidende Inhalte
boolean
Standard:"false"
Intelligente Prompt-UmschreibungStandardmäßig aus, damit Ergebnisse vorhersagbar bleiben. Zum Aktivieren auf true setzen.
string
Umschreibmodus (nur 3.0-Serie; erfordert prompt_extend: true)
  • direct - funktioniert für Text-zu-Bild und Bild-zu-Bild
  • agent - nur Text-zu-Bild, aggressivere Umschreibung
Ungültige Werte werden ignoriert.

Größentabelle

Kombiniert resolution (Stufe) + size (Verhältnis):

Anwendungsfälle

Text-zu-Bild (mehrere)

Dichtes Layout mit Umschreibung

Bild-zu-Bild (Bearbeitung)

Negativer Prompt

Limits

Response

integer
Statuscode; 200 bei Erfolg
array
Antwortdaten-Array

Unterschiede zu 2.0

Hinweise

  1. Asynchron: Nach dem Absenden erhalten Sie eine task_id. Abfragen Sie Aufgabenstatus abrufen alle 3~5 Sekunden; Client-Timeout ca. 3 Minuten (2K + mehrere Bilder ist langsamer).
  2. Speicherung: Bilder werden auf das Plattform-CDN gespiegelt und sind langfristig verfügbar.
  3. Abrechnung: Pro geliefertem Bild × Auflösungsstufe nach tatsächlicher Pixelfläche (> 2.25M Pixel = 2K). qwen-image-3.0 berechnet 1K/2K gleich; -pro 2K ist 2× 1K. Bei Fehlern volle Rückerstattung; Referenzbilder sind kostenlos.
  4. Fehler: Ungültige size/Verhältnisse, agent bei Bild-zu-Bild, unerreichbare/zu große Referenzen → 400; Ratenlimit → 429.
Ergebnisse abfragenVerwenden Sie Aufgabenstatus abrufen für Fortschritt und result.images.