LogoWan API – Dokumentation
Startseite
X (Twitter)
Startseite

Erste Schritte

ÜberblickIntegrationsleitfadenGuthaben prüfenAufgabe löschen

Wan-Modelle

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Seedance-Modelle

Seedance 2.5Seedance 2.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

Bildmodelle

Seedream 5.0 ProSeedream 5.5 API

Sprachmodelle

Claude APIClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2GPT APIGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

Seedream 5.5 API

Generiere und bearbeite Bilder oder zerlege Ebenen mit Seedream 5.5. Anfrageparameter, asynchrone Aufgaben, Bildmetadaten und aktuelle Preise pro Bild.

Seedream 5.5 generiert ein Bild aus Text oder bis zu 10 Referenzbildern. Die Ebenenzerlegung nimmt ein Bild entgegen und liefert ein Basisbild plus transparente Ebenen sowie optional ein Ergebnis der Drucktexterkennung.

Playground testen · OpenAPI JSON · Integrationsanleitung

Authentifizierung und Endpunkte

Verwende deinen Wan API-Schlüssel als Bearer-Token. Ein Schlüssel greift auf alle verfügbaren Modelle und Gruppen zu; am Schlüssel wählst du keine Gruppe aus.

MethodeURLZweck
POSThttps://api.wanapi.app/seedream55/v1/images/generationsEine Bildaufgabe senden
GEThttps://api.wanapi.app/seedream55/v1/tasks/{id}Diese Aufgabe abfragen

Die Modell-ID lautet seedream-5-5. Diese Endpunkte sind asynchron. Sende einmal, speichere die Aufgaben-ID und frage sie bis completed oder failed ab. Eine ungewisse Netzwerkantwort ist keine Erlaubnis zum erneuten Senden.

Ein Bild generieren

curl https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5",
    "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning light. No text.",
    "size": "1K"
  }'

Eine akzeptierte Anfrage liefert eine Aufgabe statt Bilddaten:

{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}
curl https://api.wanapi.app/seedream55/v1/tasks/task_example \
  -H "Authorization: Bearer $WAN_API_KEY"

Frage dieselbe ID alle paar Sekunden ab. Bewahre sie auf, wenn deine Anwendung nicht weiter wartet, damit sie später fortfahren kann. Aufgaben-IDs und Zeitstempel dieser Anleitung dienen der Veranschaulichung.

Parameter

ParameterTypStandardRegeln
modelstringerforderlichseedream-5-5
promptstringfür Generierung erforderlichFür Ebenenzerlegung optional.
imageURL oder URL-ArraykeinerBis zu 10 Referenzen; genau eine für Ebenen. Jede Referenz wird berechnet.
sizestring2K oder auto für EbenenSiehe Größenregeln unten.
output_formatstringpngpng oder jpeg. Steuert bei Ebenen nur das Basisbild.
backgroundstringautoauto, opaque, transparent. Transparent erfordert PNG. Lasse dieses Feld im Ebenenmodus vollständig weg.
layer_decompositionbooleanfalseEine Referenz in ein Basisbild und transparente PNG-Ebenen zerlegen.
layer_decomposition_options.max_imagesinteger30Gesamtbildobergrenze, 2–100, einschließlich Basisbild. Nur im Ebenenmodus.
layer_decomposition_options.text_recognitionbooleanfalseDrucktextmetadaten in Ebenen anfordern. Nur im Ebenenmodus.
optimize_prompt_options.modestringstandardNur standard wird unterstützt.
watermarkbooleanfalseEin Wasserzeichen für KI-generierte Inhalte anfordern.
content_filterbooleantrueDie Kunden-API akzeptiert false. Im Playground dürfen nur Administratoren die Prüfung deaktivieren.

Die Parameter n, seed, stream, resolution, aspect_ratio, image_urls und response_format werden nicht unterstützt. Undokumentierte Felder werden verworfen und aktivieren diese Funktionen nicht. Multipart-Uploads, Base64 und data-URIs werden abgelehnt.

Ausgabegröße

Die Generierung akzeptiert 1K, 1.5K, 2K oder genaue WIDTHxHEIGHT-Pixelangaben. Genaue Größen müssen insgesamt 921.600–4.624.220 Pixel und ein Seitenverhältnis von 1:16 bis 16:1 haben. Beispielsweise ist 2048x1152 gültig. Ein Verhältnis wie 16:9 ist kein Größenwert.

Die Ebenenzerlegung akzeptiert auto, 1K, 1.5K oder 2K; genaue Pixelangaben werden in diesem Modus nicht unterstützt. auto richtet sich nach der Eingabe und reserviert den höheren Ausgabetarif. Das Modell hat keine 3K- oder 4K-Vorgabe.

Referenzbilder und Bearbeitung

Gib von dir gehostete öffentliche HTTP(S)-URLs ohne eingebettete Zugangsdaten an. Unterstützt werden JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC und HEIF, bis zu 30 MB pro Bild und höchstens 36.000.000 Pixel insgesamt. AVIF und JP2 werden nicht unterstützt. Eine URL muss direkt ein Bild ohne Anmeldung oder Browserprüfung bereitstellen.

{
  "model": "seedream-5-5",
  "prompt": "Change the scene to a snowy winter night. Keep the lighthouse and its composition.",
  "image": "https://your-cdn.example/lighthouse.jpg",
  "size": "2K"
}

Übergib für mehrere Referenzen ein URL-Array und erkläre die Rolle jedes Bildes im Prompt. Das Ergebnis bleibt ein Bild. Referenz-URLs in Beispielen sind Platzhalter: Ersetze sie durch deine eigenen erreichbaren Dateien.

Ebenenzerlegung und Texterkennung

{
  "model": "seedream-5-5",
  "image": "https://your-cdn.example/poster.png",
  "size": "1K",
  "layer_decomposition": true,
  "layer_decomposition_options": {
    "max_images": 4,
    "text_recognition": true
  }
}

Die Obergrenze umfasst das Basisbild; 4 bedeutet höchstens vier zurückgegebene Bilder, nicht vier Ebenen plus Basisbild. Das Modell kann weniger liefern. Lasse prompt für eine automatische Zerlegung weg oder benenne die zu trennenden Elemente. Ein Prompt kann Text unterdrücken, den er ausschließt.

Ebenen sind PNG-Dateien mit Transparenz. Baue das Bild in aufsteigender z_index-Reihenfolge auf, mit dem Basisbild bei 0. Falls ein Begrenzungsrahmen angegeben ist, skaliere die Ebene vor der Platzierung auf diesen Rahmen: Die Pixelabmessungen der Ebenendatei können von ihren Platzierungsabmessungen abweichen.

Das optionale text_recognition enthält den vollständigen text und lines. Jede Zeile kann eine bounding_box und formatierte runs enthalten. Der style eines Runs kann similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow und translucent umfassen. Dies sind Modellschätzungen. Künstlerische oder handschriftliche Schrift kann ohne Textergebnis bleiben; behandle das Feld als optional.

Abgeschlossene Antwort

{
  "id": "task_example",
  "model": "seedream-5-5",
  "status": "completed",
  "created_at": 1794432000,
  "output": {
    "data": [
      {
        "url": "https://api.wanapi.app/v1/tasks/task_example/artifacts/image-1/content?access=EXAMPLE",
        "size": "1248x832",
        "output_format": "png"
      }
    ]
  }
}

Jedes Bild hat eine url und size. Weitere mögliche Felder sind output_format, background, z_index, name, description, bounding_box und text_recognition. bounding_box.absolute ist [left, top, right, bottom] in Pixeln des Basisbildes. bounding_box.normalized verwendet dieselben Koordinaten, skaliert auf 0–1000. Gehe nicht davon aus, dass optionale Metadaten bei jedem Bild vorhanden sind.

Behandle Bild-URLs als private Downloadlinks und speichere benötigte Dateien. Eine URL mit einem access-Token kann geöffnet werden, ohne deinen Konto-API-Schlüssel offenzulegen.

Preise

Abrechenbares BildUSD pro Bild
Ausgabe bis 2,61 MP (1K / 1.5K)0,017 $
Ausgabe über 2,61 MP (2K)0,02975 $
Jedes Referenzbild, auch das erste0,0068 $

Tarife werden automatisch aktualisiert. Ein API-Schlüssel funktioniert mit allen Modellen und Gruppen.

Die Ausgabegrenze liegt bei 2.610.000 Pixeln. Berechne die Kosten so:

lower-band output count × lower-band rate
+ higher-band output count × higher-band rate
+ reference image count × reference rate

Jede Referenz wird berechnet, einschließlich der ersten und des Ausgangsbildes für Ebenen. Für Generierung und Ebenen gelten dieselben Ausgabetarife. Beim Senden wird eine Ausgabe beziehungsweise die Ebenenobergrenze max_images plus Referenzen reserviert. Beim Abschluss zählen die eigenen Pixelabmessungen jedes zurückgegebenen Bildes; die ungenutzte Reservierung wird freigegeben. Die akzeptierte Aufgabe behält ihren Preisschnappschuss, auch wenn sich die Tarife während der Ausführung ändern. Fehlgeschlagene Aufgaben werden erstattet.

Fehler und Wiederholungsverhalten

Ungültige Parameter werden vor dem Senden abgelehnt. Unzureichendes Guthaben oder Schlüsselkontingent verhindert die Generierung. Authentifizierung und Eigentumsprüfung gelten sowohl beim Senden als auch beim Abfragen. Eine fehlgeschlagene Aufgabe liefert status: "failed" mit einem error-Objekt.

Wiederhole eine fehlgeschlagene Statusabfrage mit derselben Aufgaben-ID. Wiederhole einen Generierungs-POST nicht automatisch, auch nicht nach einem Timeout: Er könnte bereits akzeptiert worden sein. Solange der vorgelagerte Dienst normalen Fortschritt meldet, bleibt die Aufgabe ausstehend. Eine Aufgabe ohne normalen vorgelagerten Status oder erfolgreiche Auslieferung während drei aufeinanderfolgenden Stunden schlägt fehl und wird erstattet.

Die Seedream 5.5 Anleitung zeigt eine Anwendungsschleife, die die Aufgaben-ID speichert und wieder aufnimmt.

Seedream 5.0 Pro

Seedream 5.0 Pro API: Bilder aus Text, Bearbeitung mit Referenzen, Ebenenzerlegung, transparente PNGs, Anfragefelder, Antworten und Preise.

Claude API

Claude per Anthropic Messages oder OpenAI Chat Completions aufrufen: Modell-IDs, Streaming und aktuelle Token- und Cache-Preise nach Gruppe.

Inhaltsverzeichnis

Authentifizierung und EndpunkteEin Bild generierenParameterAusgabegrößeReferenzbilder und BearbeitungEbenenzerlegung und TexterkennungAbgeschlossene AntwortPreiseFehler und Wiederholungsverhalten