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-reference-to-video",
  "prompt": "Use the first-person perspective framing of @video1 throughout, and use @audio1 as background music throughout. First-person perspective fruit tea promotional video...",
  "image_urls": [
    "https://example.com/ref1.jpg",
    "https://example.com/ref2.jpg"
  ],
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "audio_urls": [
    "https://example.com/bgm.mp3"
  ],
  "duration": 10,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-flash-reference-to-video",
  "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-reference-to-video",
    "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 Reference-to-Video

Eingabe von Referenzbildern (0-10) + Referenzvideos (0-5) + Referenzaudio (0-5) + Textprompt zur Videogenerierung; mindestens ein Bild, Video oder Audio muss angegeben werden
Geeignet für Neuerstellungen: Bilder, Videos und Audio dienen als Referenz für Stil, Motiv, Kameraführung und Musik
Zum Bearbeiten eines vorhandenen Videos bitte Seedance 2.5 Flash Video Edit verwenden: Schreiben Sie keine Bearbeitungs- oder Verlängerungsabsicht in den Prompt dieses Modells (siehe Beschreibung von prompt)
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-reference-to-video",
  "prompt": "Use the first-person perspective framing of @video1 throughout, and use @audio1 as background music throughout. First-person perspective fruit tea promotional video...",
  "image_urls": [
    "https://example.com/ref1.jpg",
    "https://example.com/ref2.jpg"
  ],
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "audio_urls": [
    "https://example.com/bgm.mp3"
  ],
  "duration": 10,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-flash-reference-to-video",
  "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-reference-to-video",
    "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-reference-to-video

erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:

seedance-2.5-flash-reference-to-video

Beispiel:

"seedance-2.5-flash-reference-to-video"

prompt

string

erforderlich

Textprompt zur Beschreibung des gewünschten Videos. Unterstützt Chinesisch und Englisch, empfohlen max. 500 Zeichen auf Chinesisch. Maximale Prompt-Länge: 10000 Tokens

Hinweise:

Verwenden Sie beim Verweisen auf Eingabematerialien im Prompt bevorzugt explizite Tags wie @image1, @video1 und @audio1, statt sich nur auf natürlichsprachliche Bezeichnungen wie „Bild 1“, „Video 1“ oder „Audio 1“ zu verlassen
Die Tag-Nummern entsprechen der Reihenfolge im jeweiligen URL-Array und beginnen bei 1: Der erste Eintrag in image_urls ist @image1, der erste in video_urls ist @video1 und der erste in audio_urls ist @audio1
Natürlichsprachliche Nummerierungen können weiterhin erkannt werden, explizite Tags ordnen Materialien und Verwendungszwecke jedoch eindeutiger zu

Einstufung als Bearbeitungs- / Verlängerungsaufgabe vermeiden:

Der Aufgabentyp wird aus der Prompt-Absicht abgeleitet: Formulierungen wie „Video bearbeiten“, „hinzufügen“, „löschen / entfernen“, „ändern / ersetzen“ gelten als Videobearbeitung; Formulierungen wie „nach vorne / hinten verlängern“ oder „fortsetzen“ gelten als Videoverlängerung
Wird die Aufgabe so eingestuft, wird die Anfrage ohne Fehler angenommen, die Aufgabe kann aber später fehlschlagen. Das vorab reservierte Guthaben wird erstattet, die Wartezeit ist jedoch verloren
Wenn Sie tatsächlich bearbeiten möchten, verwenden Sie direkt seedance-2.5-flash-video-edit
Für reine Referenzgenerierung formulieren Sie Wörter wie „ersetzen“ oder „entfernen“ beschreibend um, z. B. „im Bild erscheint …“ oder „im Stil von @image1 dargestellt“

Beispiel:

"Use the first-person perspective framing of @video1 throughout, and use @audio1 as background music throughout. First-person perspective fruit tea promotional video..."

image_urls

string<uri>[]

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

Pflichtangabe: Mindestens eines von image_urls, video_urls oder audio_urls muss angegeben werden.

Rollenbeschreibung:

Medientyp	Rolle	Typische Verwendung
Bild	`reference_image`	Stilreferenz, Produktbild, Startbild/Endbild (über Prompt festlegen)

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"
]

video_urls

string<uri>[]

Referenzvideo-URL-Array, optional; bei Angabe 1-5 Videos

Pflichtangabe: Mindestens eines von image_urls, video_urls oder audio_urls muss angegeben werden.

Rollenbeschreibung:

Medientyp	Rolle	Typische Verwendung
Video	`reference_video`	Kameraführungsreferenz, Bewegungsreferenz

Videoanforderungen:

Unterstützte Formate: .mp4, .mov
Auflösung: 480p, 720p, 1080p, 4K
Einzelvideodauer: 2 ~ 30 Sekunden, maximal 5 Videos, Gesamtdauer aller Videos ≤ 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
Die Verwendung von Videoreferenzen verursacht zusätzliche Kosten (Eingabevideodauer wird in die Abrechnung einbezogen)
Video-URLs müssen für den Server direkt zugänglich sein

Required array length: 1 - 5 elements

Beispiel:

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

audio_urls

string<uri>[]

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

Pflichtangabe: Mindestens eines von image_urls, video_urls oder audio_urls muss angegeben werden.

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

integer

Standard:5

Ausgabe-Videodauer (Sekunden), Standard ist 5 Sekunden

Hinweise:

Unterstützt beliebige Ganzzahlwerte zwischen 4 und 30 Sekunden
Automatische Dauer (-1) wird nicht unterstützt; die Angabe führt zu einem 400-Parameterfehler
Die Dauer wirkt sich direkt auf die Abrechnung aus

Abrechnungsregeln:

Abrechnung pro Sekunde
Abrechenbare Dauer: ohne Referenzvideos die Ausgabedauer; mit Referenzvideos Ausgabedauer + max(Gesamtdauer der Referenzvideos, Ausgabedauer)
Die Gesamtdauer der Referenzvideos wird auf die nächste volle Sekunde aufgerundet

Erforderlicher Bereich: 4 <= x <= 30

Beispiel:

10

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:16:9

Video-Seitenverhältnis, Standard ist 16:9

Verfügbare Werte:

16:9 (Querformat), 9:16 (Hochformat), 1:1 (Quadrat), 4:3, 3:4, 21:9 (Ultraweitbild)
Automatisches Seitenverhältnis (adaptive) wird nicht unterstützt; die Angabe führt zu einem 400-Parameterfehler

Pixelwerte pro Auflösung:

Seitenverhältnis	480p	720p
16:9	854×480	1280×720
4:3	752×560	1112×834
1:1	640×640	960×960
3:4	560×752	834×1112
9:16	480×854	720×1280
21:9	992×432	1470×630

Verfügbare Optionen:

16:9,

9:16,

1:1,

4:3,

3:4,

21:9

Beispiel:

"16:9"

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: Stummes Video ausgeben

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-reference-to-video"

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 Reference-to-Video

Autorisierungen

Body

Antwort