curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5-flash-video-edit",
  "prompt": "Alle Passanten in @video1 entfernen, nur die Hauptfigur behalten",
  "video_urls": [
    "https://example.com/original.mp4"
  ],
  "quality": "720p",
  "generate_audio": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-flash-video-edit",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: seedance-2.5-flash-video-edit",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Seedance 2.5

Seedance 2.5 Flash Video Edit

Bearbeitung eines Eingabevideos — Motive ersetzen, Objekte hinzufügen/entfernen, Bereiche umgestalten oder neu einfärben
Beschreiben Sie die Änderung direkt im Prompt, z. B. “Alle Passanten in @video1 entfernen, nur die Hauptfigur behalten”
Eingabe von genau 1 zu bearbeitenden Video (erforderlich, 4–30 Sekunden) + optionale Referenzbilder (0–10) + Referenzaudio (0–5); Ausgabelänge und Seitenverhältnis folgen dem Eingabevideo
Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zur Abfrage
Der generierte Video-Link ist 24 Stunden gültig, bitte speichern Sie ihn rechtzeitig

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5-flash-video-edit",
  "prompt": "Alle Passanten in @video1 entfernen, nur die Hauptfigur behalten",
  "video_urls": [
    "https://example.com/original.mp4"
  ],
  "quality": "720p",
  "generate_audio": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-flash-video-edit",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: seedance-2.5-flash-video-edit",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Autorisierungen

Authorization

string

header

erforderlich

##Alle Schnittstellen erfordern eine Authentifizierung mit Bearer Token##

API Key erhalten:

Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API Key zu erhalten

Fügen Sie ihn im Anfrage-Header hinzu:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

Standard:seedance-2.5-flash-video-edit

erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:

seedance-2.5-flash-video-edit

Beispiel:

"seedance-2.5-flash-video-edit"

prompt

string

erforderlich

Text-Prompt zur Beschreibung der gewünschten Bearbeitung. Unterstützt Chinesisch und Englisch, für Chinesisch werden maximal 500 Zeichen empfohlen. Maximale Prompt-Länge: 10000 Tokens

Details:

Beschreiben Sie die gewünschte Änderung direkt, z. B. "Alle Passanten in @video1 entfernen, nur die Hauptfigur behalten"
Der Zweck jedes Materials kann in natürlicher Sprache angegeben werden, z. B. "die Figur in @video1 durch die Person aus @image1 ersetzen"
Das Modell erkennt die Zuordnung zwischen Materialnummern und ihrem Verwendungszweck automatisch

Beispiel:

"Alle Passanten in @video1 entfernen, nur die Hauptfigur behalten"

video_urls

string<uri>[]

erforderlich

Array mit Eingabevideo-URLs, erforderlich; genau 1 Video

Voraussetzung: Genau 1 Video angeben — das zu bearbeitende Video. Ausgabelänge und Seitenverhältnis folgen diesem Video.

Videoanforderungen:

Unterstützte Formate: .mp4, .mov
Auflösung: 480p, 720p, 1080p, 4K
Videodauer: 4 ~ 30 Sekunden
Seitenverhältnis (Breite/Höhe): 0.4 ~ 2.5
Breite/Höhe in Pixel: 300 ~ 6000 px
Bildpixel (Breite × Höhe): 409.600 ~ 8.295.044 (z.B. 640×640 ~ 3326×2494)
Einzelgröße: maximal 200MB
Bildrate: 24 ~ 60 FPS
Gesamtgröße des Anfragekörpers maximal 64MB, verwenden Sie keine Base64-Kodierung
Die Gültigkeit von Codec, Auflösung und weiteren Medieneigenschaften wird zusätzlich vom Modell geprüft
Video-URLs müssen für den Server direkt zugänglich sein

Required array length: 1 element

Beispiel:

["https://example.com/original.mp4"]

image_urls

string<uri>[]

Referenzbild-URL-Array, optional; bei Angabe 1-10 Bilder

Voraussetzung: Für dieses Modell ist video_urls erforderlich; Bilder sind optionale ergänzende Referenzen.

Rollenbeschreibung:

Medientyp	Rolle	Typische Verwendung
Bild	`reference_image`	Stilreferenz, Produktbild, zu ersetzendes Motiv (per Prompt angegeben)

Bildanforderungen:

Unterstützte Formate: .jpeg, .png, .webp
Seitenverhältnis (Breite/Höhe): 0.4 ~ 2.5
Breite/Höhe in Pixel: 300 ~ 6000 px
Einzelbildgröße: maximal 30MB
Gesamtgröße des Anfragekörpers maximal 64MB, verwenden Sie keine Base64-Kodierung
Bild-URLs müssen für den Server direkt zugänglich sein

Required array length: 1 - 10 elements

Beispiel:

[
  "https://example.com/ref1.jpg",
  "https://example.com/ref2.jpg"
]

audio_urls

string<uri>[]

Referenzaudio-URL-Array, optional; bei Angabe 1-5 Audiodateien

Voraussetzung: Für dieses Modell ist video_urls erforderlich; Audio ist eine optionale ergänzende Referenz.

Rollenbeschreibung:

Medientyp	Rolle	Typische Verwendung
Audio	`reference_audio`	Hintergrundmusik, Soundeffekte, Sprach-/Dialogreferenz

Audioanforderungen:

Unterstützte Formate: .wav, .mp3
Einzelaudiodauer: 2 ~ 30 Sekunden, maximal 5 Dateien, Gesamtdauer aller Audiodateien ≤ 30 Sekunden
Einzelgröße: maximal 15MB
Gesamtgröße des Anfragekörpers maximal 64MB, verwenden Sie keine Base64-Kodierung
Audio-URLs müssen für den Server direkt zugänglich sein

Required array length: 1 - 5 elements

Beispiel:

["https://example.com/bgm.mp3"]

duration

enum<integer>

Standard:-1

Ausgabedauer des Videos (Sekunden), Standard ist -1

Details:

Kann weggelassen werden; wenn angegeben, wird nur -1 akzeptiert und die Ausgabelänge folgt dem Eingabevideo
Eigene Dauerangaben werden abgelehnt

Verfügbare Optionen:

-1

Beispiel:

-1

quality

enum<string>

Standard:720p

Videoauflösung, Standard ist 720p

Verfügbare Werte:

480p: Niedrigere Auflösung, günstigerer Preis
720p: Standardauflösung, dies ist der Standardwert

Verfügbare Optionen:

480p,

720p

Beispiel:

"720p"

aspect_ratio

enum<string>

Standard:adaptive

Video-Seitenverhältnis, Standard ist adaptive

Verfügbare Werte:

adaptive: Das Ausgabeverhältnis folgt dem Eingabevideo; das Feld kann auch weggelassen werden
Feste Seitenverhältnisse wie 16:9 oder 9:16 werden abgelehnt

Verfügbare Optionen:

adaptive

Beispiel:

"adaptive"

generate_audio

boolean

Standard:true

Ob synchronisiertes Audio generiert werden soll, Standard ist true

Verfügbare Werte:

true: Video enthält synchronisiertes Audio, keine zusätzlichen Kosten
false: Es wird kein neues Audio generiert

Beispiel:

true

callback_url

string<uri>

HTTPS-Callback-URL nach Aufgabenabschluss

Callback-Zeitpunkte:

Wird bei Aufgabenabschluss (completed) oder Fehler (failed) ausgelöst
Wird nach Bestätigung der Abrechnung gesendet

Sicherheitseinschränkungen:

Nur HTTPS-Protokoll unterstützt
Callbacks an interne IP-Adressen sind verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x usw.)
URL-Länge maximal 2048 Zeichen

Callback-Mechanismus:

Timeout: 10 Sekunden
Maximal 3 Wiederholungsversuche nach Fehler (jeweils nach 1/2/4 Sekunden)
Das Format des Callback-Antwortkörpers entspricht dem Rückgabeformat der Aufgabenabfrage-Schnittstelle
Ein 2xx-Statuscode gilt als Erfolg, andere Statuscodes lösen Wiederholungsversuche aus

Beispiel:

"https://your-domain.com/webhooks/video-task-completed"

Antwort

Videogenerierungsaufgabe erfolgreich erstellt

created

integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1761313744

string

Aufgaben-ID

Beispiel:

"task-unified-1774857405-abc123"

model

string

Tatsächlich verwendeter Modellname

Beispiel:

"seedance-2.5-flash-video-edit"

object

enum<string>

Spezifischer Aufgabentyp

Verfügbare Optionen:

video.generation.task

progress

integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100

Beispiel:

0

status

enum<string>

Aufgabenstatus

Verfügbare Optionen:

pending,

processing,

completed,

failed

Beispiel:

"pending"

task_info

object

Detaillierte Informationen zur Videoaufgabe

Show child attributes

type

enum<string>

Ausgabetyp der Aufgabe

Verfügbare Optionen:

text,

image,

audio,

video

Beispiel:

"video"

usage

object

Nutzungs- und Abrechnungsinformationen

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Seedance 2.5 Flash Video Edit

Autorisierungen

Body

Antwort