Wie verwende ich die Seedance 2.0 API? In 5 Minuten zum ersten Video

TL;DR

• Seedance 2.0 ist das Videogenerierungsmodell von ByteDance und bei HiAPI in drei Stufen erhältlich: Mini, Fast und Standard. Öffnen Sie die Modellseite und generieren Sie direkt online – neue Nutzer erhalten bei der Registrierung 200 Credits.
• Abrechnung pro Sekunde: Mini 720p kostet $0.0586 pro Sekunde, Standard 720p $0.293 pro Sekunde, 1080p über die ext-Route $0.342 pro Sekunde; Audio kostet keinen Aufpreis.
• Die API hat nur zwei Schritte: mit POST /v1/tasks absenden und mit der taskId das Ergebnis abfragen. Die folgenden curl- und Python-Beispiele können Sie direkt kopieren und ausführen.

Was kann Seedance 2.0?

• Text zu Video: 4–15 Sekunden, 480p bis 4K, sechs Bildformate (16:9, 9:16, 1:1, 4:3, 3:4, 21:9); bei Image-to-Video kann mit adaptive das Originalbild übernommen werden.
• Image-to-Video: Übergeben Sie ein erstes Frame (first_frame_url) und optional ein letztes Frame (last_frame_url), um das Endbild zu steuern.
• Multimodale Referenzen: bis zu 9 Referenzbilder, 3 Referenzvideos und 3 Referenzaudios, um Personen, Kameraführung oder Rhythmus festzulegen.
• Nativer Ton: generate_audio ist standardmäßig aktiviert; Umgebungsgeräusche und Soundeffekte werden synchron zum Bild generiert.

Die folgende 5-sekündige 720p-Produktaufnahme wurde direkt aus einem Prompt erzeugt:

A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a
brushed-concrete pedestal, soft diffused studio light, the screen wakes to
show a glowing minimalist watch face, faint reflections move across the metal
bezel, premium tech commercial look, calm and clean.

Mit diesem Prompt generieren →

Zwei Einstiegswege

Online ausprobieren (ohne Code)

1. Öffnen Sie die Seedance 2.0-Modellseite, registrieren Sie sich oder melden Sie sich an.
2. Fügen Sie den Prompt ein und wählen Sie Dauer, Auflösung und Bildformat.
3. Klicken Sie auf Generieren und laden Sie das fertige Video direkt herunter (die drei 5-Sekunden-720p-Latte-Beispielvideos auf der Preisseite brauchten von der Absendung bis zur Fertigstellung 168–230 Sekunden).

API-Aufruf

1. Erstellen Sie in der Konsole einen API Key.
2. Senden Sie die Aufgabe mit POST https://api.hiapi.ai/v1/tasks ab; Sie erhalten eine taskId.
3. Prüfen Sie den Status mit GET /v1/tasks/{taskId}; wenn status gleich success ist, laden Sie das Video über output[0].url herunter.

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",
    "input": {
      "prompt": "A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a brushed-concrete pedestal, soft diffused studio light.",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'

Rückgabe:

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

Ergebnis abfragen:

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

Python: absenden, 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(prompt, model="seedance-2.0", timeout_s=900, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    # Bei erneutem Absenden derselben Aufgabe denselben Idempotency-Key mitschicken, um doppelte Abbuchung 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)

url = generate(
    "A barista pours steamed milk into a latte, camera slowly pulls back",
    model="seedance-2.0-mini", duration=5, resolution="480p", aspect_ratio="9:16",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Beim Ausprobieren von Prompts setzen Sie model auf seedance-2.0-mini und die Auflösung auf 480p; 5 Sekunden kosten dann nur $0.136. Nach der Finalisierung wechseln Sie für HD zur Standardversion oder zur ext-Route.

Image-to-Video und multimodale Referenzen

Image-to-Video mit erstem Frame: Fügen Sie in input first_frame_url hinzu; wenn Sie als Bildformat adaptive angeben, wird das Seitenverhältnis des Bildes übernommen:

{
  "model": "seedance-2.0",
  "input": {
    "prompt": "Slow cinematic push-in on the product with a soft light sweep, keep the product still and centered",
    "first_frame_url": "https://your-cdn.example.com/product.jpg",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "resolution": "720p"
  }
}

Referenzbilder, Referenzvideos, Referenzaudios: Verwenden Sie jeweils reference_image_urls (Referenzbilder plus erstes und letztes Frame insgesamt maximal 9), reference_video_urls (maximal 3, insgesamt höchstens 15 Sekunden) und reference_audio_urls (maximal 3, insgesamt höchstens 15 Sekunden).

Eingabekombinationen bei Mini: Bei Mini wählen Sie eines von erstem Frame, Referenzbild oder Referenzvideo; duration und resolution sind Pflichtfelder. Bei der Standardversion ist aspect_ratio Pflicht.

ext-Route: Fügen Sie auf oberster Ebene "route": "ext" hinzu; der Modellname bleibt unverändert. ext bietet nur 720p, 1080p und 4K, ist pro Sekunde günstiger, akzeptiert aber keine Referenzvideos.

Vor dem Produktivbetrieb beachten

• Callback statt Polling verwenden: Fügen Sie auf oberster Ebene der Anfrage "callback": {"url": "https://deine-domain/hiapi/callback"} hinzu; HiAPI benachrichtigt Sie aktiv, wenn die Aufgabe endet (erfolgreich oder fehlgeschlagen). Deduplizieren Sie anhand der taskId.
• Videos werden standardmäßig etwa 7 Tage gespeichert: Übertragen Sie die Datei nach Erhalt von output[0].url in Ihren eigenen Speicher. Für langfristige Aufbewahrung können Sie den persistenten Speicher von HiAPI nutzen (zusätzliche Abrechnung nach Speichermenge).
• Alle Parameter angeben: Schreiben Sie duration, resolution und aspect_ratio immer explizit, damit die Kosten zur Budgettabelle passen.
• Automatische Rückerstattung bei Fehlschlag: Fehlgeschlagene Aufgaben werden nicht berechnet; abgerechnet werden nur erfolgreich generierte Sekunden.

Häufige Fragen

Wie wähle ich zwischen Mini, Fast und Standard?

Für das Ausprobieren von Prompts Mini, für kurze Social-Media-Videos Mini oder Fast 720p, für 1080p / 4K die Standardversion oder die ext-Route. Detaillierte Preise finden Sie unter Seedance 2.0 API-Preise.

Kann ich Prompts auf Chinesisch schreiben?

Ja. Chinesisch und Englisch werden unterstützt; am zuverlässigsten ist es, Kamera, Bewegung, Licht und Ton in getrennten Sätzen klar zu beschreiben.

Kann ich Hochformat generieren?

Ja. Geben Sie bei aspect_ratio 9:16 an; bei Image-to-Video verwenden Sie adaptive, um das Seitenverhältnis des ersten Frames zu übernehmen.

Wie lange dauert ein Video?

Die drei 5-Sekunden-720p-Latte-Beispielvideos auf der Preisseite brauchten von der Absendung bis zur Fertigstellung 168–230 Sekunden. Empfangen Sie Ergebnisse in der Produktion per Callback und verlassen Sie sich nicht auf feste Wartezeiten.

Kopieren Sie den obigen Smartwatch-Prompt und generieren Sie Ihr erstes Video auf der Modellseite; wenn Sie mehr fertige Prompts möchten, sehen Sie sich die Seedance 2.0-Prompt-Beispiele an.