Seedance 1.5 Pro API-Integration über EvoLink: Asynchrone Aufgaben, Callbacks & Modi

Was Sie lernen werden

• Bereitstellung von Seedance 1.5 Pro über die asynchrone Task-API von EvoLink (Erstellen → Status → Ergebnisse).
• Sichere Verwendung von callback_url (nur HTTPS, Retry-Semantik und Fehlerbehandlung).
• Verwendung eines Endpunkts für Text-zu-Video, Bild-zu-Video und First-Last-Frame.
• Verhinderung von Doppelverarbeitung mit Idempotenz-Keys und Retry-Budgets.
• Re-Hosting von Ausgaben, bevor Links ablaufen (24-Stunden-Aufbewahrungsfenster).
• Modellierung der „Kosten pro erfolgreicher Ausgabe“, ohne sich auf instabile Preis-Snapshots zu verlassen.
• Vergleich der Integrationskompromisse gegenüber Veo 3.1 und Kling O1 (strukturbasiert, nicht preisbasiert).

Quickstart-Checkliste (zum Kopieren/Einfügen in Ihr Ticket)

• POST /v1/videos/generations zum Erstellen von Aufgaben implementieren
• GET /v1/tasks/{task_id} Polling implementieren
• callback_url-Endpunkt implementieren (2xx schnelle Rückmeldung + asynchrone Verarbeitung)
• Idempotenz-Key pro Benutzerabsicht („Generieren“-Klick) hinzufügen
• Video-Assets innerhalb von 24 Stunden re-hosten
• Instrumentierung: p50/p95-Latenz, Richtlinien-Fehlerrate, Retry-Rate, Versuche pro Erfolg

EvoLink API-Vertrag (Was Sie tatsächlich implementieren)

• Aufgabe erstellen → task_id erhalten
• Entweder GET /v1/tasks/{task_id} abfragen oder einen Callback an die callback_url erhalten
• Nach Abschluss die Ergebnis-URLs (results) abrufen und sofort herunterladen (Links laufen ab)

Endpunkt-Übersicht

• POST https://api.evolink.ai/v1/videos/generations

• GET https://api.evolink.ai/v1/tasks/{task_id}

• Ergebnis-Links sind 24 Stunden lang gültig. Re-hosten Sie diese umgehend.

Ein Endpunkt, drei Modi (Modus-Erkennung über image_urls)

• 0 Bilder → Text-zu-Video
• 1 Bild → Bild-zu-Video
• 2 Bilder → First-Last-Frame (Leitfaden durch ersten und letzten Frame)

• Max. 2 Bilder pro Anfrage
• Jedes Bild ≤ 10MB
• Formate: jpg/jpeg/png/webp
• URLs müssen für den Server direkt zugänglich sein

Produktionsrelevante Anfragefelder

Dies sind die Parameter, die Sie tatsächlich operationalisieren werden:

• model: Nutzen Sie "seedance-1.5-pro"
• prompt (erforderlich): bis zu 2000 Token
• duration: Standard 5s; unterstützt werden 4–12s

  Operativer Hinweis: Die Abrechnung skaliert mit der Dauer; behandeln Sie die Dauer als primären Kostenhebel.

• quality: 480p oder 720p (Standard 720p)
• aspect_ratio: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive (Standard 16:9)
• generate_audio: Boolean (Standard true)

  Tipp: Setzen Sie Dialoge in doppelte Anführungszeichen, um die Sprachausgabe zu verbessern.

• callback_url: HTTPS-exklusive Callback-URL für abgeschlossene/fehlgeschlagene/abgebrochene Aufgaben (empfohlen)

Parameter-Standards nach Szenario (schnelle Entscheidungen)

Aufgaben-Lebenszyklus: Designen Sie zuerst Ihre State-Machine

Eine zuverlässige Integration beginnt mit einer vorhersehbaren internen State-Machine:

created → queued/processing → succeeded → (Download → Re-Hosting → Ausgeliefert)
                     └──────→ failed (Richtlinie | Temporär | Intern)
                     └──────→ cancelled

Minimalbeispiele (EvoLink)

1) Aufgabe erstellen (cURL) — bereit zum Kopieren/Einfügen

Dieses Beispiel vermeidet Shell-Escaping-Probleme durch die Verwendung eines einfachen Prompts ohne einfache Anführungszeichen.

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <Ihr_Token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-1.5-pro",
    "prompt": "A detective in the rain says: \"Do not move.\" Neon reflections on the street. Subtle footsteps and radio static.",
    "duration": 8,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "callback_url": "https://ihre-domain.com/webhooks/evolink-task"
  }'

Die API antwortet sofort mit einem Aufgabenobjekt, das mindestens Folgendes enthält:

• id (Aufgaben-ID)
• status
• usage-Felder (z. B. billing_rule, credits_reserved)

2) Aufgabenstatus abfragen (cURL)

curl --request GET \
  --url https://api.evolink.ai/v1/tasks/<task_id> \
  --header 'Authorization: Bearer <Ihr_Token>'

Nach Abschluss enthält die Aufgabe:

• results-Array mit Ergebnis-URLs
• status und progress (Fortschritt)

callback_url: Zuverlässigkeitsregeln (nicht überspringen)

• Nur HTTPS
• Interne/private Netzwerk-IPs werden blockiert
• Timeout: 10 Sekunden
• Max. 3 Versuche mit Backoff nach 1 / 2 / 4 Sekunden
• Callback-Body entspricht dem Format der Aufgabenabfrage

Produktions-Checkliste für Callbacks (Kopieren/Einfügen)

• Antwort mit 2xx innerhalb von 200ms–500ms (Aufgabe in Warteschlange stellen; keine schwere Arbeit inline erledigen)
• Validieren, dass die task_id existiert und zu Ihrem Mandanten/Benutzer gehört
• Vor der Status-Finalisierung sofort GET /v1/tasks/{task_id} abfragen
• Callbacks deduplizieren (task_id + Endstatus speichern; Wiederholungen ignorieren)
• Roh-Callback-Payload für Debugging protokollieren (Geheimnisse schwärzen)
• Alarmierung bei steigender Callback-Fehlerrate (deutet meist auf Probleme bei Ihrem Endpunkt hin)

Idempotenz: Doppelverarbeitung (und doppelte Kosten) verhindern

Selbst wenn Ihr Anbieter korrekt arbeitet, kann Ihr System Duplikate erstellen, da:

• Benutzer doppelt auf „Generieren“ klicken
• Mobilfunknetze Anfragen wiederholen
• Gateways Timeouts verursachen

• Client generiert einen idempotency_key pro Benutzerabsicht (ein Klick = ein Key)
• Server speichert (user_id, idempotency_key) → task_id mit einer TTL
• Bei Wiederholungen die gleiche task_id zurückgeben, anstatt eine neue Aufgabe zu erstellen

Gehen Sie nicht davon aus, dass Idempotenz „automatisch“ erledigt wird, sofern die API dies nicht explizit dokumentiert. Implementieren Sie diese auf Anwendungsebene.

Asset-Auslieferung: Die 24-Stunden-Falle

Da Ergebnis-Links nach 24 Stunden ablaufen, sollte Ihre Pipeline:

• Das Ergebnis sofort herunterladen, wenn status=completed erreicht ist
• Das Asset in Ihrem eigenen Objektspeicher (S3/GCS/R2) re-hosten
• Die Auslieferung über ein CDN vornehmen
• Metadaten speichern: task_id, Prompt-Hash, Benutzer-ID, Dauer, Qualität, Audio-Flag, Moderationsergebnis

Verhindern Sie dies durch automatisches Re-Hosting bei Abschluss.

Kostenmodellierung ohne Preis-Snapshots

Auch wenn Sie keine konkreten Preisangaben veröffentlichen, benötigen Sie ein stabiles Wirtschaftlichkeitsmodell pro Einheit.

1) Kennen Sie die Abrechnungskriterien der Plattform

Operativ werden Ihre Ausgaben gesteuert durch:

• duration (längerer Clip → teurer)
• generate_audio (Audio verursacht zusätzliche Kosten)
• Iteration (Benutzer liegen selten beim ersten Versuch richtig)

2) Budgetieren Sie „Kosten pro erfolgreicher Ausgabe“, nicht „Kosten pro Versuch“

Verfolgen Sie:

• attempts_per_success (Versuche pro Erfolg, nach Szenario)
• retry_rate
• policy_failure_rate
• p95_latency

Ihre reale Basiseinheit ist:

Erfolgreiche Ausgaben pro Sitzung × durchschnittlich benötigte Versuche

3) Entwurf → Genehmigung → Finale (Zuverlässigste Sparstrategie)

Bei hoher Iterationsrate:

• Erstellen Sie Entwürfe mit günstigeren Einstellungen (z. B. geringere Qualität/kürzere Dauer)
• Finalisierung mit Seedance 1.5 Pro (inkl. Audio) erst nach Benutzerfreigabe

Produktionsfehler & Lösungen

1) Die asynchrone Falle (Timeouts + Zombie-Jobs)

• „Job-TTL“ und einen UI-Status „Verarbeitung läuft“ festlegen
• p95-Abschlusszeit verfolgen; bei Spitzenwerten das Nutzererlebnis kontrolliert anpassen

2) Moderationsergebnisse können verzögert eintreffen

Designen Sie UI/Backend-Status für „Fehlgeschlagen nach Verarbeitung“.

• Unterscheidung: Richtlinie vs. Temporär vs. Intern
• Reintents bei Richtlinien-Verstößen niemals automatisieren
• Hilfestellung zur Prompt-Umformulierung bieten (besonders bei sensiblen Inhalten)

Vergleich: Seedance 1.5 Pro vs. Veo 3.1 vs. Kling O1

Zahlen veralten schnell. Vergleichen Sie, was Bestand hat: Integrationsstruktur und Workflow-Eignung.

Tabelle A — Integration & Abrechnungsstruktur

Tabelle B — Entscheidungsmatrix für die Produktion

Entscheidungshilfe (Schnelles Ja/Nein)

• Sie natives Audio benötigen und Dialoge in Anführungszeichen strukturieren können.
• Sie Text-zu-Video + Bild-zu-Video + First-Last-Frame unter einem Vertrag benötigen.
• Sie Assets innerhalb von 24 Stunden re-hosten können.

• Sie Dauer-basiertes Budgeting und einen stabilen Cloud-Ökosystem-Workflow bevorzugen.

• Editing/Restyling im Vordergrund steht und Sie stabilen Zugriff sichergestellt haben.

FAQ

Q: Wie wechsle ich bei EvoLink zwischen Text-zu-Video und Bild-zu-Video?

Q: Webhook oder Polling — was ist sicherer?

Q: Warum muss ich das Ergebnis re-hosten?

Links laufen nach 24 Stunden ab. Laden Sie Ausgaben umgehend herunter und speichern Sie diese.

Q: Wie vermeide ich doppelte Aufgaben bei Benutzer-Reintents?

Starten Sie heute mit Seedance 1.5 Pro

Sie kennen den Vertrag. Sie verstehen die Kompromisse. Machen Sie daraus jetzt ein produktives Feature.

• Ein API-Key für Seedance 1.5 Pro, Veo 3.1, Kling und andere Modelle.
• Asynchrone Aufgaben + Callbacks mit definierter Retry-Semantik.
• Nutzungsbasierte Abrechnung mit transparenten Credits ohne Mindestumsatz.

Die meisten Teams schließen die Integration in weniger als einer Stunde ab.