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-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,
  "content_filter": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-reference-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "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-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 Reference-to-Video

Eingabe von Referenzbildern (0-30) + Referenzvideos (0-10) + Referenzaudio (0-10) + 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 Umschreiben oder Fortsetzen eines vorhandenen Videos bitte Video Edit / Video Extend verwenden: Sobald der Prompt dieses Modells eine Bearbeitungs- oder Verlängerungsabsicht enthält, werden die Parameter als Bearbeitungs- / Verlängerungsaufgabe geprüft — die Anfrage wird ohne Fehler angenommen und die Aufgabe schlägt erst während der Generierung fehl
Unterstützt jetzt AIGC-Real-Person-Materialien
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-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,
  "content_filter": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-reference-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "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-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-reference-to-video

erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:

seedance-2.5-reference-to-video

Beispiel:

"seedance-2.5-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
Sobald die Aufgabe so eingestuft wird, muss aspect_ratio den Wert adaptive haben und bei der Videobearbeitung duration den Wert -1; andernfalls wird die Anfrage ohne Fehler angenommen und die Aufgabe endet später mit failed (Fehlercode InvalidParameter.TaskTypeConstraint). Das vorab reservierte Guthaben wird erstattet, die Wartezeit ist jedoch verloren
Wenn Sie tatsächlich bearbeiten oder verlängern möchten, verwenden Sie direkt seedance-2.5-video-edit bzw. seedance-2.5-video-extend: Die Parameter werden beim Absenden geprüft, ungültige Werte führen sofort zu einem synchronen Fehler
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-30 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 - 30 elements

Beispiel:

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

video_urls

string<uri>[]

Referenzvideo-URL-Array, optional; bei Angabe 1-10 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, zu bearbeitendes/verlängerndes Originalvideo

Videoanforderungen:

Unterstützte Formate: .mp4, .mov
Auflösung: 480p, 720p, 1080p, 4K
Einzelvideodauer: 2 ~ 30 Sekunden, maximal 10 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 - 10 elements

Beispiel:

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

audio_urls

string<uri>[]

Referenzaudio-URL-Array, optional; bei Angabe 1-10 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 10 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 - 10 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
-1: automatische Dauer, das Modell wählt eine Länge zwischen 4–30 Sekunden, abgerechnet wird nach der tatsächlichen Ausgabelänge
Die Dauer wirkt sich direkt auf die Abrechnung aus

Wird der Prompt als Videobearbeitungsaufgabe eingestuft, ist nur -1 zulässig; eine konkrete Sekundenangabe lässt die Aufgabe später fehlschlagen, ohne Fehler beim Absenden

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
1080p: Ultra-HD-Auflösung

Verfügbare Optionen:

480p,

720p,

1080p

Beispiel:

"720p"

aspect_ratio

enum<string>

Standard:adaptive

Video-Seitenverhältnis, Standard ist adaptive

Verfügbare Werte:

16:9 (Querformat), 9:16 (Hochformat), 1:1 (Quadrat), 4:3, 3:4, 21:9 (Ultraweitbild)
adaptive: Basiert auf der Prompt-Intention, Priorität: Video > Bild > Prompt

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

Wird der Prompt als Bearbeitungs- / Verlängerungsaufgabe eingestuft, ist nur adaptive zulässig; ein festes Seitenverhältnis lässt die Aufgabe später fehlschlagen, ohne Fehler beim Absenden

Verfügbare Optionen:

16:9,

9:16,

1:1,

4:3,

3:4,

21:9,

adaptive

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

content_filter

boolean

Standard:true

Inhaltsfilter, Standard ist true

Verfügbare Werte:

true: Standardmäßige Inhaltssicherheitsprüfung, dies ist der Standard
false: Lockert die Inhaltsbeschränkungen, Abrechnung mit +10% (1.1x). Illegale und verbotene Inhalte werden unabhängig von dieser Einstellung immer durchgesetzt

Nicht mit der Websuche kombinierbar:

content_filter: false und model_params.web_search: true können nicht zusammen verwendet werden; werden beide gesendet, wird ein 400-Parameterfehler zurückgegeben
Behalten Sie content_filter: true (Standard) bei, wenn die Websuche benötigt wird

Beispiel:

true

output_format

enum<string>

Standard:mp4

Ausgabe-Containerformat, Standard ist mp4

Verfügbare Werte:

mp4: H.264-Kodierung mit bester Kompatibilität und standardmäßiger Farbpräzision, dies ist der Standard
mov: H.264 + yuv444p-Chroma-Sampling + PCM-Audio für höhere Farbtreue, empfohlen für Color-Grading-, Keying- und Compositing-Workflows. Die Wiedergabe im Browser wird möglicherweise nicht unterstützt; laden Sie die Datei herunter und spielen Sie sie mit VLC / mpv / ffplay ab. Keine zusätzlichen Kosten

Verfügbare Optionen:

mp4,

mov

Beispiel:

"mp4"

callback_url

string<uri>

HTTPS-Callback-URL nach Aufgabenabschluss

Callback-Zeitpunkte:

Wird ausgelöst bei Aufgabenabschluss (completed), Fehler (failed) oder Abbruch (cancelled)
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-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 Reference-to-Video

Autorisierungen

Body

Antwort