Wie verwende ich die Seedance 2.5 Text-zu-Video-API? Direkt mit curl und Python ausführen

TL;DR

• seedance-2.5/text-to-video erzeugt mit nur einem Prompt ein Video, pro Clip 4–30 Sekunden, mit eigenem Ton. Modellseite öffnen und direkt online generieren – neue Nutzer erhalten bei der Registrierung 200 Credits.
• Abrechnung pro Sekunde: 720p kostet $0.204 pro Sekunde, 1080p $0.516 pro Sekunde. 5 Sekunden in 720p kosten $1.02.
• API in zwei Schritten: mit POST /v1/tasks absenden, mit der taskId das Ergebnis abfragen. Das folgende curl- und Python-Beispiel läuft direkt per Copy-and-paste.

Zuerst ein echtes Ergebnis ansehen

Das folgende 8-Sekunden-Video in 720p wurde mit einem einzigen Prompt und einer einzigen Anfrage erzeugt – das Aufschäumen der Milch, das Klirren der Tassen und die Stimmen im Café hat das Modell selbst erzeugt:

A barista in a small morning cafe pours steamed milk into a cup, drawing a latte art leaf.
The camera starts on her hands and slowly pulls back to reveal the counter and a sign on the wall that reads 'OPEN'.
Warm window light, realistic, smooth motion. Sound: milk steaming, cups clinking, quiet cafe chatter.

Mit diesem Prompt generieren → (8 Sekunden, 720p)

seedance-2.5/text-to-video, 720p, 8 Sekunden, mit Ton, $1.632.

Zwei Wege zum Einstieg

Online testen (ohne Code)

1. Öffne die Modellseite Seedance 2.5 Text-zu-Video und registriere dich oder melde dich an.
2. Prompt einfügen, Dauer, Auflösung und Seitenverhältnis wählen.
3. Auf Generieren klicken und das fertige Video direkt herunterladen.

API-Aufruf

1. Im Dashboard einen API Key erstellen.
2. Mit POST https://api.hiapi.ai/v1/tasks eine Aufgabe absenden; die Antwort enthält die taskId.
3. Mit GET /v1/tasks/{taskId} den Status abfragen; wenn status gleich success ist, das Video von output[0].url herunterladen.

curl: das erste Video

Zunächst ein 5-Sekunden-Video in 720p, $1.02:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5/text-to-video",
    "input": {
      "prompt": "一架纸飞机滑过洒满阳光的办公室，灰尘在光里漂浮，镜头跟着纸飞机缓慢移动",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    }
  }'

Antwort:

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

Ergebnis abfragen:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Während der Generierung ist status gleich handling, nach Abschluss wird daraus success, und die Videoadresse steht in output[0].url.

Python: absenden, abfragen, herunterladen

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(prompt, model="seedance-2.5/text-to-video", timeout_s=900, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

url = generate(
    "一架纸飞机滑过洒满阳光的办公室，灰尘在光里漂浮，镜头跟着纸飞机缓慢移动",
    duration=5, resolution="720p", aspect_ratio="16:9",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Parameterübersicht

Parameter	Wert	Beschreibung
prompt	Zeichenkette, erforderlich	Chinesisch oder Englisch möglich
duration	Ganzzahl von 4–30, Standard 5	Einheit Sekunden, Abrechnung pro Sekunde
resolution	720p / 1080p, Standard 720p	Der Stückpreis für 1080p ist etwa 2,5-mal so hoch wie für 720p
aspect_ratio	16:9 4:3 1:1 3:4 9:16 21:9 adaptive, Standard adaptive	Für vertikale Kurzvideos 9:16 verwenden
generate_audio	Standard true	Ton und Bild werden gemeinsam erzeugt
output_format	mp4 / mov

Bei Text-zu-Video werden keine Bild- oder Videoadressen angenommen. Um mit einem Bild zu beginnen, wechsle zu Seedance 2.5 Bild-zu-Video; um Bewegung und Kameraführung eines vorhandenen Videos als Referenz zu nutzen, wechsle zu Seedance 2.5 Referenz-zu-Video.

Die Kosten berechnen

Dauer	720p ($0.204/Sekunde)	1080p ($0.516/Sekunde)
5 Sekunden	$1.02	$2.58
10 Sekunden	$2.04	$5.16
15 Sekunden	$3.06	$7.74
30 Sekunden	$6.12	$15.48

Mit $10 lassen sich in 720p etwa 49 Sekunden generieren. Es empfiehlt sich, den Prompt zuerst mit kurzen 720p-Clips zu optimieren und erst dann das fertige Video in 1080p zu erzeugen. Eine detailliertere Kostenübersicht findest du unter Seedance 2.5 API-Preise.

Hinweise vor dem Livegang

• Callbacks statt Polling verwenden: Auf oberster Ebene der Anfrage (auf derselben Ebene wie input) "callback": {"url": "https://deine-domain/hiapi/callback"} hinzufügen; bei Abschluss der Aufgabe benachrichtigt HiAPI aktiv, Deduplizierung anhand der taskId.
• Rechtzeitig speichern: Bei output[0].url handelt es sich um einen temporären Link (standardmäßig etwa 7 Tage gültig); sofort nach Erhalt im eigenen Speicher ablegen.
• Bei Wiederholungen Idempotenzschlüssel mitgeben: Im Request-Header Idempotency-Key hinzufügen; eine Wiederholung mit demselben Schlüssel erstellt die Aufgabe nur einmal und berechnet keine doppelten Kosten.
• Parameter vollständig angeben: duration, resolution und aspect_ratio explizit angeben, damit Kosten und Bildformat zum Budget passen.
• Automatische Rückerstattung bei Fehlschlag: Es wird nur für erfolgreich generierte Videos abgerechnet.

Häufige Fragen

Kann der Prompt auf Chinesisch geschrieben werden?

Ja. Am zuverlässigsten funktioniert es, Kamerabewegung, Bewegung des Motivs und gewünschte Geräusche in getrennten Sätzen zu beschreiben.

Wie lang kann maximal generiert werden?

Pro Clip 4–30 Sekunden. Das ist doppelt so lang wie das Limit von 15 Sekunden bei Seedance 2.0 und eignet sich für lange Einstellungen ohne Schnitt.

Lässt sich durch Verzicht auf Ton Geld sparen?

Mit generate_audio auf false lässt sich der Ton abschalten, der Preis richtet sich jedoch nach Auflösung und Sekundenzahl und wird dadurch nicht günstiger.

Wie wähle ich zwischen Seedance 2.0 und 2.5?

Für längere Einzelclips und mehr Referenzmaterial wähle 2.5; bei knappem Budget oder für 4K wähle die ext-Route von 2.0 (720p $0.134 pro Sekunde). Einen ausführlichen Vergleich findest du unter Unterschiede zwischen Seedance 2.5 und 2.0.

Für mehr fertige Formulierungen siehe das Seedance 2.5 Handbuch; du kannst auch den obigen Latte-Art-Prompt kopieren und auf der Modellseite generieren.