Seedance 2.0 Mini API Tutorial auf Deutsch: Die Video-API für $0,0272 pro Sekunde

TL;DR

• seedance-2.0-mini ist die Leichtgewicht-Version von ByteDances Seedance 2.0. Ein einziger Modellname reicht für Text-zu-Video, Bild-zu-Video (erstes Bild oder erstes und letztes Bild) und Referenz-zu-Video, mit synchronem Ton ab Werk. Modellseite öffnen und direkt online generieren – neue Nutzer erhalten bei der Registrierung 200 Credits geschenkt.
• Es ist eines der günstigsten Videomodelle auf HiAPI: 480p für $0,0272 pro Sekunde, 720p für $0,0586 pro Sekunde. 5 Sekunden in 480p kosten nur $0,136.
• resolution ist ein Pflichtfeld – fehlt es, gibt es direkt einen Fehler. Unten folgen curl- und Python-Beispiele, alle Parameter und die Kostenberechnung für die drei Modi.

Zuerst die Ergebnisse

Drei Text-zu-Video-Clips, jeweils 5 Sekunden in 480p, je $0,136.

A slow dolly-in toward a steaming bowl of ramen on a worn wooden counter in a dim izakaya. Warm amber lantern light, soft volumetric haze, gentle steam curling upward, shallow depth of field, the broth surface rippling slightly. Cinematic, photoreal.

Mit diesem Prompt generieren → (5 Sekunden, 480p)

seedance-2.0-mini, Text-zu-Video, 480p, 5 Sekunden, $0,136.

A cozy fireplace crackling in a log cabin at night, orange embers popping and drifting, a cast-iron kettle gently steaming on the hearth, rain streaking the dark window behind. Static locked-off shot. Native audio: crackling fire, soft rain on glass, a low wind.

Mit diesem Prompt generieren → (5 Sekunden, 480p)

seedance-2.0-mini, Text-zu-Video, 480p, 5 Sekunden, mit nativem Ton, $0,136.

Das Knistern des Feuers, der Regen und der Wind in diesem Clip stammen aus dem letzten Satz des Prompts. Mini erzeugt standardmäßig Ton, aber welche Geräusche genau entstehen, muss im Prompt klar beschrieben werden.

A border collie sprints across a sunlit beach toward the camera, kicking up wet sand, ears flapping, tongue out, water spray catching the low golden light. Tracking shot moving backward to keep the dog centered, motion blur on the paws, joyful energy, photoreal.

Mit diesem Prompt generieren → (5 Sekunden, 480p)

seedance-2.0-mini, Text-zu-Video, 480p, 5 Sekunden, $0,136.

curl: Das erste Video

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-mini",
    "input": {
      "prompt": "雨夜霓虹赛博朋克街道，镜头缓缓推近，湿漉路面倒影斑斓，电影级氛围",
      "resolution": "480p",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5 Sekunden in 480p, $0,136. Nach der Rückgabe von data.taskId mit GET /v1/tasks/{taskId} prüfen, ob status auf success steht, und dann output[0].url herunterladen.

Python: Senden, Abfragen, Herunterladen

# pip install requests; vorher export HIAPI_KEY=dein Key
import os, time, uuid, requests

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

def generate(timeout_s=900, **params):
    body = {"model": "seedance-2.0-mini", "input": params}
    # Beim erneuten Senden derselben Aufgabe denselben Idempotency-Key mitschicken, um doppelte Abbuchungen zu vermeiden
    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)

# Bild-zu-Video: ein Bild in Bewegung bringen, 720p 5 Sekunden ($0,293)
url = generate(
    prompt="镜头缓缓拉远，云雾在山峰间流动，金色晨光",
    first_frame_url="https://your-cdn.example.com/first-frame.jpg",
    resolution="720p", duration=5, generate_audio=False,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Ein Modell, drei Modi

Welche Parameter übergeben werden, bestimmt den Modus:

Modus	Was übergeben wird	Beschreibung
Text-zu-Video	nur prompt
Bild-zu-Video	first_frame_url, optional zusätzlich last_frame_url	Nicht mit Referenzbildern oder Referenzvideos kombinierbar
Referenz-zu-Video	reference_image_urls, reference_video_urls, reference_audio_urls	Referenzvideos und Referenzaudios je maximal 3, jeweils insgesamt höchstens 15 Sekunden

Parameterübersicht

Parameter	Werte	Beschreibung
prompt	String, Pflichtfeld	Chinesisch oder Englisch möglich
resolution	480p / 720p, Pflichtfeld	Fehlt es, wird 400 zurückgegeben
duration	Ganzzahl von 4–15, Pflichtfeld (Beispiele verwenden 5)	Einheit Sekunden
aspect_ratio	1:1 4:3 3:4 16:9 9:16 21:9 adaptive, Standard 16:9
generate_audio	Standard true	Nativer synchroner Ton
first_frame_url / last_frame_url	Bild-URL	jpeg/png/webp/bmp/tiff/gif, Kantenlänge 300–6000 px, pro Bild unter 30 MB
reference_image_urls	Bild-URL	Zusammen mit erstem und letztem Bild maximal 9 Bilder
reference_video_urls	maximal 3 Clips	mp4/mov, 480p oder 720p, pro Clip 2–15 Sekunden, insgesamt höchstens 15 Sekunden
reference_audio_urls	maximal 3 Clips	wav/mp3, pro Clip 2–15 Sekunden, insgesamt höchstens 15 Sekunden

Kosten berechnen

Dauer	480p ($0,0272/Sekunde)	720p ($0,0586/Sekunde)
4 Sekunden	$0,1088	$0,2344
5 Sekunden	$0,136	$0,293
10 Sekunden	$0,272	$0,586
15 Sekunden	$0,408	$0,879

Bei Übergabe von reference_video_urls gilt ein anderer Stückpreis: 480p $0,0172 pro Sekunde, 720p $0,0358 pro Sekunde. Für $10 lassen sich in 480p etwa 367 Sekunden generieren. Empfehlung: Prompts zuerst in 480p abstimmen und erst nach der Finalisierung in 720p ausgeben; für 1080p auf Seedance 2.0 oder Seedance 2.5 wechseln.

Vor dem Go-live beachten

• Callbacks statt Polling: auf oberster Ebene der Anfrage (gleichrangig zu input) "callback": {"url": "https://deine-domain/hiapi/callback"} hinzufügen und nach taskId deduplizieren.
• Rechtzeitig sichern: output[0].url ist ein temporärer Link.
• Wiederholungen mit Idempotenz-Key: im Request-Header Idempotency-Key hinzufügen – bei gleichem Key wird die Aufgabe nur einmal erstellt.
• Automatische Rückerstattung bei Fehlschlag: Abgerechnet werden nur erfolgreich generierte Videos.

Häufige Fragen

Wie wählt man zwischen Seedance 2.0 Mini und Seedance 2.0?

In 480p kostet Mini etwa ein Fünftel von 2.0 ($0,0272 gegenüber $0,136 pro Sekunde), geht aber nur bis 720p. Für Entwürfe, massenhaft kurze Social-Media-Videos und Prompt-Tests Mini verwenden; für 1080p oder 4K auf Seedance 2.0 wechseln.

Warum gibt es einen Fehler, wenn resolution fehlt?

Bei diesem Modell ist resolution ein Pflichtfeld; es muss explizit "480p" oder "720p" angegeben werden.

Gibt es Ton?

Standardmäßig ja. Im Prompt die gewünschten Geräusche klar beschreiben; ohne Ton generate_audio auf false setzen.

Wie lang darf ein Clip höchstens sein?

4 bis 15 Sekunden.

Für weitere Formulierungen siehe den Seedance 2.0 Prompt-Leitfaden; alternativ direkt auf der Modellseite den Ramen-Clip generieren.