LogoWan API – Dokumentation
LogoWan API – Dokumentation
StartseiteWan API im ÜberblickWan API IntegrationsanleitungWan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime ProSeedance 2.5Seedance 2.0

Seedance 2.0 Fast

Seedance 2.0 Fast API-Dokumentation: Videogenerierung, Einzelbilder und Referenzen, Anfragebeispiele, Statusabfragen, Downloads und Preise.

Seedance 2.0 Fast unterstützt Text, Start- und Endbilder sowie Bild-, Video- und Audioreferenzen mit Ausgabe in 480p, 720p. Generiere bis zu 15 Sekunden pro Anfrage. Modelldetails und Playground.

Verbindung mit Wan API herstellen

Verwende https://api.wanapi.app als API-Basis-URL. Erstelle in den API-Schlüsseleinstellungen einen Schlüssel für die Modellfamilie Seedance und übermittle ihn als Authorization: Bearer YOUR_API_KEY. Bewahre Schlüssel auf deinem Server auf. Der Playground nutzt deine Website-Sitzung und belastet dasselbe Kontoguthaben; du musst keinen Schlüssel in den Browser einfügen.

Der Zugang erfordert ein freigeschaltetes Konto mit ausreichendem Guthaben. GET /v1/models listet die für deinen Schlüssel verfügbaren Modelle auf. Seedance-Modelle verwenden POST /v1/videos; wähle das Modell im JSON-Body.

EinstellungSeedance 2.0 Fast
Modell-IDbytedance/seedance-2.0-fast
resolution480p, 720p; Standard: 720p.
duration4–15 Ausgabesekunden oder -1 für automatisch; Standard: 5.
aspectRatioadaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9; Standard: adaptive.
generateAudioStandardmäßig true. false senkt den Tokentarif nicht.
AusgabeEin Video pro Anfrage, mit 24 fps.

Die Anfragefelder beschreiben alle 13 Felder auf oberster Ebene. Verwende die hier gezeigten Feldnamen, einschließlich aspectRatio und generateAudio.

Eine Aufgabe mit Seedance 2.0 Fast absenden

Dies ist eine Text-zu-Video-Anfrage über vier Sekunden in 720p. Setze WAN_API_KEY auf dem Server auf deinen Seedance-Schlüssel. Sende einmal und speichere die zurückgegebene id.

curl https://api.wanapi.app/v1/videos \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.0-fast",
  "prompt": "A paper boat floats through a sunlit stream. Slow tracking shot.",
  "resolution": "720p",
  "aspectRatio": "16:9",
  "duration": 4,
  "generateAudio": true
}'

Eine Aufgabe von Seedance 2.0 Fast abfragen

Speichere die zurückgegebene id als TASK_ID und frage dann mit demselben Schlüssel ab. Das Absenden liefert eine Aufgabenbestätigung; das Video ist nach Abschluss verfügbar. Beginne mit Abfragen im Abstand von fünf Sekunden; siehe Aufgabenstatus und Downloads.

curl "https://api.wanapi.app/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $WAN_API_KEY"

Seedance 2.0 Fast: Preise

Die Tarife sind in USD pro eine Million Videotokens angegeben. Eingabe- und Ausgabe-Videotokens bestimmen die endgültigen Kosten. Auflösung, Dauer und Referenzvideo-Eingaben beeinflussen den Verbrauch; verwende den passenden Tarif für Anfragen mit oder ohne Referenzvideo. Für Audio gibt es keine eigene Preisstufe.

Aktuelle TarifeGeschätzte USD / abrechenbare Sekunde
Geschätzte Preise für Seedance 2.0 Fast in USD pro abrechenbarer Sekunde (16:9, 24 fps)
AuflösungReferenzvideoOffizieller PreisWan API-PreisDu sparst
480pOhne Video0,0562 $Nicht verfügbar—
480pMit Video0,0331 $Nicht verfügbar—
720pOhne Video0,121 $Nicht verfügbar—
720pMit Video0,0713 $Nicht verfügbar—

Die Schätzungen basieren auf einer Ausgabe in 16:9 mit 24 fps. Andere Seitenverhältnisse und die tatsächlichen Ausgabeabmessungen können die Kosten verändern.

Ohne Referenzvideo zählen nur die Ausgabesekunden. Mit Referenzvideo zählen Eingabe- und Ausgabesekunden; die abrechenbare Eingabedauer beträgt mindestens zwei Drittel der Ausgabedauer, auf eine ganze Sekunde aufgerundet.

Offizieller Vergleich: Internationale nutzungsabhängige Preise von BytePlus. Geprüft am 2026-10-15. Wan API-Preise werden automatisch aktualisiert.

Eingabe- und Ausgabe-Videotokens bestimmen die endgültigen Kosten. Fehlgeschlagene Anfragen werden nicht berechnet.

Preise und Schätzungen für Seedance 2.0 Fast ansehen. Prüfe vor dem Absenden die Schätzung im Playground.

Anfragefelder

Sende ein JSON-Objekt. model ist erforderlich, zusammen mit einem nicht leeren Prompt oder mindestens einer Medieneingabe. Andere Felder sind optional. Unbekannte Felder werden abgewiesen.

FeldTypVorgaben
modelZeichenfolgeErforderlich: bytedance/seedance-2.0-fast.
promptZeichenfolgeTextanweisungen; bei diesem Dienst bis zu 20.000 Zeichen. Ein Prompt oder eine Medieneingabe ist erforderlich.
imageURL oder URL-ObjektURL des Startbilds oder ein Objekt mit type: "url", url und optional mediaType. Verwende entweder image oder frameImages.
frameImagesArrayEin first_frame und optional ein last_frame. Jeder Eintrag enthält frameType und image; siehe Einzelbildbeispiel unten.
inputReferencesArrayBis zu 9 Bilder und 3 Videos. Jeder Eintrag enthält type: "url", url und mediaType. Auch das URL-Format mit data/mediaType wird akzeptiert.
aspectRatioZeichenfolgeadaptive (Standard), 16:9, 4:3, 1:1, 3:4, 9:16, 21:9.
resolutionZeichenfolge480p, 720p. Standard: 720p. Akzeptiert auch 854x480, 1280x720 als Auflösungsstufen; wähle die Form mit aspectRatio.
durationGanzzahl4–15 Ausgabesekunden oder -1 für automatisch. Standard: 5.
fpsGanzzahlFest auf 24; weglassen oder 24 senden.
seedGanzzahlOptional; -1 bis 2147483647. Keine Garantie für Wiederholbarkeit. Gib nicht zusätzlich providerOptions.bytedance.seed an.
generateAudioBoolescher WertTon generieren. Standard: true; Deaktivieren ändert den Tokentarif nicht.
nGanzzahlFest auf 1; ein Video pro Anfrage.
providerOptionsObjektOptionales bytedance-Objekt: referenceAudio (bis zu 3 HTTP(S)-URLs), seed (dieselben Grenzen wie seed auf oberster Ebene). draft: true wird nicht unterstützt. Unbekannte Optionen werden abgewiesen.

Eingabekombinationen und Mediengrenzen

  • Verwende image für ein Startbild oder frameImages für ein Startbild mit optionalem Endbild. Ein Endbild allein und doppelte Einzelbildtypen werden abgewiesen.

  • Einzelbilder lassen sich nicht mit inputReferences oder providerOptions.bytedance.referenceAudio kombinieren.

  • Der Referenzmodus akzeptiert bis zu 9 Bilder, 3 Videos und 3 Audioclips mit insgesamt höchstens 15 Referenzen.

  • Medieneingaben müssen öffentliche HTTP(S)-URLs sein. Hochgeladene Bytes und URLs mit Zugangsdaten werden nicht akzeptiert.

  • Bilder: JPEG, PNG, WebP, BMP, TIFF oder GIF; kleiner als 30 MB; jede Seite 300–6000 Pixel; Seitenverhältnis 0.4–2.5.

  • Videos: MP4 oder MOV; höchstens 50 MB pro Datei; jeder Clip 2–15 Sekunden und zusammen höchstens 15 Sekunden; 300–6000 Pixel pro Seite, Seitenverhältnis 0.4–2.5, 24–60 fps.

  • Audio: MP3 oder WAV; höchstens 15 MB pro Datei; jeder Clip 2–15 Sekunden und zusammen höchstens 15 Sekunden. Mindestens ein Referenzbild oder -video ist erforderlich.

  • Größe, Kodierung und Dauer entfernter Medien werden während der Verarbeitung geprüft; die URL-Prüfung allein garantiert keine nutzbare Datei.

  • Das finale Rendern aus einer früheren Entwurfsaufgabe und beliebige native Aufgabenoptionen stehen über diesen Endpunkt nicht zur Verfügung.

Beispiele für Einzelbilder und Referenzen

Sende diese Bodys an denselben Endpunkt POST /v1/videos. Ersetze vor dem Absenden jede example.com-URL durch deine eigene direkt zugängliche Medien-URL. Halte die Eingabe-URLs bis zum Abschluss der Aufgabe verfügbar.

Start- und Endbilder

Verwende für ein einzelnes Startbild image: "https://example.com/first-frame.jpg" und lasse frameImages weg. Um beide Endpunkte des Clips festzulegen, verwende:

{
  "model": "bytedance/seedance-2.0-fast",
  "prompt": "The camera slowly moves from the opening scene to the closing scene.",
  "frameImages": [
    {
      "frameType": "first_frame",
      "image": "https://example.com/first-frame.jpg"
    },
    {
      "frameType": "last_frame",
      "image": "https://example.com/last-frame.jpg"
    }
  ],
  "aspectRatio": "adaptive",
  "resolution": "720p",
  "duration": 4
}

Bild-, Video- und Audioreferenzen

Trage Bild- und Videoeingaben mit explizitem MIME-Typ in inputReferences ein. Audio-URLs gehören in providerOptions.bytedance.referenceAudio. Füge dieser Anfrage keine Einzelbildeingaben hinzu.

{
  "model": "bytedance/seedance-2.0-fast",
  "prompt": "Use the character from the image and the camera movement from the video.",
  "inputReferences": [
    {
      "type": "url",
      "url": "https://example.com/character.jpg",
      "mediaType": "image/jpeg"
    },
    {
      "type": "url",
      "url": "https://example.com/motion.mp4",
      "mediaType": "video/mp4"
    }
  ],
  "providerOptions": {
    "bytedance": {
      "referenceAudio": [
        "https://example.com/sound.wav"
      ]
    }
  },
  "resolution": "720p",
  "duration": 4
}

Video per Statusabfrage abrufen und herunterladen

Eine akzeptierte Aufgabe gibt ein Objekt wie dieses zurück. Die Beispiel-IDs und Zeitstempel dienen der Veranschaulichung:

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.0-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1792022400
}

Frage GET /v1/videos/{task_id} mit deinem API-Schlüssel ab. Die Abfrage liefert dieselbe öffentliche Aufgaben-ID und dasselbe Modell zurück. Entscheide anhand von status, wann du die Abfragen beendest; progress ist keine Schätzung der verbleibenden Zeit.

StatusBedeutungNächster Schritt
queuedDie Aufgabe wurde angenommen.Weiter abfragen.
in_progressDie Generierung läuft.Weiter abfragen.
completedDas Video ist bereit.videos[0].url lesen und herunterladen.
failedDie Generierung ist fehlgeschlagen.Abfragen beenden und error prüfen.

Eine abgeschlossene Abfrage enthält videos, ein Array aus Objekten mit url und mediaType. Zeitstempel verwenden Unix-Sekunden; completed_at erscheint, sobald der Abschluss erfasst ist.

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.0-fast",
  "status": "completed",
  "progress": 100,
  "created_at": 1792022400,
  "completed_at": 1792022460,
  "videos": [
    {
      "url": "/v1/tasks/task_EXAMPLE/artifacts/video/content",
      "mediaType": "video/mp4"
    }
  ]
}

Ist die zurückgegebene URL ein relativer Pfad, löse ihn gegen https://api.wanapi.app auf und authentifiziere dich mit deinem API-Schlüssel. Für das obige Beispiel:

curl "https://api.wanapi.app/v1/tasks/$TASK_ID/artifacts/video/content" \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -o video.mp4

Wird eine signierte HTTPS-Medien-URL zurückgegeben, verwende sie direkt, ohne deinen API-Schlüssel an diesen Host weiterzugeben. Ergebnis-URLs können ablaufen. Speichere Videos, die du behalten möchtest, in deinem eigenen Speicher. Statusabfragen und der Download eines vorhandenen Ergebnisses erzeugen keine weitere Generierung.

Eine fehlgeschlagene Aufgabe enthält ein error-Objekt mit code und message, zum Beispiel:

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.0-fast",
  "status": "failed",
  "error": {
    "code": "generation_failed",
    "message": "Video generation failed"
  }
}

Abrechnung und Fehlerbehandlung

Die endgültige Abrechnung richtet sich nach dem tatsächlichen Videotoken-Verbrauch und dem aktuellen Modelltarif. Die Playground-Schätzung ist ein geschätzter Höchstbetrag, kein Festpreisangebot. Längere Clips und höhere Ausgabeauflösungen können den Tokenverbrauch erhöhen. Fehlgeschlagene Anfragen werden nicht berechnet.

  • Ungültige Parameter: Korrigiere vor dem erneuten Absenden die Felder oder Eingabekombination. Prüfe neben der URL-Syntax auch Medienformate und Grenzen.
  • Authentifizierung oder Modellzugang: Verwende einen gültigen Seedance-Schlüssel, der für das angefragte Modell freigeschaltet ist.
  • Nicht genügend Guthaben: Lade vor einer neuen kostenpflichtigen Anfrage Guthaben auf. Ein Schlüssellimit fügt dem Konto kein Guthaben hinzu.
  • Vorübergehender Abfragefehler: Wiederhole den GET mit zunehmendem Abstand und einer maximalen Wartezeit. Eine fehlgeschlagene Abfrage bedeutet nicht, dass die Generierung fehlgeschlagen ist.
  • Zeitüberschreitung beim Absenden oder fehlende Aufgaben-ID: Das Ergebnis kann unklar sein. Wiederhole den POST nicht automatisch; das könnte eine zweite kostenpflichtige Aufgabe erzeugen.
  • Downloadfehler: Versuche zuerst erneut, das vorhandene Ergebnis herunterzuladen, bevor du eine neue Generierung startest.

Bewahre die Aufgaben-ID auf und kontaktiere den Support, wenn ein unklarer Übermittlungsstatus untersucht werden muss.

OpenAPI-Schema für Seedance 2.0 Fast herunterladen.

Inhaltsverzeichnis

Verbindung mit Wan API herstellenEine Aufgabe mit Seedance 2.0 Fast absendenEine Aufgabe von Seedance 2.0 Fast abfragenSeedance 2.0 Fast: PreiseAnfragefelderEingabekombinationen und MediengrenzenBeispiele für Einzelbilder und ReferenzenStart- und EndbilderBild-, Video- und AudioreferenzenVideo per Statusabfrage abrufen und herunterladenAbrechnung und Fehlerbehandlung