ByteDance

Seedance 2.5

seedance-2.5/image-to-video

Byte Seeds gemeinsames Audio-Video-Generierungsmodell, das durchgehende Clips von bis zu 30 Sekunden und bis zu 4K unterstützt und dank multimodaler Referenzen und Bearbeitung auf Zeitstempel-Ebene eine präzise Steuerung des Bildes ermöglicht

seedance-2.5/image-to-video seedance-2.5/reference-to-video seedance-2.5/text-to-video

seedance-2.5/image-to-video ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

video

Fülle die Parameter aus und generiere – die Ergebnisse erscheinen hier.

Preise

seedance-2.5/image-to-video per second

Spezifikationen	Einzelpreis
720P	$0.204
1080P	$0.516

Einordnung und Kurzprofil

Die Bild-zu-Video-Pipeline von Seedance 2.5 richtet sich an Entwickler, die präzise Kontrolle über das Bild benötigen: Ausgehend von einem Startbild, optional mit einem Endbild als festgelegtem Zielpunkt, beschreibt man per Prompt Bewegung, Kamera und Szene und erhält ein zusammenhängendes Video von 4 bis 30 Sekunden. Das Modell erzeugt während der Bilderzeugung gleichzeitig synchronisierten Dialog, Soundeffekte und Umgebungsgeräusche und unterstützt Ausgaben in 720p und 1080p sowie die Container mp4 und mov. Es eignet sich für vorhandenes Standbildmaterial, das zu kurzen Videos erweitert werden soll – für Produktpräsentationen, Werbe-Shot-Previews und serielle Content-Produktion.

Kernhighlights

Beidseitige Kameraführung über Start- und Endbild – Mit einem Startbild und optional einem festgelegten Endbild liegen Anfang und Ende des generierten Videos auf vorhandenem Material, was wiederholte Neugenerierungen reduziert.
Bild und Audio in einem Durchgang – Standardmäßig werden Dialog, Soundeffekte und Hintergrundaudio synchron erzeugt, eine separate Vertonung ist nicht mehr nötig.
Prompts in elf Sprachen – Anweisungen zu Bewegung, Kamera, Szene und Audio lassen sich in mehreren Sprachen verfassen, was die Zusammenarbeit in mehrsprachigen Teams erleichtert.
Wählbare Auflösung und Container – Unterstützt 720p und 1080p sowie mp4 und mov; mov erleichtert den Einstieg in professionelle Postproduktions-Workflows.

Funktionsbeschreibung

Startbildgesteuerte Videogenerierung: Ausgehend von einem Startbild in Formaten wie jpeg, png oder webp wird ein Video erzeugt; das Bildseitenverhältnis folgt automatisch dem Startbild und eignet sich für die Weiterführung bereits finalisierter Standbilder.

Kontrolle des Endbild-Zielpunkts: Optional lässt sich ein Endbild hinzufügen, das das Schlussbild des Videos festlegt; bei abweichendem Seitenverhältnis wird es mittig beschnitten und an das Startbild angepasst, was gezielte Kamerafahrten mit festem Endpunkt ermöglicht.

Synchronisierte Audiogenerierung: Standardmäßig werden bildsynchroner Dialog, Soundeffekte und Hintergrundgeräusche erzeugt; dies lässt sich deaktivieren, um reines Bildmaterial für die Postproduktion zu erhalten.

Dauer- und Qualitätsparameter: Die Dauer wird als ganze Zahl zwischen 4 und 30 Sekunden festgelegt und nach angeforderter Dauer abgerechnet; die Auflösung ist zwischen 720p und 1080p wählbar, die Ausgabe erfolgt als mp4 oder mov.

Ergänzung durch Online-Informationen: Eine optionale Websuche kann aktiviert werden, sodass zeitkritische Informationen im Prompt bei der Generierung berücksichtigt werden.

Anwendungsszenarien

E-Commerce- und Produktteams: Produkt-Hero-Bilder – Mit einem Produkt-Standbild als Startbild wird ein Präsentationsclip erzeugt; Bild und Audio entstehen synchron und sind direkt für Detailseiten oder Werbematerial nutzbar.
Kreativteams für Werbung: Storyboard-Keyframes – Keyframes aus Storyboard-Entwürfen werden zu Sequenzen mit Kamerabewegung und Soundeffekten erweitert, etwa für Präsentationen und Previews vor dem Dreh.
Marken-Content-Operations: Finalisierte Charakter- und Szenenbilder – Bereits abgenommene Charakter- oder Szenenbilder werden zu einer Reihe von Kurzvideos erweitert, wobei das Erscheinungsbild konsistent bleibt und Social-Content in Serie entsteht.
Postproduktion: Vervollständigung von Start- und Endbild-Shots – Aus vorgegebenem Anfangs- und Endbild wird der Zwischenverlauf generiert, etwa zur Materialverkettung oder zum Schließen von Übergangsaufnahmen.

Einschränkungen und Auswahlempfehlungen

Ein einzelner Generierungsclip umfasst maximal 30 Sekunden; längere Inhalte müssen in mehrere Segmente aufgeteilt werden. Physikalische Plausibilität komplexer Bewegungen und die Stabilität bei Interaktionen mehrerer Subjekte bleiben bekannte Schwächen; bei Szenen mit großen Bewegungsamplituden oder vielen Personen empfiehlt sich zunächst ein Test mit kurzen Samples. Werden Start- und Endbild gleichzeitig angegeben, lassen sich keine weiteren Referenzbilder oder Referenzaudios hinzufügen; für mehrere Referenzbedingungen sollte stattdessen die Referenz-zu-Video-Pipeline verwendet werden. Für leichte Anforderungen mit einer einzigen Einstellung und geringem Kontrollbedarf bietet sich die einfachere Text-zu-Video-Pipeline an.

Häufige Fragen

Alle Fragen ansehen →

Müssen bei Seedance 2.5 für die Bild-zu-Video-Generierung sowohl das erste als auch das letzte Frame hochgeladen werden?

Nein. Im Modus für das erste Frame bzw. erstes und letztes Frame erweitert das Modell die nachfolgenden Bilder auf natürliche Weise, wenn nur first_frame_url hochgeladen wird. Wenn der Endzustand der Kamerafahrt gesteuert werden soll, kann zusätzlich last_frame_url angegeben werden. Das letzte Frame kann nicht allein verwendet werden. Alternativ können reference_image_urls oder reference_audio_urls als Referenzmodus verwendet werden, ohne Endpunkt-Frames zu übergeben.
Können das erste Frame, das erste und letzte Frame sowie mehrere Referenzmaterialien in einer einzigen Anfrage kombiniert werden?

Derzeit behandelt HiAPI Playground sie als zwei Eingabemodi: den Modus „erstes Frame/erstes und letztes Frame“ oder den Referenzmodus mit reference_image_urls und reference_audio_urls. Um Konflikte zwischen den Steuersignalen zu vermeiden, bitte pro Anfrage nur einen Modus verwenden; wenn ein Referenzvideo zur Steuerung von Bewegungen oder Kamerafahrten benötigt wird, stattdessen das separate seedance-2.5/reference-to-video verwenden.
Welche Dauern und Auflösungen unterstützt Seedance 2.5 bei der Bild-zu-Video-Generierung?

Der aktuelle Anfragevertrag unterstützt ganzzahlige Dauern von 4–30 Sekunden sowie 720p und 1080p. Die Ausgabe von aspect_ratio ist fest auf adaptive gesetzt und folgt dem Seitenverhältnis des ersten Frames. Die vier Beispiele auf der Seite sind alle in 720p, davon drei mit 4 Sekunden und eines mit 5 Sekunden; 30 Sekunden liegt im vom Interface unterstützten Bereich, für das derzeit kein entsprechendes Beispiel auf der Seite vorhanden ist.
Wie wird die Bilder-zu-Video-Funktion von Seedance 2.5 abgerechnet?

Die Abrechnung erfolgt nach Ausgabedauer und Auflösung; für 720p und 1080p gelten unterschiedliche Tarife pro Sekunde. Die konkreten Beträge richten sich nach dem Echtzeitpreis auf der Modellseite und dem Aufgabenprotokoll.

Generierungsaufgabe erstellen

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.

Idempotency-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.

Body

modelstringPflicht

Aktueller Festwert: seedance-2.5/image-to-video

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für seedance-2.5/image-to-video und Route default — siehe Parametertabelle unten.

promptstringPflichtminLength 1maxLength 10000

Gib Generierungsanweisungen zu Bewegung, Kamera, Szene und Audio; unterstützt mehrere Prompt-Sprachen.

durationintegerOptionalStandard: 5min 4max 30

Ausgabedauer des Videos in Sekunden; bitte eine ganze Zahl von 4 bis 30 angeben, Standard 5. HiAPI rechnet nach angeforderter Dauer ab.

watermarkbooleanOptionalStandard: false

Ob ein KI-generiertes Wasserzeichen unten rechts im Bild hinzugefügt wird, Standard false.

resolutionstringOptionalStandard: "720p"

Auflösung des Ausgabevideos, unterstützt 720p und 1080p, Standard 720p.

Optionen:720p1080p

web_searchbooleanOptionalStandard: false

Ob dem Modell erlaubt wird, im Prompt erwähnte Echtzeitinformationen online abzurufen, Standard false.

aspect_ratiostringOptionalStandard: "adaptive"

Seitenverhältnis der Ausgabe; bei Bild-zu-Video wird adaptiv verwendet, damit das Video dem ersten Frame folgt, Standard adaptive.

Optionen:adaptive

output_formatstringOptionalStandard: "mp4"

Dateiformat des Ausgabevideos; mp4 ist der Standardwert mit besserer Kompatibilität, mov richtet sich an professionelle Postproduktion, Standard mp4.

Optionen:mp4mov

generate_audiobooleanOptionalStandard: true

Ob synchronisierte Dialoge, Soundeffekte und Hintergrundaudio generiert werden, Standard true.

last_frame_urlstringOptional

Optional, gibt das Endframe-Bild an; es kann eine Bild-URL, Data-URL oder Asset-ID übergeben werden; die Dateibeschränkungen entsprechen denen des ersten Frames. Weicht das Seitenverhältnis vom ersten Frame ab, wird mittig zugeschnitten, um es am ersten Frame auszurichten.

first_frame_urlstringOptional

Bild des ersten Frames; es kann eine Bild-URL, Data-URL oder Asset-ID übergeben werden; unterstützt mehrere gängige Bildformate, Größe höchstens 30 MB, 300–6000 Pixel pro Seite, Seitenverhältnis 0,4–2,5. Erforderlich, wenn last_frame_url angegeben ist.

reference_audio_urlsarrayOptionalmaxItems 10

Array von Referenzaudio-URLs, maximal 10 Einträge; unterstützt wav, mp3, je Eintrag höchstens 15 MB und 2–30 Sekunden Dauer, Gesamtdauer höchstens 30 Sekunden.

Array [ string ]

reference_image_urlsarrayOptionalmaxItems 30

Array von Referenzbild-URLs, maximal 30 Einträge; unterstützt mehrere gängige Bildformate, je Bild höchstens 30 MB, 300–6000 Pixel pro Seite, Seitenverhältnis 0,4–2,5.

Array [ string ]

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.

urlstringPflicht

Pflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.

whenstringOptionalStandard: "final"

Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.

Optionen:final

storagestringOptionalStandard: "temp"

Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.

Optionen:temppersistent

Anfragebeispiele

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.5/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "watermark": false,
    "resolution": "720p",
    "web_search": false,
    "aspect_ratio": "adaptive",
    "output_format": "mp4",
    "generate_audio": true
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedance-2.5/image-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "watermark": false,
      "resolution": "720p",
      "web_search": false,
      "aspect_ratio": "adaptive",
      "output_format": "mp4",
      "generate_audio": true
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "seedance-2.5/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "watermark": False,
          "resolution": "720p",
          "web_search": False,
          "aspect_ratio": "adaptive",
          "output_format": "mp4",
          "generate_audio": True
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Aufgabendetails abrufen

GET https://api.hiapi.ai/v1/tasks/:id

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

queued Eingereiht, noch nicht gestartet. handling In Verarbeitung. archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet. success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben). fail Endzustand: fehlgeschlagen (error wird zurückgegeben). Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-Sekunden des Endzustands; vor Abschluss stets 0.

outputarrayOptional

Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).

Array [ object ]

Array-Elemente

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

Antwortbeispiele

Erfolg

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In Bearbeitung (nicht final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fehlgeschlagen

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}