HiAPI
Blog

Benutzerhandbuch

Seedance 2.0@ext Kurzvideos: Ein praktischer API-Workflow für Social-Short-Form-Videos

Mit der asynchronen Task-API von seedance-2.0@ext wird aus einem ausführlichen Prompt ein fertiges Hochformat-Video mit Audio

Aug 10, 2026
Seedance 2.0@ext Kurzvideos: Ein praktischer API-Workflow für Social-Short-Form-Videos

Die meisten Social-Content-Entdeckungen finden heute über Kurzvideos statt, und ein sauberer vertikaler Clip bedeutet normalerweise: filmen, schneiden – oder beides. seedance-2.0@ext auf hiapi überspringt diese Schritte: einen ausführlichen Prompt schreiben, einen API-Endpunkt aufrufen, und wenige Minuten später ein fertiges 9:16-Video zurückbekommen – inklusive Audio.

Dieser Praxisleitfaden erklärt anhand eines real generierten Kurzclips den gesamten Workflow von Anfang bis Ende: wie der Prompt aufgebaut ist, wie der tatsächliche Aufruf der asynchronen Task-API funktioniert, was es gekostet hat und wo die Preisgestaltung nicht mehr Ihren Erwartungen entspricht.

Warum seedance-2.0@ext für Kurzvideos

seedance-2.0@ext ist die ext-Route der seedance-2.0-Modellfamilie auf hiapi – eine eigenständige Route mit eigener Preisgestaltung und eigenem Parametersatz, anders als die Standard-Route von seedance-2.0. Sie ist auf vertikale, social-native Ausgaben ausgelegt: native 9:16-Komposition, Kamerabewegungen, die auf dem Handydisplay gut aussehen, und Audio, das in derselben Generierung wie das Video entsteht, statt nachträglich hinzugefügt zu werden.

Diese Kombination – vertikale Komposition plus natives Audio – macht sie für Kurzvideos im TikTok- und Reels-Stil geeignet, anstatt ein generisches Videomodell zu verwenden und danach selbst zuzuschneiden und zu vertonen.

Der Prompt: Was der Clip tatsächlich verwendet

Für diesen Artikel haben wir einen Demo-Clip von Anfang bis Ende generiert: eine vertikale Produktaufnahme eines Cold-Brew-Kaffees, der in ein mit Eiswürfeln gefülltes Glas gegossen wird, im Stil für den Social-Feed. Hier ist die tatsächliche Ausgabe und der ursprüngliche Prompt, der sie erzeugt hat.

Vertikale 9:16-Produktaufnahme für den Social-Feed: ein Glas mit mattem Finish steht mittig auf einer sonnenbeschienenen Marmorfläche. Die Kamera fährt langsam von oben auf das leere Glas zu und neigt sich dabei herab; das Glas füllt sich mit durchsichtigen Eiswürfeln, die das Licht der goldenen Stunde reflektieren. In der zweiten Sekunde wird von oben außerhalb des Bildes ein Strahl Cold Brew hineingegossen, der wirbelt und die Eiswürfel dunkler macht, anschließend zieht Milch in sanften Spiralen ein. Wassertropfen laufen am Glas herunter, Kältedunst steigt im Gegenlicht auf. Die Kamera bewegt sich langsam in einem Bogen von der Draufsicht zu einer niedrigen Dreiviertel-Perspektive und endet in einer klaren Nahaufnahme mit geringer Schärfentiefe, während durch ein Fenster im Hintergrund warmes Bokeh scheint. Helle natürliche kommerzielle Beleuchtung, glänzende Reflexionen, geringe Schärfentiefe, ultra-saubere Produktvideo-Ästhetik, sanfte handgeführte Mikrobewegungen, hochwertige kommerzielle Anmutung. Natives Audio: leises Plätschern beim Eingießen, Klirren von Eiswürfeln am Glas, leises Café-Ambiente im Hintergrund, keine Musik. Kein lesbarer Text, keine Logos, keine Personen, keine Hände, keine Schnitte.

Ergebnis: 720×1280 (9:16), 24 fps, etwa 8 Sekunden, mit nativem AAC-Stereo-Audio in der Datei – kein separater Foley-Prozess nötig.

Warum dieser Prompt funktioniert

Dieser Prompt leistet mehrere Dinge, die kürzere, vage Prompts nicht tun:

  • Er gibt der Kamera einen Weg statt eines einzelnen Bildes. „Von oben heranfahren“ → „langsam im Bogen zu einer niedrigen Dreiviertel-Perspektive“ → „klare Nahaufnahme“ beschreibt eine Bewegung über den gesamten Clip hinweg statt einer statischen Komposition.
  • Er legt die Aktion zeitlich fest. „In der zweiten Sekunde wird ein Strahl Cold Brew eingegossen“ verankert das Eingießen an einem konkreten Moment, statt das Modell raten zu lassen, wann „der interessante Teil“ passieren soll.
  • Er legt Material- und Lichtsignale übereinander. Wassertropfen, Kältedunst, warmes Bokeh, glänzende Reflexionen – diese Details heben eine Produktaufnahme von gewöhnlich auf hochwertig.
  • Audio wird direkt in den Prompt geschrieben, nicht als nachträgliche Ergänzung behandelt: Plätschern beim Eingießen, Klirren von Eiswürfeln, leises Ambiente – und ausdrücklich keine Musik. Das Modell synchronisiert den Ton mit den oben beschriebenen visuellen Aktionen.
  • Er endet mit einer Negativliste. „Kein lesbarer Text, keine Logos, keine Personen, keine Hände, keine Schnitte“ blockiert bei Produktgenerierungen frühzeitig die häufigsten Fehlermuster.

Behandeln Sie den Prompt wie ein kurzes Creative Briefing, nicht wie eine Bildunterschrift – genau darin liegt der eigentliche Unterschied in der Ausgabequalität.

Mit der /v1/tasks-API reproduzieren

seedance-2.0@ext läuft über den asynchronen Task-Endpunkt von hiapi. Sie übermitteln einen Task, fragen ab, bis er abgeschlossen ist, und entnehmen dann das Video aus der Antwort.

Übermitteln:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0@ext",
    "input": {
      "prompt": "<your prompt>",
      "aspect_ratio": "9:16",
      "resolution": "720p",
      "duration": 8,
      "generate_audio": true
    }
  }'

prompt und aspect_ratio sind Pflichtfelder – wenn aspect_ratio fehlt, schlägt der Aufruf bereits bei der Validierung fehl, bevor er die Generierung erreicht. resolution, duration (4–15 Sekunden) und generate_audio sind optional; die obigen Werte entsprechen in etwa der Konfiguration, mit der der Clip in diesem Artikel generiert wurde.

Falls Sie von der Idee der Bild-zu-Video-Generierung kommen, lohnt sich ein Hinweis: Die Preisseite listet für dieses Modell Tarife für Bild-zu-Video auf, aber das tatsächliche Eingabeschema akzeptiert nur Text-Prompts – Bild- oder Referenzframe-Felder werden abgelehnt. Unabhängig davon, wie das Preislabel lautet, handelt es sich faktisch um ein Text-zu-Video-Modell.

Ergebnis abfragen:

curl https://api.hiapi.ai/v1/tasks/<task_id> \
  -H "Authorization: Bearer $HIAPI_API_KEY"

Sobald status Erfolg meldet, verweist output[0].url auf die fertige .mp4. Der Link ist temporär – gemäß dem Ablaufzeitfenster in der Task-Antwort etwa eine Woche –, laden Sie die Bytes daher sofort herunter und speichern Sie sie selbst, statt direkt darauf zu verlinken.

Preisgestaltung: Die 4K-Anomalie

seedance-2.0@ext wird nach Ausgabesekunden abgerechnet, wobei der Tarif je nach Auflösungsstufe variiert:

Auflösung Preis pro Sekunde
720p $0.149
1080p $0.373
2K $0.662
4K $0.467

Beachten Sie, dass bei diesem Modell 4K günstiger ist als 2K – $0.467/Sekunde gegenüber $0.662/Sekunde. Das ist kein Tippfehler und auch kein übliches Muster; die meisten Modelle hier steigen im Preis monoton mit der Auflösung. Gehen Sie nicht davon aus, dass andere Modelle sich ebenso verhalten, und prüfen Sie /api/pricing erneut, bevor Sie auflösungsbasierte Kostenlogik in Ihre Pipeline schreiben, denn solche Stufen werden tatsächlich angepasst.

Zur Orientierung: Die Generierung des 8-sekündigen 720p-Demo-Clips oben hat $1.19 gekostet – eine einfache Berechnung von Dauer × Preis pro Sekunde in der 720p-Stufe.

Die Auflösung danach wählen, wo der Clip tatsächlich ausgespielt wird

Allein der Sprung von 720p auf 1080p erhöht die Kosten um etwa das 2,5-Fache, daher ist die Auflösung der Hebel, den es vor der Massenproduktion zuerst zu bedenken gilt:

  • Feed- und Stories-Ausspielung (TikTok, Reels, Shorts) wird fast immer auf dem Handy angesehen, mit einer Pixeldichte, die nur einen Bruchteil der tatsächlichen Dichte von 1080p beträgt – 720p ist dort meist nicht unterscheidbar und die günstigste Stufe.
  • 1080p lohnt sich, wenn der Clip möglicherweise als Hero-Visual auf einer Landingpage wiederverwendet wird oder in bezahlten Kampagnen in einer Größe gerendert wird, die größer als ein Handydisplay ist.
  • 2K und 4K eignen sich für Quellmaterial, das Sie in der Postproduktion zuschneiden, skalieren oder stabilisieren wollen – die zusätzliche Auflösung gibt Ihnen Spielraum für Neukompositionen ohne sichtbaren Qualitätsverlust. Angesichts der obigen Preistabelle ist 4K bei diesem speziellen Modell die wirtschaftlichere der beiden Optionen.

Häufig gestellte Fragen

Unterstützt seedance-2.0@ext Bild-zu-Video und nicht nur Text-zu-Video? Nein – obwohl die Preisseite für dieses Modell Tarife für Bild-zu-Video listet, akzeptiert das tatsächliche /v1/tasks-Schema der ext-Route nur Text-Prompts; Bild-URLs, Referenzframes und Referenzvideo-Felder werden abgelehnt. Betrachten Sie es als reines Text-zu-Video, bis die Modellliste der Plattform etwas anderes angibt.

Kann ich die Dauer des generierten Clips steuern? Ja, über das optionale Feld duration mit einer ganzen Zahl von 4 bis 15 Sekunden. Wenn es weggelassen wird, wendet das Modell einen Standardwert an; wenn eine nachgelagerte Vorlage eine bestimmte Länge erwartet, ist eine explizite Angabe sicherer.

Enthält das Video automatisch Audio? Die native Audiogenerierung wird über das optionale Feld generate_audio bereitgestellt. Schreiben Sie das gewünschte Audio direkt in den Prompt – wie oben „leises Plätschern beim Eingießen, Klirren von Eiswürfeln am Glas, leises Café-Ambiente im Hintergrund“ – so wird es mit den Bildaktionen synchronisiert, ohne separaten Audio-Workflow.

Ist 4K wirklich günstiger als 2K, oder ist das ein Anzeigefehler? Das ist der aktuelle tatsächliche Preis zum Zeitpunkt dieses Artikels (August 2026), kein Bug – aber die Auflösungspreisgestaltung kann sich ändern, prüfen Sie sie daher anhand von /api/pricing, bevor Sie sich in Ihrem Kostenmodell darauf verlassen.

Wie lange ist die zurückgegebene Video-URL gültig? Das output[0].url eines abgeschlossenen Tasks ist ein temporärer Link, der gemäß den Ablaufmetadaten des Tasks etwa eine Woche gültig ist. Laden Sie die Datei selbst herunter und speichern Sie sie, statt langfristig darauf zu verlinken.

Wie es weitergeht

Vollständige Parameterdetails und aktuelle Preise zu diesem Modell finden Sie auf der Modellseite von seedance-2.0@ext und der hiapi-Preisseite. Wenn Sie weitere Prompt-Muster rund um dasselbe Modell suchen, bietet Seedance 2.0@ext Prompt-Rezepte mehr Beispiele, während kurze Produktvorführungen auf Basis von Seedance 2.0 erklärt, wie derselbe asynchrone Task-Workflow auf andere Creative-Briefings angewendet wird.

Ähnliche Artikel

Alle Artikel ansehen →

Starte mit persistenten KI-Artefakten

Hol dir deinen API-Key und rufe Bild-, Video- und Audiomodelle über eine einzige task-basierte API auf.

API-Dokumentation lesen