ByteDance
Seedance 2.5 Flash
seedance-2.5-flash/image-to-video
Die Videomodellreihe Seedance 2.5 von ByteDance unterstützt Text-zu-Video, die Generierung ausgehend vom ersten Frame sowie multimodale Referenzgenerierung, gibt pro Durchlauf 4 bis 30 Sekunden aus, bietet wahlweise 480p oder 720p und erzeugt synchrones Audio – ideal für die schnelle Produktion von Werbespots und E-Commerce-Produktvideos
seedance-2.5-flash/image-to-video ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
videoPreise
seedance-2.5-flash/image-to-video per second
| Spezifikationen | Einzelpreis |
|---|---|
| 480P | $0.0679 |
| 720P | $0.1525 |
Positionierung und Kurzprofil
Dieses Modell generiert aus einem Startbild ein fortlaufendes Video und bewahrt dabei die Komposition und das Erscheinungsbild des Motivs des Startbilds. Es eignet sich für Entwickler, die aus einem statischen Bild eine dynamische Kamerafahrt entwickeln möchten. Die Eingabe umfasst einen Prompt und ein Startbild, optional ein Endbild zur Festlegung der Schlussszene; die Ausgabe erfolgt in 480p oder 720p, mit einer Dauer von 4 bis 30 Sekunden im Format mp4 oder mov, wobei das Bildformat automatisch an das Seitenverhältnis des Startbilds angepasst wird. Zielgruppe sind Kurzvideo-Kreative, Werbeproduktions- und E-Commerce-Content-Teams, die Produktbilder oder Storyboard-Bilder in veröffentlichungsfähige Videoclips umwandeln möchten.
Zentrale Highlights
- Bildfortsetzung getrieben durch das Startbild – Das Startbild dient als visueller Ausgangspunkt; das Ausgabevideo bewahrt dessen Komposition und Seitenverhältnis und eignet sich zur Erweiterung einer Kamerafahrt aus einem vorhandenen Bild.
- Optionale Endbild-Vorgabe für den Abschluss – Wird ein Endbild bereitgestellt, richtet sich die Schlussszene an diesem Bild aus; bei abweichendem Seitenverhältnis wird es mittig beschnitten, um zum Startbild zu passen.
- Wählbare Dauer und Auflösung – Die Ausgabedauer ist zwischen 4 und 30 Sekunden wählbar, die Auflösung 480p oder 720p; die Abrechnung erfolgt nach der angeforderten Dauer.
- Synchronisierte Audio-Video-Generierung – Standardmäßig werden synchronisierte Dialoge, Soundeffekte und Hintergrundgeräusche generiert, sodass keine separate Nachvertonung erforderlich ist.
Funktionsbeschreibung
Videogenerierung aus dem Startbild: Laden Sie ein Startbild hoch und geben Sie einen Prompt ein; das Modell generiert darauf basierend ein fortlaufendes Video, das der Komposition und dem Motiv des Startbilds folgt, wobei das Bildformat automatisch an das Seitenverhältnis des Startbilds angepasst wird.
Steuerung des Abschlusses per Endbild: Optional kann ein Endbild übergeben werden, damit der Videoschluss zu diesem Bild überleitet; bei abweichendem Seitenverhältnis wird das Endbild mittig beschnitten, um zum Startbild zu passen. Ein Endbild erfordert stets die gleichzeitige Angabe eines Startbilds.
Einstellung von Dauer und Auflösung: Pro Anfrage lassen sich eine Ausgabedauer von 4 bis 30 Sekunden und eine Auflösung von 480p oder 720p festlegen; die Abrechnung erfolgt nach der gewählten Dauer, geeignet für unterschiedlich lange Einstellungen.
Synchronisierte Audiogenerierung: Standardmäßig werden zum Bild synchrone Dialoge, Soundeffekte und Hintergrundaudio generiert; nach Deaktivierung des Schalters wird ein Video ohne Tonspur ausgegeben.
Auswahl des Ausgabecontainers: Das Ausgabeformat ist wahlweise mp4 oder mov; mp4 ist der kompatible Standard, mov richtet sich an professionelle Postproduktions-Workflows.
Anwendungsszenarien
- Erweiterung von Startbildern für Werbe- und Markenkurzfilme – Aus einem Key Visual oder einem Storyboard-Startbild werden dynamische Kamerafahrten als 4- bis 30-sekündige Videos erzeugt, die als Werbe-Intro oder Social-Media-Material dienen.
- Dynamisierung von E-Commerce-Produktdarstellungen – Mit einem Produktbild als Eingabe werden Präsentations- oder Anwendungsszenenvideos generiert, die das Produkterserscheinungsbild bewahren, als mp4 für Produktdetailseiten und Kurzvideo-Plattformen.
- Vertikale Social-Media-Kurzvideos – Ein vertikales Startbild hochladen und Bewegung sowie Kameraführung beschreiben; das Bildformat passt sich automatisch an, und es entsteht ein Kurzvideo mit Audio für die Veröffentlichung auf Social-Plattformen.
- Storyboard-Previsualisierung und Konzeptvisualisierung – Ein Konzeptbild dient als Startbild, zusammen mit einem Endbild zur Steuerung des Abschlusses; schnell entstehen niedrig aufgelöste Videos für interne Reviews und Kameraprevisualisierungen.
Einschränkungen und Empfehlungen zur Auswahl
Die Ausgabedauer ist auf 4 bis 30 Sekunden beschränkt; längere fortlaufende Inhalte müssen in Segmenten generiert werden. Die Auflösung unterstützt nur 480p und 720p. Das Bildformat kann nicht manuell festgelegt werden und folgt stets dem Seitenverhältnis des Startbilds; ein Endbild mit abweichendem Seitenverhältnis wird mittig beschnitten. Das Startbild muss kleiner als 30 MB sein, pro Seite 300 bis 6000 Pixel und ein Seitenverhältnis von 0,4 bis 2,5 aufweisen; unterstützt werden jpeg, png, webp, bmp, tiff, gif, heic und heif. Bei deaktivierter Audiogenerierung wird ein Video ohne Tonspur ausgegeben. Der Prompt umfasst maximal 5000 Zeichen. Die Generierungsergebnisse garantieren keine absolute Konsistenz der Charaktere oder eine exakte Reproduktion des Bildes.
ByteDance Bild-zu-Video-Modell
Fortlaufende Videogenerierung aus dem Startbild
Ausgehend von einem Startbild werden 4- bis 30-sekündige Videos generiert, die Komposition und Seitenverhältnis bewahren; optional kann ein Endbild den Abschluss vorgeben; Auflösung 480p oder 720p, standardmäßig mit synchronisiertem Audio.
- AusgabetypVideo
- EingabeStartbild + Prompt, optional Endbild
- Auflösung480p / 720p
- Dauer4–30 Sekunden
Der Prompt umfasst maximal 5000 Zeichen und kann Bewegung, Kamera und Szene gleichzeitig beschreiben; ein Endbild mit abweichendem Seitenverhältnis wird mittig beschnitten.
Nahaufnahme eines Produktfilms eines matten, weißen Keramik-Handfilterkessels auf einer hellen Stein-Arbeitsplatte. Die Kamera beginnt eng am Ausguss und schwenkt langsam bogenförmig um das Gefäß, während es sich nach vorn neigt und einen dünnen, gleichmäßigen Strahl heißen Wassers in eine darunter stehende Glaskaraffe abgibt; Dampf kräuselt sich nach oben im niedrigen Morgensonnenlicht, das seitlich einfällt, und offenbart die feine körnige Textur der Glasur, die sanfte Kurve des Griffs und einen kühlen Glanz auf dem Metallring des Filters. Die geringe Schärfentiefe hält den Ausguss scharf, während die Küche im Hintergrund weich verschwimmt; sanftes warmes Licht, ruhiges und präzises Tempo, natürliches synchronisiertes Geräusch fließenden Wassers, ein leichtes Klirren der Keramik und leiser Morgenraumklang.
01
Fähigkeiten
Leistung: vier überprüfbare Fähigkeitsgruppen
Die folgenden Fähigkeiten drehen sich alle um das Startbild; durch Prüfung von Eingabematerial und Parameterkombination lässt sich die passende Nutzung bestimmen.
Generierung getrieben durch das Startbild
Laden Sie ein Startbild hoch und geben Sie einen Prompt ein; das Modell generiert darauf basierend ein fortlaufendes Video, das der Komposition und dem Motiv des Startbilds folgt, wobei das Bildformat automatisch an das Seitenverhältnis des Startbilds angepasst wird. Geeignet, um aus vorhandenen visuellen Assets dynamische Kamerafahrten zu entwickeln.
Die Hand eines Barista hält einen Schwanenhalskessel und gießt einen dünnen Strahl heißen Wassers in langsamen Spiralen über einen Papierfilter, der mit Kaffeemehl gefüllt ist; das Mehl quillt auf und steigt zu einer weichen Kuppel aus Schaum empor. Die Kamera beginnt nah am Filterkegel aus einem leicht erhöhten Seitenwinkel und gleitet dann langsam in einem sanften Bogen um den Kessel, wobei Ausguss und Wasserstrahl scharf bleiben. Dampf zieht nach oben durch warmes, schräg einfallendes Morgenlicht aus einem Fenster; Holz-Arbeitsplatte, Keramik-Tassenwärmer, verstreute Kaffeebohnen und ein Leinentuch im weichen Hintergrund. Reiche natürliche Textur, geringe Schärfentiefe, warme Farbkorrektur, gemächlicher Rhythmus mit synchronisierten Geräuschen von fließendem und tröpfelndem Wasser.
Abschlussvorgabe durch das Endbild
Optional kann ein Endbild übergeben werden, damit der Videoschluss zu diesem Bild überleitet. Weicht das Seitenverhältnis des Endbilds vom Startbild ab, wird es mittig beschnitten, um zum Startbild zu passen; das Endbild setzt die gleichzeitige Angabe des Startbilds voraus. Dient der Steuerung der Schlussszene.
Die Kamera fährt vom Key Visual des Produkts im Startbild langsam heran; das Licht geht von weichem Seitenlicht allmählich zu einer stabilen Lichtwirkung der Schlussszene über, und das Bild mündet auf natürliche Weise in die Komposition des Endbilds.
Steuerung von Dauer und Auflösung
Pro Anfrage lassen sich eine Ausgabedauer von 4 bis 30 Sekunden und eine Auflösung von 480p oder 720p festlegen. Die Abrechnung erfolgt nach der gewählten Dauer; kurze Einstellungen können zur schnellen Überprüfung in niedriger Auflösung erzeugt werden, lange Einstellungen können die vollen 30 Sekunden nutzen.
Ein stiller Alpensee bei Sonnenaufgang, gefilmt von einem festen, niedrigen Standpunkt nahe des Ufers: Schichten blassen Nebels ziehen langsam über das ruhige Wasser und dünnen aus, während warmes Morgenlicht hinter dem fernen Grat hervordringt; die Spiegelung schneebedeckter Gipfel und dunkler Kiefernwälder wird allmählich scharf; ein feiner Kreis breitet sich aus, als ein Fisch aufsteigt, verzerrt die Spiegelung, und ein einzelner Wasservogel gleitet tief über die Oberfläche, die Flügel fast das Wasser berührend; langsames, dezentes Heranfahren auf den Nebel, ruhiges Tempo, natürliche Morgengeräusche von Wind in den Kiefern, ferne Vogelrufe und sanftes Anschlagen des Wassers.
Synchronisiertes Audio und Container
Standardmäßig werden zum Bild synchrone Dialoge, Soundeffekte und Hintergrundaudio generiert; dies kann deaktiviert werden. Das Ausgabeformat ist wahlweise mp4 oder mov; mp4 ist der kompatible Standard, mov richtet sich an professionelle Postproduktions-Workflows.
Das Startbild bestimmt den Bildausgangspunkt, der Prompt steuert Bewegung und Kamera, Dauer und Auflösung werden nach Bedarf gewählt, ein Endbild kann den Abschluss vorgeben, und Audio ist standardmäßig aktiviert.
02
Einstieg
Vom Startbild zum Videoclip
Jetzt ausprobieren →Von der Vorbereitung des Startbilds bis zur Überprüfung der Ausgabe wird bei jedem Schritt nur eine Art von Eingabe angepasst, um Effektänderungen leichter zu lokalisieren.
- Bildformatjpeg/png/webp/bmp/tiff/gif/heic/heif
- Größe und Pixelunter 30 MB, pro Seite 300–6000 Pixel
- Seitenverhältnis0,4–2,5
Ein verwendbares Startbild erhalten
01
Startbild vorbereiten
Wählen Sie ein Bild mit klarer Komposition als Startbild und stellen Sie sicher, dass Format, Größe, Pixel und Seitenverhältnis den Anforderungen entsprechen; das Bildformat folgt automatisch diesem Bild.
- PromptBewegung, Kamera und Szene beschreiben
- Zeichenlimit5000 Zeichen
Eine klare Generierungsanweisung erhalten
02
Bewegungs-Prompt verfassen
Beschreiben Sie im Prompt die gewünschte Bewegung, Kamera, Szene und den Ton mit maximal 5000 Zeichen; konzentrieren Sie sich auf Bildveränderungen statt auf die Wiederholung des statischen Erscheinungsbilds.
- Dauer4–30 Sekunden
- Auflösung480p oder 720p
- Endbildoptional, bei abweichendem Seitenverhältnis mittig beschnitten
Einen verwendbaren Videoclip erhalten
03
Parameter festlegen und Ausgabe prüfen
Wählen Sie eine Dauer von 4 bis 30 Sekunden und eine Auflösung von 480p oder 720p, geben Sie bei Bedarf ein Endbild an oder deaktivieren Sie das Audio, und prüfen Sie nach der Generierung, ob Komposition, Dauer und Tonspur den Erwartungen entsprechen.
03
Szenarien
Anwendungsbereiche: drei typische Kurzfilme
Dynamisierung von Werbe-Intros
Mit dem Produkt-Key-Visual als Startbild und einem Prompt, der Kamerafahrt und Lichtveränderungen beschreibt, wird ein 4- bis 30-sekündiges Video für Werbe-Intros oder Social-Media-Auslieferung generiert. Prüfen Sie, ob das Erscheinungsbild des Motivs erhalten bleibt und die Kamerabewegung natürlich wirkt.
Ausgehend vom Produkt-Key-Visual des Startbilds schwenkt die Kamera langsam seitwärts und umkreist das Produkt leicht; die Glanzlichter auf der Produktoberfläche fließen mit dem Licht, die Lichtbänder im Hintergrund verändern sich langsam, und das Erscheinungsbild des Motivs bleibt stabil; geeignet als Werbe-Intro.
E-Commerce-Produktszenenvideos
Geben Sie ein Produktbild als Startbild ein und beschreiben Sie Anwendungsszenario und Bewegung; die Ausgabe ist ein Präsentationsvideo mit Audio für Produktdetailseiten und Kurzvideo-Plattformen. Prüfen Sie, ob Produktdetails und Proportionen mit dem Startbild übereinstimmen.
Das Produkt beginnt in der frontalen Anordnung des Startbilds; die Szene geht auf natürliche Weise von der Innenraum-Arbeitsplatte in die Anwendungsumgebung über, im Bild erscheinen leichte Handbewegungen und eine Demonstration des Anwendungseffekts, Produktdetails und Proportionen bleiben konsistent, die Kamera fährt gleichmäßig heran.
Storyboard-Previsualisierung mit niedrig aufgelöster Überprüfung
Mit einem Konzeptbild als Startbild und 480p für die schnelle Generierung eines Kurzfilms, kombiniert mit einem Endbild zur Steuerung des Abschlusses, dient dies internen Reviews von Kamerarhythmus und Komposition. Nach der Bestätigung kann mit 720p neu generiert werden.
Filmische Geschichte einer regnerischen Straßenecke bei Nacht. Eine junge Frau mit transparentem Regenschirm geht mit dem Rücken zur Kamera einen nassen Gehweg entlang, wird dann langsamer, dreht sich um und kauert sich neben einen durchnässten Pappkarton, in dem ein kleiner zitternder Hund kauert. Sie neigt den Schirm, um den Karton zu schützen, ihre Hand streckt sich zögernd aus, der Hund hebt den Kopf. Die Kamera beginnt hinter ihr auf Schulterhöhe, folgt ihren Schritten, schwenkt dann im Bogen und senkt sich zu einer niedrigen Nahaufnahme ihres Gesichts und des Hundes, während Neonreklamen in den Pfützen verschwimmen. Regen läuft an den Rändern der Linse herab, warmes Ladenlicht mischt sich mit kaltem blauem Straßenlicht, Spiegelungen flackern auf dem Asphalt. Natürliches synchronisiertes Audio: Regen auf Stoff und Pflaster, ferner Verkehr, leise Schritte, ein kleines Wimmern, ruhiger Atem.
04
Integration
Integration: seedance-2.5-flash in Ihrem Produkt oder KI-Tool aufrufen
Ein HiAPI-API-Key genügt für die Nutzung; alle Methoden teilen dasselbe Konto und dieselbe Abrechnung.
- API-Key erstellen
- Eine Integrationsmethode wählen
Rechts eine auswählen und kopieren
- KI-Programmierwerkzeuge Empfohlen
Claude Code, Cursor, Codex u. a. per Befehl an MCP anbinden
- Direkte API
Eigenes Produkt, Backend-Dienste, automatisierte Abläufe
- Unentschlossen, welche Methode
Einen Text an die KI kopieren, damit sie die Auswahl trifft und die Schritte nennt
Terminal · Claude Code
claude mcp add --transport http hiapi https://mcp.hiapi.ai/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Nach der Anbindung teilen Sie der KI einfach Ihr Ziel mit und lassen Sie seedance-2.5-flash aufrufen, den Aufgabenfortschritt abfragen und das Ergebnis abrufen. Die Konfigurationsschritte für Cursor, Codex und weitere Tools finden Sie in der Anleitung unten.
Anleitung zur Agent-Integration ansehen →Ihr Produkt über die API anbinden
Reichen Sie mit dem API-Key eine Aufgabe für das aktuelle Modell ein und fragen Sie den Status über die zurückgegebene Aufgaben-ID ab. Die Anforderungsparameter verwenden dieselben Daten wie die API-Beschreibung auf dieser Seite; ersetzen Sie die Eingabeinhalte in den Beispielen durch Ihre tatsächlichen Materialien.
# 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-flash/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true,
"first_frame_url": "…"
}
}'Die KI bei der Wahl der Integrationsmethode helfen lassen
Bitte lesen Sie den HiAPI-Dokumentationsindex https://hiapi.ai/llms.txt. Ich möchte seedance-2.5-flash in meinem Projekt verwenden. Bitte beurteilen Sie zunächst anhand meines Anwendungsfalls, ob Remote MCP, Agent Skills oder die direkte API geeignet ist; stellen Sie bei Bedarf zuerst eine entscheidende Frage und geben Sie dann die einfachsten Integrationsschritte und die erforderlichen Einstellungen an.
Kopieren Sie diesen Text in das von Ihnen verwendete KI-Tool und ergänzen Sie Projektsprache, Eingabematerial und erwartetes Ergebnis. Darauf basierend kann es die Integrationsmethode und die nächsten Schritte erläutern.
Neuigkeiten
Changelog ansehen →- Neues Modell seedance-2.5-flash/reference-to-video ist online
- Neues Modell seedance-2.5-flash/image-to-video ist verfügbar
- Neues Modell seedance-2.5-flash/text-to-video ist verfügbar
Häufige Fragen
Alle Fragen ansehen →-
Wie viele Sekunden kann ein Video aus einem Bild maximal lang sein?
Ein einzelner Clip kann maximal 30 Sekunden lang sein, minimal 4 Sekunden, standardmäßig 5 Sekunden. Das Feld duration bestimmt die Länge direkt und wird auch nach der angefragten Dauer abgerechnet; für längere fertige Videos müssen Sie nur Segmente einzeln generieren und anschließend zusammenfügen.
-
Welche Format- und Größenanforderungen gelten für das Startbild?
Unterstützt werden jpeg, png, webp, bmp, tiff, gif, heic und heif, jeweils maximal 30 MB pro Bild, 300 bis 6000 Pixel pro Seite und ein Seitenverhältnis von 0,4 bis 2,5. Bilder außerhalb dieses Bereichs schlagen direkt fehl; es wird empfohlen, sie vor dem Hochladen zu skalieren und zu konvertieren.
Generierungsaufgabe erstellen
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer 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-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
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
modelstringPflichtAktueller Festwert: seedance-2.5-flash/image-to-video
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für seedance-2.5-flash/image-to-video und Route default — siehe Parametertabelle unten.
promptstringPflichtminLength 1maxLength 5000Beschreibe die gewünschte Bewegung, Kameraführung, Szene und Audiospur; das Video startet mit dem ersten Frame als Ausgangsbild und wird anhand dieses Textes generiert.
durationintegerOptionalStandard: 5min 4max 30Dauer des Ausgabevideos in Sekunden, Bereich 4 bis 30; Standard 5 Sekunden, Abrechnung nach angeforderter Dauer.
resolutionstringOptionalStandard: "480p"Ausgabauflösung, Seedance 2.5 Flash unterstützt 480p und 720p; Standard 480p.
480p720paspect_ratiostringOptionalStandard: "adaptive"Seitenverhältnis der Ausgabe, bei Image-to-Video fest auf adaptiv (adaptive), das Ausgabeverhältnis folgt dem ersten Frame; Standard adaptive.
adaptiveoutput_formatstringOptionalStandard: "mp4"Containerformat des Ausgabevideos, mp4 ist der Standardwert mit besserer Kompatibilität, mov richtet sich an professionelle Postproduktion; Standard mp4.
mp4movgenerate_audiobooleanOptionalStandard: trueOb synchron zum Bild Dialog, Soundeffekte und Hintergrundaudio generiert werden; Standard true.
last_frame_urlstringOptionalOptionale URL eines Endframe-Bildes, Dateibeschränkungen wie beim ersten Frame; bei abweichendem Seitenverhältnis zum ersten Frame wird es mittig zugeschnitten, um zu passen.
first_frame_urlstringPflichtURL des ersten Frames, erforderlich. Unterstützt die Formate jpeg, png, webp, bmp, tiff, gif, heic und heif, Größe max. 30 MB, jede Seite 300 bis 6000 Pixel, Seitenverhältnis 0.4 bis 2.5.
callbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
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.
urlstringPflichtPflicht, 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.
finalstoragestringOptionalStandard: "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.
temppersistentAnfragebeispiele
# 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-flash/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true,
"first_frame_url": "…"
}
}' 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-flash/image-to-video",
input: {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true,
"first_frame_url": "…"
}
}),
});
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-flash/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": True,
"first_frame_url": "…"
}
},
)
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
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelö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.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
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.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-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
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
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"
}
}
} Artikel
Alle Artikel ansehen →-
Benutzerhandbuch
Seedance 2.5 Flash Bild-zu-Video-Integrationsleitfaden: Erstes Frame, letztes Frame und sekundengenaue Abrechnung
Ein Bild in Bewegung bringen: Parameter, Preise und häufige Fehlerursachen
-
Benutzerhandbuch
Seedance 2.5 Flash Text-zu-Video-Integrationsleitfaden: Parameter, sekundengenaue Abrechnung und Engineering-Praxis
Von einer Anfrage bis zum stabilen Go-live: Wie man Parameter setzt und die Kosten berechnet
-
Benutzerhandbuch
Seedance 2.5 Flash – Integrationsleitfaden für referenzgestützte Videogenerierung: Referenzbilder, Referenzaudio und Abrechnungsregeln
Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
P-Video 2 Pro Avatar Pruna AI $0.029 /Sekunde -
Seedance 2.5 ByteDance $0.121 /Sekunde -
Gemini Omni 1.2 Google $0.023 /Sekunde -
Kandinsky 6.0 Pro $1.93 /Video -
HeyGen Avatar V HeyGen $0.150 /Sekunde -
Grok Imagine 1.5 Lite xAI $0.029 /Sekunde -
Creatify Boreal Creatify $0.015 /Sekunde -
FLUX 3 Max Black Forest Labs $0.121 /Sekunde -
PixVerse V6 PixVerse $0.036 /Sekunde -
P-Video 2 Pro Replace Pruna AI $0.036 /Sekunde -
Kling 3.0 Kuaishou $0.100 /Sekunde -
FLUX 3 Video Black Forest Labs $0.090 /Sekunde



