Seedance 2.5 Text-zu-Video: Kurzclips mit der hiapi API erstellen

Kurzvideos sind ein Spiel der Menge: TikTok, Reels und Shorts belohnen Veröffentlichungsfrequenz, und B-Roll-Material für jeden Beitrag manuell zu drehen, lässt sich nicht skalieren. Der Text-zu-Video-Endpunkt von Seedance 2.5 verwandelt einen einzelnen Prompt mit nur einem API-Aufruf in einen fertigen vertikalen Clip mit synchronisiertem Audio – keine Kamera, keine Schnitt-Timeline, keine separate Sprachaufnahme.

Dieser Leitfaden führt vollständig durch einen echten Clip, den wir über die hiapi API von Anfang bis Ende erzeugt haben: den exakten Prompt, den asynchronen Workflow, der ihn erzeugt hat, verifizierte Preise und ein Muster, das sich direkt für die Massenproduktion eignet, um eine Reihe von Kurzvideos statt vereinzelter Einzelclips zu erstellen. Eine vollständige Parameterreferenz für alle drei seedance-2.5-Endpunkte findest du im vollständigen API-Leitfaden.

Warum sich Kurzvideoinhalte für Text-zu-Video eignen

Kurzvideo-Plattformen brauchen keine filmreife Länge – sie brauchen einen stetigen Nachschub an 6- bis 15-Sekunden-Clips, die nahtlos in Schleife laufen und das Publikum innerhalb einer Sekunde fesseln. seedance-2.5/text-to-video passt genau zu diesem Bedarf:

• Bis zu 30 Sekunden pro Clip, mit sieben Seitenverhältnissen, darunter 9:16 für TikTok/Reels/Shorts.
• Native Audiosynchronisation – das Modell erzeugt Umgebungsgeräusche und Audiohinweise passend zu den Aktionen im Prompt, statt einen stummen Clip zu liefern, den du nachträglich vertonen musst.
• Prompts in 11 Sprachen, was nützlich ist, wenn du Kurzvideo-Kampagnen lokalisierst.
• Zwei Auflösungsstufen (480p und 720p), sodass du Entwürfe günstig erzeugen und nur für die Clips, die tatsächlich veröffentlicht werden, den 720p-Tarif zahlen kannst.

Ein echter Clip, von Anfang bis Ende

Dies ist ein Clip, den wir für diesen Leitfaden erzeugt haben: eine Nahaufnahme eines Latte-Art-Eingusses, vertikal gefilmt, für ein Café-Kurzvideo.

Der exakte Prompt, den wir übermittelt haben, unverändert:

Die ruhige Hand des Baristas gießt aufgeschäumte Milch aus einem Milchkännchen aus Edelstahl in eine weiße Espressotasse aus Keramik, der Milchstrahl faltet sich zu einem Rosetta-Latte-Art-Wirbel, der in Echtzeit entsteht, warmes Golden-Hour-Licht fällt schräg über die Theke, im Hintergrund weich unscharfe Croissants und Gebäck, Nahaufnahme im vertikalen Bildformat, sanfter Dampf, Café-Ambiente.

Parameter: aspect_ratio: "9:16", resolution: "720p", duration: 8. Die obige Ausgabe ist das echte, unbearbeitete Ergebnis des Tasks – 8,06 Sekunden, wobei das Eingussgeräusch und das Café-Ambiente-Brummen direkt vom Modell erzeugt wurden, nicht nachträglich hinzugefügt.

Der API-Workflow

seedance-2.5/text-to-video läuft über die asynchrone Task-API von hiapi – übermitteln, abfragen, herunterladen. Es gibt keinen synchronen Videoendpunkt; jeder Clip ist ein Hintergrund-Task.

import time
import requests

API_KEY = "YOUR_HIAPI_KEY"
BASE = "https://api.hiapi.ai/v1"

def generate_clip(prompt: str, aspect_ratio: str = "9:16",
                   resolution: str = "720p", duration: int = 8) -> str:
    submit = requests.post(
        f"{BASE}/tasks",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "seedance-2.5/text-to-video",
            "input": {
                "prompt": prompt,
                "aspect_ratio": aspect_ratio,
                "resolution": resolution,
                "duration": duration,
            },
        },
        timeout=30,
    )
    task_id = submit.json()["data"]["taskId"]

    while True:
        poll = requests.get(
            f"{BASE}/tasks/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
            timeout=30,
        ).json()["data"]
        if poll["status"] == "success":
            return poll["output"][0]["url"]   # temporärer Link – sofort herunterladen
        if poll["status"] == "fail":
            raise RuntimeError(poll)
        time.sleep(5)

clip_url = generate_clip(
    "Die ruhige Hand des Baristas gießt aufgeschäumte Milch aus einem Milchkännchen aus Edelstahl "
    "in eine weiße Espressotasse aus Keramik, der Milchstrahl faltet sich zu einem Rosetta-Latte-Art-"
    "Wirbel, der in Echtzeit entsteht, warmes Golden-Hour-Licht "
    "fällt schräg über die Theke, im Hintergrund weich unscharfe Croissants und Gebäck, "
    "Nahaufnahme im vertikalen Bildformat, sanfter Dampf, Café-Ambiente."
)

# Die Ausgabe-URL läuft ab (mit expireAt-Zeitstempel) – bitte sofort herunterladen und
# in deinem eigenen Speicher dauerhaft ablegen, nicht als Hotlink behalten
video_bytes = requests.get(clip_url, timeout=60).content
open("clip.mp4", "wb").write(video_bytes)

Die Task-Antwort gibt niemals deinen ursprünglichen Prompt zurück – nur model, status, output und Zeitstempel – wenn du einen Clip später also reproduzieren oder variieren musst, dokumentiere selbst, was du übermittelt hast.

Preise: zwei Stufen, kein 1080p

Live verifiziert über den Preis-Endpunkt von hiapi – seedance-2.5/text-to-video wird pro Ausgabesekunde abgerechnet, mit zwei Auflösungsstufen und ohne 1080p-Option:

Auflösung	Preis pro Sekunde	8-Sekunden-Clip
480p	$0.1395	ca. $1.12
720p	$0.3019	ca. $2.42

Der 720p-Preis pro Sekunde ist etwa 2,2-mal so hoch wie bei 480p – es lohnt sich, Entwürfe zuerst mit 480p zu erzeugen und erst für 720p zu zahlen, wenn der Prompt ausgereift ist. Vollständige Parameter- und Preisdetails stehen auf der Modellseite von seedance-2.5/text-to-video; die Tarife gelten Stand 2026-08 und können sich ändern, prüfe daher diese Seite, bevor du ein Budget für große Mengen planst.

Eine Reihe von Kurzvideos produzieren, nicht nur einen Clip

Ein einzelner Clip ist nur eine Demo; ein Redaktionskalender braucht Massenproduktion. Behandle jeden Clip als idempotenten Task mit dem Prompt als Schlüssel, damit ein Neustart nach einem Absturz nicht doppelt abgerechnet wird:

import hashlib

PROMPTS = [
    "Barista gießt aufgeschäumte Milch in eine Espressotasse, Rosetta-Latte-Art entsteht, Golden-Hour-Licht, Nahaufnahme im vertikalen Bildformat.",
    "Dampf steigt von frisch aufgebrühtem Filterkaffee auf, während er durch das Filterpapier tropft, Morgenlicht durch Café-Fenster, vertikales Bildformat.",
    "Eine Hand klopft einen Beutel Kaffeebohnen leicht auf eine Holzwaage, die Bohnen kommen zur Ruhe, sanfte Café-Atmosphäre, Nahaufnahme im vertikalen Bildformat.",
]

def job_key(prompt: str) -> str:
    return hashlib.sha1(prompt.encode()).hexdigest()[:12]

results = {}
for prompt in PROMPTS:
    key = job_key(prompt)
    if key in results:          # in diesem Durchlauf bereits erzeugt
        continue
    results[key] = generate_clip(prompt, resolution="480p", duration=6)
    # jedes Ergebnis sofort dauerhaft speichern – siehe Download-Schritt oben

Erzeuge zuerst die ganze Reihe mit 480p, bewerte, welche Clips wirklich zur Kampagne passen, und lasse dann nur die Gewinner erneut mit 720p laufen. Diese Zwei-Runden-Gewohnheit ist der größte Kostelhebel, wenn du Massenproduktion statt Einzelanfertigung brauchst.

Vergleich mit Seedance 2.0

Wenn du Seedance 2.0 verwendet hast, behält die Text-zu-Video-Ebene von 2.5 dieselbe Task-Form aus Übermitteln-Abfragen-Herunterladen – auf der Integrationsseite ändert sich nichts. Praktische Unterschiede, die du vor der Migration deiner Pipeline kennen solltest: 2.5 fügt jedem Clip standardmäßig native Audiosynchronisation hinzu, und seine Auflösungsstaffel ist einfacher (nur 480p/720p, während 2.0 zusätzliche Stufen hat). Wenn dein Workflow auf eine Auflösung angewiesen ist, die 2.5 nicht bietet, prüfe vor der Annahme von Gleichwertigkeit die aktuelle Spezifikation auf der Seite des jeweiligen Modells.

Häufige Fragen

Unterstützt seedance-2.5/text-to-video 1080p? Nein – Stand 2026-08 bietet das Modell nur 480p und 720p. Wenn du 1080p-Ausgabe benötigst, durchsuche den Modellkatalog nach einem Modell, das dies unterstützt, bevor du eine Pipeline um diesen Endpunkt herum aufbaust.

Ist das Audio echt, oder muss es separat hinzugefügt werden? Es wird vom Modell als Teil des Tasks erzeugt – das Eingussgeräusch und das Café-Ambiente-Brummen im oben gezeigten Demo-Clip wurden nicht nachträglich hinzugefügt. Wenn du markenspezifische Musik oder Sprachaufnahmen brauchst, kannst du dein eigenes Audio später dennoch darüberlegen.

Wie lange dauert die Erzeugung eines Clips? Die Fertigstellungszeit eines Tasks variiert je nach Dauer und Auflösung; grob eine bis mehrere Minuten pro Clip, und frage auf jeden Fall per Polling ab, statt eine feste Wartezeit anzunehmen.

Kann ich denselben Prompt plattformübergreifend mit unterschiedlichen Seitenverhältnissen wiederverwenden? Ja – aspect_ratio ist ein vom Prompt getrennter Parameter, sodass derselbe Prompt in 9:16 für TikTok/Reels und in 16:9 für YouTube erneut übermittelt werden kann, ohne die Szenenbeschreibung umzuschreiben.

Was, wenn die Ausgabe-URL abläuft, bevor ich sie heruntergeladen habe? Dann musst du den Task erneut übermitteln – output[0].url ist ein temporärer Link, der an einen expireAt-Zeitstempel gebunden ist, kein dauerhafter Speicher. Lade jeden Clip sofort herunter und speichere ihn dauerhaft, sobald der Task success meldet.

Die wichtigsten Punkte

• seedance-2.5/text-to-video ist ein Endpunkt mit Prompt als Eingabe und Clip als Ausgabe für Kurzvideoinhalte – wähle 480p für Entwürfe und Füllinhalte für Social Media, und 720p, wenn der Clip das endgültige Asset ist.
• Kalkuliere nach Dauer, nicht nach Clip: 720p kostet pro Sekunde etwa 2,2-mal so viel wie 480p, ein 8-Sekunden-Clip in 720p kostet also bereits etwa $2.42.
• Ausgabe-URLs von Tasks laufen ab – lade sofort nach erfolgreichem Polling herunter und speichere dauerhaft.
• Native Audiosynchronisation bedeutet, dass Kurzvideo-Füllinhalte in der Regel keine separate Sprachaufnahme oder Soundeffekt-Bearbeitung benötigen.
• Das Modell hat derzeit keine 1080p-Stufe – prüfe die Modellseite, bevor du eine Pipeline baust, die diese Stufe voraussetzt.

Bereit zum Ausprobieren? Besuche die Modellseite von seedance-2.5/text-to-video für die vollständige Parameterreferenz oder durchstöbere den vollständigen Videomodell-Katalog von hiapi, um ihn mit Bild-zu-Video-Optionen wie Kling 3.0 Turbo zu vergleichen und dich auf deine nächste Runde Kurzvideos vorzubereiten.