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 Funny AI 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 14 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. Für eine neue Szene sind model und ein nicht leerer Prompt oder mindestens eine Medieneingabe erforderlich; andere Felder sind optional. Sende für ein finales Rendering nur model, draftTaskId und resolution: "1080p" (optional n: 1 und providerOptions.bytedance.output_format). 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–6.000 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–6.000 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.

• Verwende draftTaskId, um einen abgeschlossenen Entwurf in 1080p zu rendern. Beliebige native Aufgabenoptionen werden nicht akzeptiert.

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. Verwende nach Abschluss seine öffentliche Aufgaben-ID für ein separates finales Rendering in 1080p.

{
  "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
    }
  }
}

Einen Entwurf in 1080p rendernÜberschriftenlink kopieren

Sende diesen Body an POST /v1/videos und verwende dabei die öffentliche task_…-ID des abgeschlossenen Entwurfs. Der Entwurf muss zu deinem Konto gehören, dasselbe Modell und denselben Kanal verwenden und weniger als 7 Tage alt sein. Diese native Gültigkeitsdauer des Entwurfs ist unabhängig von der Speicherdauer des Videos.

{
  "model": "bytedance/seedance-2.5",
  "draftTaskId": "task_YOUR_COMPLETED_DRAFT",
  "resolution": "1080p"
}

Sende prompt, Medien, duration, aspectRatio, seed, generateAudio, fps, draft oder referenceAudio nicht erneut. Diese Einstellungen werden aus dem Entwurf übernommen. Für die finale Ausgabe kannst du providerOptions.bytedance.output_format festlegen. Die API gibt eine neue Aufgaben-ID zurück; frage GET /v1/videos/{new_task_id} ab, um das finale Video und seine Bunny-URL abzurufen.

Das finale Rendering wird separat zum aktuellen 1080p-Tarif und in der Referenzvideo-Preisstufe des ursprünglichen Entwurfs abgerechnet. Grundlage sind die tatsächlich bei der Fertigstellung erfassten Tokens. Statusabfragen erzeugen keine neue Generierung und keine erneuten Kosten. Ist das Ergebnis des Absendeversuchs unklar, sende die Anfrage nicht automatisch erneut.

MOV-AusgabeÜberschriftenlink kopieren

Setze providerOptions.bytedance.output_format auf mov für MOV oder auf mp4 für MP4 (Standard). Diese Ausgabeoption lässt sich sowohl für eine neue Szene als auch für das finale Rendering eines Entwurfs verwenden.

{
  "model": "bytedance/seedance-2.5",
  "prompt": "A red ball on a plain table. Static camera.",
  "resolution": "480p",
  "duration": 4,
  "providerOptions": {
    "bytedance": {
      "output_format": "mov"
    }
  }
}

Nach Abschluss enthält videos[0].url die signierte Bunny-URL der ursprünglichen .mov-Datei und videos[0].mediaType den Wert video/quicktime. MOV wird nicht in MP4 umgewandelt. Die Wiedergabe im Browser hängt von der Codec-Unterstützung ab; lade die Datei herunter, falls dein Browser sie nicht abspielen kann. Die Dateien werden zu Bunny hochgeladen; in der Datenbank werden nur Dateiverweise und Aufgabenmetadaten gespeichert. Base64-Medieneingaben werden nicht akzeptiert.

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.