Seedance 2.5

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

Verbindung mit Wan API herstellenÜberschriftenlink kopieren

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.

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

Eine Aufgabe mit Seedance 2.5 absendenÜberschriftenlink kopieren

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.5",
  "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.5 abfragenÜberschriftenlink kopieren

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.5: PreiseÜberschriftenlink kopieren

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.

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

AnfragefelderÜberschriftenlink kopieren

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.

Eingabekombinationen und MediengrenzenÜberschriftenlink kopieren

• 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 30 Bilder, 10 Videos und 10 Audioclips mit insgesamt höchstens 50 Referenzen.

• Einzelbildeingaben erfordern aspectRatio: "adaptive". Referenzaudio kann ohne Bild oder Video verwendet werden.

• 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, HEIC oder HEIF; kleiner als 30 MB; jede Seite 300–6000 Pixel; Seitenverhältnis 0.4–2.5.

• Videos: MP4 oder MOV; höchstens 200 MB pro Datei; jeder Clip 2–30 Sekunden und zusammen höchstens 30 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–30 Sekunden und zusammen höchstens 30 Sekunden.

• 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Überschriftenlink kopieren

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Überschriftenlink kopieren

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.5",
  "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Überschriftenlink kopieren

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.5",
  "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
}

EntwurfsvorschauÜberschriftenlink kopieren

Verwende providerOptions.bytedance.draft: true mit resolution: "480p", um einen Entwurf zu erstellen. Dabei gilt der normale 480p-Tokentarif. Dieser Endpunkt akzeptiert keine frühere Entwurfsaufgabe als Eingabe für ein finales Rendering; eine neue Generierung ist eine separate Anfrage.

{
  "model": "bytedance/seedance-2.5",
  "prompt": "A paper boat floats through a sunlit stream. Slow tracking shot.",
  "resolution": "480p",
  "aspectRatio": "16:9",
  "duration": 4,
  "generateAudio": true,
  "providerOptions": {
    "bytedance": {
      "draft": true
    }
  }
}

Video per Statusabfrage abrufen und herunterladenÜberschriftenlink kopieren

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.5",
  "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.

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.5",
  "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.5",
  "status": "failed",
  "error": {
    "code": "generation_failed",
    "message": "Video generation failed"
  }
}

Abrechnung und FehlerbehandlungÜberschriftenlink kopieren

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.5 herunterladen.