Seedance 2.0 Referenz-API: Programmatisches multimodales Video

Programmatischer Zugriff auf multimodales KI-Video verändert das Mögliche. Einzelne Clips sind großartig für Marketing und Content-Erstellung, aber automatisierte Workflows - Katalogvideogenerierung, nutzerspezifische Personalisierung, Batch-Content-Operationen - erfordern API-Zugang.

Die Seedance 2.0 Reference API bietet die vollständige multimodale Funktion: bis zu 9 Bilder, 3 Videos und 3 Audioclips pro Anfrage, programmatisch, zum selben Sekundenpreis wie die Web-Oberfläche.

Kurzfassung

• Endpunkt: bytedance/seedance-2.0/reference-to-video
• Eingaben: Textprompt + bis zu 9 Bilder + 3 Videos + 3 Audioclips
• Preis: 0,3024 Dollar/Sek. Ausgabe, identisch mit der Web-Oberfläche
• Ausgabe: 720p-Video, 4-15 Sekunden, native Audiosynchronisation
• Generierungszeit: 60-180 Sekunden pro Anfrage
• Ideal für Katalogautomatisierung, Batch-Workflows und programmatische Inhalte
• API kostenlos mit 10 Credits testen

Wann die API die richtige Wahl ist

Die Web-Oberfläche eignet sich hervorragend für manuelle, einzelne kreative Arbeiten. Die API ist für alles andere gedacht.

Die API passt, wenn du Folgendes brauchst:

• Batch-Generierung über Hunderte von Assets
• Integration in bestehende Inhalts- oder Produktpipelines
• Nutzerspezifisches personalisiertes Video in einer Anwendung
• Automatisiertes A/B-Testing von Werbemittel-Varianten
• Geplante Inhaltsgenerierung für die tägliche Veröffentlichung
• Katalogisierungs-Workflows, die an Datenbankeinträge geknüpft sind

Bleib bei der Web-Oberfläche, wenn:

• Du kreativ iterierst und jede Ausgabe sehen und anpassen möchtest
• Das Volumen gering ist (weniger als 10-20 Clips pro Sitzung)
• Du das Tool zum ersten Mal erkundest

Der Endpunkt

Der Reference-to-Video-Endpunkt lautet:

bytedance/seedance-2.0/reference-to-video

Dies ist der einzige Endpunkt, den du für multimodale Reference-Modus-Generierungen benötigst. Eine einzige Anfrage verarbeitet Text, bis zu 9 Bilder, bis zu 3 Videos und bis zu 3 Audioclips. Das Modell vereint alle Eingaben und gibt ein generiertes Video zurück.

Für Text-to-Video- oder Einzelbild-Workflows verwendest du stattdessen die Standard Seedance 2.0 API-Endpunkte.

Anfragestruktur

Eine typische Reference-to-Video-Anfrage enthält:

• prompt: Textbeschreibung von Motiv und Aktion (erforderlich)
• reference_images: Array mit bis zu 9 Bild-URLs oder Dateireferenzen
• reference_videos: Array mit bis zu 3 Video-URLs (optional)
• reference_audio: Array mit bis zu 3 Audio-URLs (optional)
• duration: Ausgabedauer in Sekunden, 4-15 (erforderlich)
• aspect_ratio: Eines von 16:9, 9:16, 1:1 (erforderlich)

Eingabedateien können je nach Integrationsansatz als URLs (öffentlich zugänglich) oder direkt hochgeladen bereitgestellt werden.

Preise über die API

Die API-Preise stimmen genau mit den Web-Oberflächen-Preisen überein:

Es gibt keine API-Zugriffsgebühr und keinen zusätzlichen Aufpreis für Reference-Uploads. Du zahlst nur für generierte Ausgabesekunden.

Credits funktionieren über API und Web-Oberfläche hinweg gleich. Lade sie über Preisseite auf, und dasselbe Credit-Guthaben wird von beiden Oberflächen genutzt. Für API-Nutzung mit hohem Volumen bietet der Studio-Plan für 120 Dollar (1.800 Credits pro Monat) das beste Preis-Leistungs-Verhältnis pro Credit, und jedes zusätzlich aufgeladene Guthaben verfällt nie.

Starte jetzt mit der API. Erhalte API-Zugang mit 10 kostenlosen Credits bei der Anmeldung. Kostenlos starten.

Beispiel-Anwendungsfälle

Katalogvideo-Automatisierung

Für E-Commerce-Plattformen mit Hunderten oder Tausenden von SKUs ermöglicht die API die Generierung eines kurzen Produktvideos für jedes Produkt auf Basis vorhandener Produktbilder.

Workflow:

1. Produktdatenbank abfragen
2. Für jedes Produkt 5-7 Produktbilder abrufen
3. Mit einem markenweiten Reference-Bundle (2-3 Bilder) kombinieren
4. Die API mit einem Prompt-Template für die Produktpräsentation aufrufen
5. Die zurückgegebene Video-URL im Produktdatensatz speichern
6. Auf Produktdetailseiten ausliefern

Wirtschaftlichkeit: Katalog mit 500 SKUs bei 5-Sekunden-Videos = 500 × 303 Credits = 151.500 Credits = ~1.515 Dollar. Für einen katalogweiten Video-Rollout ist das ein bemerkenswertes Preis-Leistungs-Verhältnis.

Personalisierte Videogenerierung

Für Apps, die nutzerspezifisch personalisierte Videos liefern - Grußkarten, Feiertagsinhalte, Onboarding-Intros - ermöglicht die API die bedarfsgesteuerte Generierung von Videos mit nutzerspezifischen Referenzen.

Workflow:

1. Nutzer lädt 3-5 persönliche Fotos hoch (mit Einwilligung)
2. Deine App kombiniert sie mit einem Stilreferenz-Bundle
3. Der API-Aufruf generiert einen personalisierten Videoclip
4. Auslieferung an den Nutzer über deine App

Dies skaliert auf Zehntausende von Nutzern, ohne dass ein Content-Team benötigt wird.

Generierung von Werbemittel-Varianten

Marketing-Teams, die bezahlte Social-Media-Werbung schalten, benötigen ständig neue Kreativvarianten. Die API ermöglicht die programmatische Generierung von A/B-Test-Varianten.

Workflow:

1. Ein Marken-Reference-Bundle definieren (6-8 Bilder)
2. Prompt-Templates für verschiedene Werbebotschaften erstellen
3. Varianten in einer Schleife durchlaufen und die API für jede aufrufen
4. Generierte Clips an deine Werbeplattform übergeben
5. Performance tracken und Gewinner im großen Maßstab generieren

Du kannst 50 Werbevarianten in einem automatisierten Durchlauf für ~150 Dollar an API-Kosten produzieren, verglichen mit der traditionellen Produktion, die Tausende pro Variante kostet.

Umgang mit Antworten

API-Antworten enthalten in der Regel:

• Generierungs-ID: Den Anfragestatus verfolgen
• Status: pending, processing, complete, failed
• Ausgabe-URL: Verfügbar, sobald der Status "complete" ist
• Metadaten: Dauer, Auflösung, Dateigröße

Reference-Modus-Generierungen dauern 60-180 Sekunden, daher sollte deine Integration asynchrone Antworten verarbeiten können. Frage den Status-Endpunkt ab oder nutze Webhooks (sofern in deinem Konto verfügbar), um bei Fertigstellung benachrichtigt zu werden.

Blockiere keine nutzerseitigen Abläufe durch das Warten auf die Generierungsfertigstellung. Stelle die Anfrage in eine Warteschlange, benachrichtige den Nutzer bei Fertigstellung und liefere asynchron aus.

Ratenlimits und Parallelität

Für die meisten Kontoebenen gelten Limits für gleichzeitige Generierungen. Plane deine Batch-Workflows so, dass sie diese Limits einhalten - stelle Anfragen in eine Warteschlange und verarbeite sie mit der erlaubten Parallelität.

Für Produktions-Workflows mit hohem Volumen wende dich an den Plattform-Support bezüglich unternehmensweiter Parallelitätslimits. Die meisten Standardkonten können moderate Batch-Arbeit (10-30 gleichzeitige Generierungen) problemlos bewältigen.

Authentifizierung und Schlüssel

Der API-Zugang verwendet Standard-Schlüssel-basierte Authentifizierung. Generiere deinen API-Schlüssel in den Kontoeinstellungen nach der Anmeldung. Bewahre Schlüssel nur serverseitig auf - exponiere sie niemals in clientseitigem Code.

Idempotenz und Wiederholungsversuche

API-Generierungen sind von Natur aus nicht idempotent, da jeder Aufruf Credits kostet. Wenn eine Generierung mittendrin fehlschlägt, sollte die Wiederholungslogik den Status der fehlgeschlagenen Generierung prüfen, bevor eine erneute Anfrage gestellt wird. Eine fehlgeschlagene Generierung verbraucht in der Regel keine Credits, aber überprüfe dies immer in deinem Konto-Dashboard.

Für Produktions-Workflows solltest du Folgendes implementieren:

• Wiederholungslogik mit exponentiellem Backoff bei vorübergehenden Fehlern
• Statusabfrage oder Webhook-Verarbeitung für asynchrone Fertigstellung
• Fehlerprotokollierung zur Erkennung systematischer Probleme
• Credit-Guthaben-Überwachung mit Benachrichtigung vor dem Aufbrauchen

Best Practices für programmatische Workflows

1. Verwende konsistente Reference-Bundles. Für Katalog- oder Serienarbeiten solltest du deine Reference-Bundles hashen, damit identische Bundles über verschiedene Anfragen hinweg einen konsistenteren Stil erzeugen.

2. Halte Prompt-Templates einfach. Programmatische Prompts sollten aus strukturierten Daten generiert werden, nicht handschriftlich pro Aufruf. Template plus Datenfelder ist das richtige Muster.

3. Caching von Reference-Datei-URLs. Wenn du URL-basierte Referenzen verwendest, stelle sicher, dass die URLs stabil und zugänglich sind. Abgelaufene S3-URLs oder verschobene Dateien führen zu fehlgeschlagenen Generierungen.

4. Inhaltsfilter angemessen behandeln. Die Plattform verfügt über Inhaltsfilter. Baue eine elegante Fehlerbehandlung für vom Filter abgelehnte Anfragen in deinen Workflow ein.

5. Generierungsmetadaten protokollieren. Tracke jede Generierung - Prompt, Reference-Set, Dauer, verbrauchte Credits, Ausgabe-URL - in deiner Anwendungsdatenbank. Das macht Debugging und Reporting erheblich einfacher.

Beispiel-Batch-Workflow

Pseudocode für einen Batch-Produktvideogenerierungs-Workflow:

for product in product_catalog:
    references = build_reference_bundle(
        brand_images,
        product.photo_urls[:4]
    )
    prompt = f"{product.name} product rotates slowly on a clean surface, soft studio lighting, 5 seconds"

    response = seedance_api.generate(
        endpoint="bytedance/seedance-2.0/reference-to-video",
        prompt=prompt,
        reference_images=references,
        duration=5,
        aspect_ratio="16:9"
    )

    generation_id = response.id
    queue_poll_task(generation_id, product.id)

Ein nachgelagerter Poller verarbeitet die Fertigstellung und speichert die Ausgabe-URL beim Produktdatensatz.

Monitoring und Kostenkontrolle

Für den produktiven API-Einsatz solltest du ein Kosten-Monitoring einrichten:

• Tagesbudget-Benachrichtigungen: Benachrichtigung, wenn die täglichen API-Ausgaben einen Schwellenwert überschreiten
• Workflow-spezifische Obergrenzen: Batch-Jobs auf einen maximalen Credit-Verbrauch begrenzen, um unkontrollierte Automatisierung zu verhindern
• Nutzungs-Dashboards: Verfolgen, welche Workflows die meisten Credits verbrauchen
• Credit-Guthaben-Benachrichtigungen: Aufladen, bevor das Guthaben aufgebraucht ist

Diese Schutzmaßnahmen verhindern Überraschungen, wenn du die Automatisierung skalierst.

Preisparität zwischen API und Web-Oberfläche

Eine häufige Frage: Gibt es einen Rabatt für die API-Nutzung? Nein - API und Web-Oberfläche berechnen beide denselben Preis von 0,3024 Dollar pro Sekunde. Die API wird nach der geleisteten Arbeit berechnet, nicht nach der verwendeten Oberfläche.

Wo Nutzer mit hohem Volumen sparen, ist bei der Tarifwahl. Intensive API-Nutzer sollten den $120 Studio-Plan verwenden, um den besten Preis pro Dollar zu erhalten.

Erste Schritte mit der API

1. Registriere dich unter arteza.ai (10 kostenlose Credits)
2. Generiere deinen API-Schlüssel in den Kontoeinstellungen
3. Lade ein Credit-Paket passend zu deinem erwarteten Volumen auf
4. Integriere den Endpunkt in deine Anwendung
5. Beginne mit kleinen Testbatches, um deinen Workflow zu validieren
6. Skaliere auf den Produktionsbetrieb, sobald alles getestet ist

Der erste API-Aufruf kann bei den meisten Integrationen innerhalb einer Stunde nach der Anmeldung live sein.

Weiterführende Artikel

Den vollständigen Reference-Funktionsumfang findest du in Vollständiger Leitfaden zu Seedance 2.0 Reference. Den Web-Oberflächen-Workflow beschreibt Tutorial zur stilkonsistenten Darstellung. Einzelheiten zur Standard-Seedance-2.0-API findest du unter Seedance 2.0 API-Leitfaden.

Programmatisches multimodales Video ist da. Baue etwas Neues damit.