Seedance 2.0 Reference API: Programmatische Multi-Modal-Videogenerierung

Programmgesteuerter Zugriff auf Multi-Modal-KI-Video ändert, was möglich ist. Einzelne Clips sind großartig für Marketing und Content-Erstellung, aber automatisierte Workflows, Katalog-Videogenerierung, benutzerspezifische Personalisierung, Batch-Content-Operationen, erfordern API-Zugriff.

Die Seedance 2.0 Reference API stellt die vollständige Multi-Modal-Funktionalität bereit: bis zu 9 Bilder, 3 Videos und 3 Audio-Clips pro Anfrage, programmgesteuert, zu denselben Preisen pro Sekunde wie die Web-Oberfläche.

Wann Sie die API verwenden sollten

Die Web-UI ist großartig für manuelle, einzelne kreative Arbeiten. Die API ist für alles andere.

Die API ist geeignet, wenn Sie:

• Batch-Generierung über Hunderte von Assets
• Integration mit bestehenden Content- oder Product-Pipelines
• Benutzerspezifische personalisierte Videos in einer Anwendung
• Automatisierte A/B-Tests von Anzeigen-Creative-Varianten
• Geplante Content-Generierung für tägliche Veröffentlichungen
• Katalog-Workflows, die an Datenbankeinträge gebunden sind

Verwenden Sie die Web-UI, wenn:

• Sie kreativ iterieren und jede Ausgabe sehen/anpassen müssen
• Das Volumen niedrig ist (weniger als 10-20 Clips pro Sitzung)
• Sie das Tool zum ersten Mal erkunden

Der Endpoint

Der Reference-to-Video-Endpoint ist:

bytedance/seedance-2.0/reference-to-video

Dies ist der einzige Endpoint, den Sie für Multi-Modal-Reference-Mode-Generierungen benötigen. Eine einzelne Anfrage handhabt Text, bis zu 9 Bilder, bis zu 3 Videos und bis zu 3 Audio-Clips. Das Modell fusioniert alle Eingaben und gibt ein generiertes Video zurück.

Verwenden Sie für Text-zu-Video- oder Single-Image-Workflows stattdessen die standard Seedance 2.0 API Endpoints.

Request-Struktur

Eine typische Reference-to-Video-Anfrage umfasst:

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

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

Preisgestaltung über die API

API-Preise entsprechen exakt den Web-UI-Preisen:

Es gibt keine API-Zugriffsgebühr und keine zusätzliche Gebühr für Reference-Uploads. Sie zahlen nur für generierte Ausgabesekunden.

Credits funktionieren gleich über API und Web-UI. Laden Sie über Preisseite auf und derselbe Credit-Pool wird von beiden Schnittstellen verwendet. Bei hohem API-Nutzungsvolumen ist das Max-Tier von 100 Dollar (12.000 Credits) der wirtschaftlichste Ausgangspunkt.

Beginnen Sie mit der API zu bauen. Erhalten Sie API-Zugriff mit 50 kostenlosen Credits bei der Anmeldung. Kostenlos starten.

Beispielhafte Anwendungsfälle

Katalog-Video-Automatisierung

Für E-Commerce-Plattformen mit Hunderten oder Tausenden von SKUs ermöglicht die API Ihnen, ein kurzes Produktvideo für jedes Produkt basierend auf vorhandenen Produktbildern zu generieren.

Workflow:

1. Fragen Sie Ihre Produktdatenbank ab
2. Rufen Sie für jedes Produkt 5-7 Produktbilder ab
3. Kombinieren Sie mit einem unternehmensweiten Reference-Paket (2-3 Bilder)
4. Rufen Sie die API mit Prompt-Vorlage für Produktoffenbarung auf
5. Speichern Sie die zurückgegebene Video-URL in Ihrem Produktdatensatz
6. Bereitstellen auf Produktdetailseiten

Wirtschaft: 500-SKU-Katalog bei 5-Sekunden-Videos = 500 × 303 Credits = 151.500 Credits = ~1.515 Dollar. Für einen katalogweiten Video-Rollout ist das bemerkenswerter Wert.

Personalisierte Videogenerierung

Für Apps, die benutzerspezifische personalisierte Videos bereitstellen, Grußkarten, Feier-Content, Onboarding-Intros, ermöglicht die API Ihnen, Videos nach Bedarf mit benutzerspezifischen Referenzen zu generieren.

Workflow:

1. Benutzer lädt 3-5 persönliche Fotos hoch (mit Zustimmung)
2. Ihre App kombiniert diese mit einem Style-Reference-Paket
3. API-Aufruf generiert ein personalisiertes Video-Clip
4. Liefern Sie dem Benutzer über Ihre App

Dies skaliert zu Zehntausenden von Benutzern ohne Overhead des Content-Teams.

Ad-Creative-Varianten-Generierung

Marketing-Teams, die mit bezahlten Social-Media-Kampagnen arbeiten, benötigen ständig Creative-Varianten. Die API ermöglicht Ihnen, A/B-Test-Varianten programmgesteuert zu generieren.

Workflow:

1. Definieren Sie ein Marken-Reference-Paket (6-8 Bilder)
2. Schreiben Sie Prompt-Vorlagen für verschiedene Anzeigen-Winkel
3. Durchlaufen Sie Varianten, rufen Sie die API für jede auf
4. Liefern Sie generierte Clips an Ihre Anzeigenplattform
5. Verfolgen Sie die Leistung und generieren Sie Gewinner im großen Maßstab

Sie können 50 Anzeigen-Varianten in einem automatisierten Durchlauf für etwa 150 Dollar in API-Kosten produzieren, im Vergleich zu traditioneller Produktion mit Tausenden pro Variante.

Response-Verarbeitung

API-Antworten umfassen typischerweise:

• Generation ID: Verfolgen Sie den Request-Status
• Status: pending, processing, complete, failed
• Output URL: Verfügbar, sobald der Status vollständig ist
• Metadaten: Dauer, Auflösung, Dateigröße

Reference-Mode-Generierungen dauern 60-180 Sekunden, daher sollte Ihre Integration asynchrone Responses verarbeiten können. Rufen Sie den Status-Endpoint regelmäßig ab oder verwenden Sie Webhooks (falls in Ihrem Konto verfügbar), um Benachrichtigungen nach Fertigstellung zu erhalten.

Blockieren Sie keine benutzerorientierten Workflows auf die Fertigstellung der Generierung. Reihen Sie den Request ein, benachrichtigen Sie den Benutzer, wenn er fertig ist, und liefern Sie asynchron.

Rate Limits und Concurrency

Für die meisten Account-Stufen gelten gleichzeitige Generierungslimits. Planen Sie Ihre Batch-Workflows so, dass diese Limits eingehalten werden, reihen Sie Requests ein und verarbeiten Sie sie mit der zulässigen Concurrency.

Für hochvolumige Produktions-Workflows kontaktieren Sie den Platform-Support zu Concurrency-Limits für Unternehmen. Die meisten Standard-Accounts können moderate Batch-Arbeiten (10-30 gleichzeitige Generierungen) ohne Probleme durchführen.

Authentifizierung und Schlüssel

Der API-Zugriff verwendet Standard-Key-basierte Authentifizierung. Generieren Sie Ihren API-Schlüssel in Ihren Kontoeinstellungen nach der Anmeldung. Halten Sie Schlüssel nur serverseitig, geben Sie sie nie in Client-Code frei.

Idempotenz und Wiederholungen

API-Generierungen sind nicht nativ idempotent, da jeder Aufruf Credits kostet. Wenn eine Generierung mittendrin fehlschlägt, sollte die Wiederholungslogik den Status der fehlgeschlagenen Generierung überprüfen, bevor sie neu anfordert. Eine fehlgeschlagene Generierung verbraucht normalerweise keine Credits, aber überprüfen Sie immer in Ihrem Account-Dashboard.

Implementieren Sie für Produktions-Workflows:

• Wiederholungslogik mit exponentieller Backoff bei vorübergehenden Fehlern
• Status-Polling oder Webhook-Verarbeitung für asynchrone Fertigstellung
• Fehlerprotokollierung, um systematische Probleme zu erfassen
• Credit-Balance-Überwachung, um vor Erschöpfung zu warnen

Best Practices für programmgesteuerte Workflows

1. Verwenden Sie konsistente Reference-Pakete. Für Katalog- oder Serienarbeiten hashen Sie Ihre Reference-Pakete, damit identische Pakete über Requests hinweg konsistentere Stile erzeugen.

2. Halten Sie Prompt-Vorlagen einfach. Programmgesteuerte Prompts sollten aus strukturierten Daten generiert werden, nicht einzeln geschrieben pro Aufruf. Vorlage + Datenfelder ist das richtige Muster.

3. Cachen Sie Reference-Datei-URLs. Wenn Sie URL-basierte Referenzen verwenden, stellen Sie sicher, dass die URLs stabil und zugänglich sind. Abgelaufene S3-URLs oder verschobene Dateien führen zu fehlgeschlagenen Generierungen.

4. Handhaben Sie Content-Sicherheit angemessen. Die Plattform hat Content-Sicherheits-Filter. Bauen Sie elegante Behandlung für Filter-abgelehnte Requests in Ihren Workflow ein.

5. Protokollieren Sie Generierungs-Metadaten. Verfolgen Sie jede Generierung, Prompt, Reference-Set, Dauer, verbrauchte Credits, Output-URL, in Ihrer Anwendungs-Datenbank. Dies macht Debugging und Reporting viel einfacher.

Beispiel-Batch-Workflow

Pseudocode für einen Batch-Produktvideo-Generierungs-Workflow:

for product in product_catalog:
    references = build_reference_bundle(
        brand_images,
        product.photo_urls[:4]
    )
    prompt = f"{product.name} Produkt dreht sich langsam auf einer sauberen Oberfläche, weiches Studio-Licht, 5 Sekunden"

    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 Follow-up-Poller handhabt die Fertigstellung und speichert die Output-URL gegen den Produktdatensatz.

Überwachung und Kostenkontrolle

Für die Produktions-API-Nutzung richten Sie Kostenverfolgung ein:

• Tägliche Budget-Alerts: Alarmieren Sie, wenn die täglichen API-Ausgaben einen Schwellenwert überschreiten
• Pro-Workflow-Limits: Begrenzen Sie Batch-Jobs auf einen maximalen Credit-Verbrauch, um zu verhindern, dass Automation außer Kontrolle gerät
• Nutzungs-Dashboards: Verfolgen Sie, welche Workflows die meisten Credits verbrauchen
• Credit-Balance-Alerts: Laden Sie auf, bevor Sie leer ausgehen

Diese Schutzmaßnahmen verhindern Überraschungen, wenn Sie Automatisierung skalieren.

API vs Web-UI Preisparität

Eine häufig gestellte Frage: Gibt es einen Rabatt für API-Nutzung? Nein, API und Web-UI berechnen beide gleich 0,3024 Dollar pro Sekunde. Die API wird für die Arbeit bepreist, die sie leistet, nicht für die Schnittstelle, die Sie verwenden.

Wo Hochvolumen-Benutzer sparen, ist in ihrer Tier-Auswahl. Schwere API-Benutzer sollten auf dem Max $100 Stufe laufen für das beste Preis-Leistungs-Verhältnis.

Erste Schritte mit der API

1. Melden Sie sich unter arteza.ai an (50 kostenlose Credits)
2. Generieren Sie Ihren API-Schlüssel in den Kontoeinstellungen
3. Laden Sie ein Credit-Paket passend zu Ihrem erwarteten Volumen auf
4. Integrieren Sie den Endpoint in Ihre Anwendung
5. Beginnen Sie mit kleinen Test-Batches, um Ihren Workflow zu validieren
6. Skalieren Sie auf Produktion, sobald getestet

Der erste API-Aufruf kann innerhalb einer Stunde nach der Anmeldung für die meisten Integrationen aktiv sein.

Weitere Lektüren

Für den vollständigen Reference-Funktionssatz lesen Sie Seedance 2.0 Reference Vollständiger Leitfaden. Für den Web-UI-Workflow siehe Stilkonsistentes Tutorial. Für Standard-Seedance-2.0-API-Details überprüfen Sie Seedance 2.0 API Leitfaden.

Programmgesteuerte Multi-Modal-Videos sind hier. Bauen Sie etwas Neues damit.