Skip to main content
POST

Autorisierung

string
erforderlich
Alle Anfragen erfordern eine Bearer-Token-Authentifizierung.Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API-Key zu erhalten, und fügen Sie ihn dann dem Request-Header hinzu:

Verfügbare Modelle

Die Abrechnung erfolgt nach erfolgreich generierte Bilder × Stückpreis. Eingaben werden nicht abgerechnet. Auflösung und Seitenverhältnis beeinflussen den Preis nicht. Fehlgeschlagene Anfragen werden nicht berechnet.

Body

string
erforderlich
Name des Bildgenerierungsmodells.
  • wan2.7-image-pro — Professional Edition, bis zu 4K für Text-zu-Bild
  • wan2.7-image — Standard Edition, schneller, bis zu 2K
boolean
Standard:"false"
Legt fest, ob der Inhalt vor dem Absenden des Bildauftrags moderiert wird.
  • true: Prompts und Eingabebilder mit omni-moderation-latest prüfen
  • false oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
string
Textbeschreibung für die Bildgenerierung, bis zu 5000 Zeichen.
  • Text-zu-Bild (ohne image_urls): erforderlich
  • Bildbearbeitung (mit image_urls): optional, aber empfohlen
Beispiel: "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
array<string>
Array von Eingabebild-URLs für Bearbeitung und Mehrbild-Referenzszenarien.Die Angabe dieses Feldes schaltet die Anfrage in den Bildbearbeitungsmodus.Unterstützte Formate: HTTP/HTTPS-URLs; data:image/...;base64,... Base64Einschränkungen: Bis zu 9 Bilder; JPEG / PNG / WEBP / BMP; 240–8000 px, Seitenverhältnis 1:8 ~ 8:1; ≤ 20 MB pro Bild
Das Ausgabe-Seitenverhältnis entspricht automatisch dem letzten Eingabebild. Der Bearbeitungsmodus unterstützt nur bis zu 2K — 4K ist nicht verfügbar.
integer
Standard:"1"
Anzahl der zu generierenden Bilder.
  • Standardmodus: 1–4 (Standard 1)
  • Sequenzieller Modus (enable_sequential: true): 1–12 (Standard 1)
Abrechnung pro erfolgreich generiertem Bild. Vorausberechnung basierend auf n.
string
Ausgabeauflösung oder Seitenverhältnis. Unterstützt drei Formate:① Auflösungsschlüsselwort (empfohlen): 1K / 2K (Standard) / 4K (nur Text-zu-Bild für wan2.7-image-pro)② Seitenverhältnis: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 (standardmäßig 2K-Stufe)③ Pixelmaße: 1024x1024 oder 1024*1024
string
Schlüsselwort für die Auflösungsstufe: 1K / 2K / 4K. Kann mit size (Seitenverhältnis) kombiniert werden.
string
Negativer Prompt, der zu vermeidende Elemente beschreibt. Beispiel: "blurry, distorted, low quality"
boolean
Standard:"false"
Ob ein “AI Generated”-Wasserzeichen in der unteren rechten Ecke hinzugefügt werden soll.
integer
Zufallsseed, Bereich 0–2147483647. Derselbe Seed mit identischen Parametern erzeugt visuell konsistente Ergebnisse.
boolean
Standard:"true"
Aktiviert den erweiterten Reasoning-Modus, um die Bildqualität auf Kosten einer längeren Generierungszeit zu verbessern.
Nur wirksam, wenn der sequenzielle Modus deaktiviert ist und keine Bildeingabe bereitgestellt wird.
boolean
Standard:"false"
Aktiviert den sequenziellen Bildgenerierungsmodus — generiert mehrere thematisch zusammenhängende Bilder in einer Anfrage. Ideal für Storyboards und Serien.
  • Maximum n ist 12 bei Aktivierung
  • thinking_mode und color_palette werden im sequenziellen Modus ignoriert
  • wan2.7-image-pro unterstützt im sequenziellen Modus bis zu 2K (4K nicht unterstützt)
array
Begrenzungsrahmen für interaktive Bearbeitung — gibt genaue Bereiche zum Bearbeiten oder Einfügen von Inhalten an.Struktur: [[[x1, y1, x2, y2], ...], ...]
  • Die Länge des äußeren Arrays muss der Länge von image_urls entsprechen
  • Übergeben Sie [] für Bilder ohne Begrenzungsrahmen
  • Maximal 2 Rahmen pro Bild; Koordinaten sind absolute Pixelwerte, Ursprung (0,0) oben links
Beispiel: [[], [[989, 515, 1138, 681]]]
array<object>
Benutzerdefiniertes Farbthema. Nur Standardmodus (nicht sequenzieller Modus).
  • 3–10 Einträge (8 empfohlen); jeder Eintrag erfordert hex und ratio
  • Die Summe aller ratio-Werte muss genau 100.00% ergeben

Response

string
Antwortstatus. Gibt bei Erfolg "success" zurück.
array

Beispiele

Text-zu-Bild (minimal)

Text-zu-Bild (mit Auflösung)

Text-zu-Bild (benutzerdefinierte Farbpalette)

Sequenzielle Bildgenerierung

Einzelbildbearbeitung

Mehrbild-Referenz / Elementfusion

Interaktive Bearbeitung (Begrenzungsrahmen)

bbox_list entspricht 1:1 dem image_urls. Übergeben Sie [] für Bilder ohne Auswahl.
Ergebnisse abfragenDie Bildgenerierung erfolgt asynchron. Fragen Sie den Aufgabenstatus-Endpunkt mit der zurückgegebenen task_id ab, bis status == completed.