Seedance 2.0 API: Ein praktischer Leitfaden für Entwickler

Zuletzt aktualisiert: März 2026

Die Seedance 2.0 API ermöglicht es Entwicklern, KI-Videogenerierung direkt in ihre Anwendungen zu integrieren. Dieser Leitfaden behandelt, was die API tatsächlich leistet, wie sie im Vergleich zu Alternativen abschneidet und wie Sie loslegen können.

Was die Seedance 2.0 API leistet

Die Seedance 2.0 API bietet programmatischen Zugriff zur Generierung von Videos aus Text-Prompts und Bildern. Anstatt die Weboberfläche zu nutzen, senden Sie Generierungsaufträge über HTTP-Anfragen, fragen den Status ab und rufen Video-URLs ab.

Kernfunktionen:

• Text-zu-Video-Generierung (Seedance 2.0 Modell)
• Bild-zu-Video-Generierung (Animation eines Referenzbildes)
• Asynchrone Auftragseinreichung mit Statusabfrage
• Ausgabe im MP4-Format, 1080p HD
• Bis zu ~10 Sekunden pro Generierung

Was sie nicht leistet:

• Keine Echtzeit-Streaming-Ausgabe (Generierung benötigt Zeit)
• Keine integrierte Videobearbeitung
• Keine Audiogenerierung (im Gegensatz zu Google Veo 3)
• Generierungs-Wartezeiten variieren je nach Auslastung

Seedance API vs. Konkurrierende APIs

Bevor Sie entwickeln, lohnt es sich, die Optionen ehrlich zu vergleichen.

Wann die Seedance API sinnvoll ist:

• Sie möchten gute Qualität ohne die Komplexität der Google Cloud-Einrichtung
• Sie bauen ein Produkt, das zuverlässige Credits-basierte Preise benötigt
• Sie möchten Zugriff auf mehrere Modelle in einer API (Seedance 1.5 für Geschwindigkeit, 2.0 für Qualität)

Wann Alternativen in Betracht gezogen werden sollten:

• Höchstmögliche Qualität erforderlich → Google Veo 3 (Vertex AI)
• Native Audiogenerierung erforderlich → Google Veo 3
• Erweiterte Kamerasteuerung erforderlich → Runway API

Erste Schritte

Schritt 1: Holen Sie sich Ihren API-Schlüssel

Melden Sie sich unter seedance.tv an und navigieren Sie zu Ihren Kontoeinstellungen. Der API-Zugriff ist in kostenpflichtigen Plänen ab 9,9 €/Monat verfügbar.

Speichern Sie Ihren API-Schlüssel als Umgebungsvariable – codieren Sie ihn niemals fest in Quelldateien:

export SEEDANCE_API_KEY="ihr-api-schluessel-hier"

Schritt 2: Senden Sie einen Generierungsauftrag

Die API verwendet ein asynchrones Muster: Sie senden einen Auftrag und fragen den Status ab.

import requests
import time
import os

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.seedance.tv/v1"

def generate_video(prompt: str, model: str = "seedance-2.0"):
    """Senden Sie einen Text-zu-Video-Generierungsauftrag."""
    response = requests.post(
        f"{BASE_URL}/videos",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "prompt": prompt,
            "model": model,
            "aspect_ratio": "16:9",
            "resolution": "1080p"
        }
    )
    response.raise_for_status()
    return response.json()["job_id"]

Schritt 3: Fragen Sie den Status ab

def wait_for_completion(job_id: str, poll_interval: int = 5, timeout: int = 300):
    """Warten Sie, bis die Videogenerierung abgeschlossen ist."""
    start_time = time.time()
    
    while time.time() - start_time < timeout:
        response = requests.get(
            f"{BASE_URL}/videos/{job_id}",
            headers={"Authorization": f"Bearer {API_KEY}"}
        )
        response.raise_for_status()
        data = response.json()
        
        status = data["status"]
        
        if status == "completed":
            return data["output_url"]
        elif status == "failed":
            raise Exception(f"Generierung fehlgeschlagen: {data.get('error', 'Unbekannter Fehler')}")
        
        # Noch in Bearbeitung
        print(f"Status: {status} ({int(time.time() - start_time)}s vergangen)")
        time.sleep(poll_interval)
    
    raise TimeoutError(f"Generierung wurde nicht innerhalb von {timeout} Sekunden abgeschlossen")

# Verwendung
job_id = generate_video("Eine langsame Dolly-Fahrt durch eine neonbeleuchtete Tokioter Straße bei Nacht, Regenreflexionen auf nassem Asphalt, kinoreifes 1080p")
video_url = wait_for_completion(job_id)
print(f"Video bereit: {video_url}")

Schritt 4: Bild-zu-Video

So animieren Sie ein Referenzbild:

def generate_from_image(image_url: str, prompt: str):
    """Animieren Sie ein Referenzbild."""
    response = requests.post(
        f"{BASE_URL}/videos",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "prompt": prompt,
            "model": "seedance-2.0",
            "image_url": image_url,
            "type": "image-to-video",
            "aspect_ratio": "16:9"
        }
    )
    response.raise_for_status()
    return response.json()["job_id"]

Prompt-Engineering für die API

Die Qualität Ihrer Ausgabe hängt stark von der Prompt-Struktur ab. Hier sind Muster, die konsistent funktionieren:

Gute Text-zu-Video-Prompt-Struktur:

[Kameraeinstellung], [Subjektbeschreibung], [Aktion/Bewegung], [Umgebung], [Beleuchtung], [Stil]

Beispiel:

Nahaufnahme, Verfolgungsaufnahme, Frau, die durch einen sonnenüberfluteten Olivenhain geht, Haar im Wind, warmes Nachmittagslicht durch Blätter, kinoreife geringe Schärfentiefe

Häufige Fehler, die API-Credits verschwenden:

Zu vage:

Ein schönes Video

Zu viele konkurrierende Elemente:

Ein Mann und eine Frau und ein Hund am Strand und auch ein Sonnenuntergang und Wellen und Berge im Hintergrund

Fehlende Bewegungsbeschreibung:

Eine Kaffeetasse auf einem Tisch

Besser: Eine Kaffeetasse auf einem Holztisch, Dampf steigt langsam auf, weiches natürliches Fensterlicht von links, Makroobjektiv

Das richtige Modell auswählen:

Empfohlener Workflow: Entwurf mit seedance-1.5, Prompt verfeinern, dann finale Generierung mit seedance-2.0. Dies senkt die API-Kosten während der Iteration.

Seitenverhältnisse

ASPECT_RATIOS = {
    "landscape": "16:9",   # YouTube, Desktop, Anzeigen
    "portrait": "9:16",    # TikTok, Instagram Reels, Shorts
    "square": "1:1",       # Instagram-Beiträge
    "cinema": "21:9"       # Kinoreifes Breitbild
}

Fehlerbehandlung

def safe_generate(prompt: str, max_retries: int = 3):
    """Generierung mit Wiederholungslogik für vorübergehende Fehler."""
    for attempt in range(max_retries):
        try:
            job_id = generate_video(prompt)
            return wait_for_completion(job_id)
        except requests.HTTPError as e:
            if e.response.status_code == 429:
                # Ratenlimit erreicht – zurückhalten
                wait = 30 * (attempt + 1)
                print(f"Ratenlimit erreicht. Warte {wait}s...")
                time.sleep(wait)
            elif e.response.status_code == 402:
                raise Exception("Nicht genügend Credits. Laden Sie Ihr Konto unter seedance.tv auf")
            else:
                raise
        except TimeoutError:
            if attempt < max_retries - 1:
                print(f"Zeitüberschreitung bei Versuch {attempt + 1}, wiederhole...")
            else:
                raise
    raise Exception("Maximale Anzahl von Wiederholungen überschritten")

Ratenlimits und Credit-Nutzung

• Ratenlimit: Variiert je nach Plan. Überprüfen Sie Ihr Dashboard für aktuelle Limits.
• Credits pro Generierung: Hängt von Modell, Dauer und Auflösung ab. Das Dashboard zeigt den aktuellen Credit-Saldo.
• Best Practice für die Produktion: Implementieren Sie eine Auftragswarteschlange, anstatt viele gleichzeitige Anfragen zu senden. Gestaffelte Einreichungen vermeiden Ratenlimit-Fehler und sind kosteneffizienter.

Anwendungsfälle, für die diese API gut geeignet ist

Produktvideo-Automatisierung: E-Commerce-Plattformen, die Videos in großem Maßstab aus Produktbildern generieren. Füttern Sie ein Produktbild + Marken-Prompt → automatisierte Videoclips für jede SKU.

Social-Media-Pipelines: Geplante Contentsysteme, die eine Woche Videocontent aus einer genehmigten Prompt-Liste generieren. Kombinieren Sie es mit einem Video-Warteschlangen-Tool für die automatische Veröffentlichung.

Anzeigen-Creative-Tests: Marketing-Tools, die mehrere visuelle Interpretationen desselben Konzepts für A/B-Tests generieren. Generieren Sie 5 Variationen eines Anzeigenkonzepts in einem Batch.

Prototypen-Generierung: Design- und Produktteams, die Konzeptvideos generieren, bevor sie in die Produktion gehen. Viel günstiger als traditionelle Produktion für die frühe Visualisierung.

Erstellen einer einfachen Videogenerierungs-Pipeline

import json
from pathlib import Path

def batch_generate(prompts: list[dict], output_dir: str = "./videos"):
    """Generieren Sie mehrere Videos aus einer Liste von Prompt-Konfigurationen."""
    Path(output_dir).mkdir(exist_ok=True)
    results = []
    
    for i, config in enumerate(prompts):
        print(f"Generiere {i+1}/{len(prompts)}: {config['name']}")
        
        try:
            # Schnelles Modell für Entwürfe, Premium für Finale
            model = "seedance-2.0" if config.get("final") else "seedance-1.5"
            job_id = generate_video(config["prompt"], model=model)
            url = wait_for_completion(job_id)
            
            results.append({
                "name": config["name"],
                "url": url,
                "status": "success"
            })
            print(f"  ✓ {url}")
            
        except Exception as e:
            results.append({
                "name": config["name"],
                "error": str(e),
                "status": "failed"
            })
            print(f"  ✗ Fehlgeschlagen: {e}")
        
        # Kleine Verzögerung zwischen Einreichungen
        time.sleep(2)
    
    # Ergebnisse speichern
    with open(f"{output_dir}/results.json", "w") as f:
        json.dump(results, f, indent=2)
    
    return results

# Beispielverwendung
prompts = [
    {"name": "hero-shot", "prompt": "...", "final": True},
    {"name": "product-demo", "prompt": "...", "final": False},
]
results = batch_generate(prompts)

Häufig gestellte Fragen

Hat Seedance 2.0 eine offizielle öffentliche API?

Seedance bietet API-Zugriff als Teil kostenpflichtiger Pläne an. Überprüfen Sie die Entwicklerdokumentation auf seedance.tv für aktuelle Zugriffsdetails und Endpunktspezifikationen.

Wie funktioniert die Preisgestaltung?

Die API-Nutzung wird von Ihrem Credit-Guthaben abgezogen. Verschiedene Modelle kosten unterschiedliche Credit-Beträge pro Generierung. Überprüfen Sie Ihr Dashboard für aktuelle Credit-Sätze pro Modell.

Wie lange dauert die Generierung pro Video?

Typischerweise 30 Sekunden bis 3 Minuten, abhängig von der Modellkomplexität und der Warteschlangenauslastung. Seedance 1.5 ist schneller; Seedance 2.0 dauert länger, liefert aber höhere Qualität.

Kann ich Videos länger als 10 Sekunden generieren?

Derzeit nicht mit einem einzelnen API-Aufruf. Für längere Inhalte generieren Sie mehrere Clips und fügen Sie sie in Ihrer Anwendung mit einer Videobearbeitungsbibliothek wie moviepy oder ffmpeg zusammen.

Ist die Ausgabe für die kommerzielle Nutzung geeignet?

Überprüfen Sie die aktuellen Nutzungsbedingungen auf seedance.tv für Details zur kommerziellen Lizenzierung. Im Allgemeinen ist auf kostenpflichtigen Plänen generierter Inhalt für die kommerzielle Nutzung lizenziert.

Wie schneidet die Seedance API im Vergleich zur Runway API ab?

Die Runway API ($0,05-0,10/Sekunde) bietet erweiterte Kamerasteuerung und das Gen-3 Alpha Modell. Die Seedance API verwendet Credits-basierte Preise, die für die Budgetplanung vorhersehbarer sind. Runway punktet bei kinoreifer Verarbeitung und Kamerasteuerung; Seedance punktet bei Modellvielfalt und Preistransparenz. Für die meisten Entwickler: Testen Sie beide für Ihren spezifischen Anwendungsfall – die Ergebnisse variieren stark je nach Inhaltstyp.

---

Jetzt loslegen

Bereit, KI-Video in Ihre Anwendung zu integrieren?

Jetzt bei Seedance anmelden → — erhalten Sie kostenlose Credits zum Testen der API, kostenpflichtige Pläne ab 9,9 €/Monat.

• Text-zu-Video-Playground — testen Sie Prompts vor dem Bauen
• Bild-zu-Video-Playground — testen Sie Bildanimation
• Seedance 2.0 Modelldetails — Qualitätsbenchmarks und Spezifikationen