curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-v4-flash-reference-to-video",
  "prompt": "Den Bewegungsstil aus <<<video_1>>> beibehalten und den Hintergrund durch eine Schneelandschaft ersetzen",
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "16:9",
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v4-flash-reference-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 300,
    "video_duration": 5
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 42.84,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "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: kling-v4-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"
  }
}

Kling-4.0-Flash

Kling-4.0-Flash Referenz zu Video

Kling-4.0 Flash Reference to Video (kling-v4-flash-reference-to-video) generiert neue Videos aus Referenzbildern und Referenzvideos
Referenzvideos dienen als Merkmalsreferenz (keine direkte Bearbeitung) und können mit Text und Referenzbildern kombiniert werden
Unterstützt nur 720p mit einer Dauer von 3–20 Sekunden
Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zum Status abfragen
Generierte Videolinks sind 24 Stunden gültig, bitte speichern Sie diese umgehend

Flash oder Kling 4.0: Welche Variante passt?

Flash ist für häufige Videoproduktion und schnelle kreative Iterationen ausgelegt. Der Schwerpunkt liegt auf Generierungsgeschwindigkeit und Kosteneffizienz bei kurzen Videos in 720p. Der folgende Vergleich zeigt den aktuell von der EvoLink API unterstützten Funktionsumfang.

Merkmal	Kling 4.0 Flash	Kling 4.0
Ausgabeauflösung	`720p`	`720p`, `1080p`
Ausgabedauer	`3`–`20` Sekunden	`3`–`30` Sekunden
Referenzbilder	Bis zu `10`	Bis zu `10`
Referenzvideos	Bis zu `5` Clips mit insgesamt höchstens `20` Sekunden	Bis zu `5` Clips mit insgesamt höchstens `30` Sekunden

Für die Gesamtdauer der Referenzvideos und die Ausgabedauer gelten getrennte Grenzen. Eine kürzere Ausgabe erhöht die zulässige Eingabedauer nicht. Für längere Referenzvideos, 1080p oder eine Ausgabe mit mehr als 20 Sekunden verwenden Sie Kling 4.0 Referenz zu Video.

Flash verwendet eigene Modell-IDs. Prüfen Sie bei der Umstellung model, quality und duration. Die tatsächlichen Kosten richten sich nach dem aktuellen Preis des gewählten Flash-Modells und der endgültigen Aufgabenabrechnung.

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": "kling-v4-flash-reference-to-video",
  "prompt": "Den Bewegungsstil aus <<<video_1>>> beibehalten und den Hintergrund durch eine Schneelandschaft ersetzen",
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "16:9",
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v4-flash-reference-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 300,
    "video_duration": 5
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 42.84,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "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: kling-v4-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 APIs erfordern Bearer-Token-Authentifizierung

API-Schlüssel erhalten:

Besuchen Sie die API-Schlüssel-Verwaltungsseite, um Ihren API-Schlüssel zu erhalten

Zum Anfrage-Header hinzufügen:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

Standard:kling-v4-flash-reference-to-video

erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:

kling-v4-flash-reference-to-video

Beispiel:

"kling-v4-flash-reference-to-video"

prompt

string

erforderlich

Text-Prompt mit maximal 2500 Zeichen

Referenzsyntax: Bilder und Videos können im Prompt mit <<<xxx>>> referenziert werden, zum Beispiel: Die Person aus <<<image_1>>> geht mit der Kameraführung aus <<<video_1>>> die Straße entlang

Maximum string length: 2500

Beispiel:

"Die Person aus <<<image_1>>> geht mit der Kameraführung aus <<<video_1>>> die Straße entlang"

video_urls

string<uri>[]

Array von Referenzvideo-URLs, maximal 5 Clips, die der Reihe nach <<<video_1>>>, <<<video_2>>> usw. im Prompt entsprechen

Videoanforderungen:

Formate: MP4 / MOV
Größe: ≤ 200MB pro Clip
Dauer: ≥ 3 Sekunden pro Clip, insgesamt ≤ 20 Sekunden
Abmessungen: Breite und Höhe jeweils 720px bis 2160px
Bildrate: 24fps bis 60fps
Die Video-URLs müssen vom Server direkt erreichbar sein

Maximum array length: 5

Beispiel:

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

image_urls

string<uri>[]

Array von Referenzbild-URLs (Stil-, Szenen- oder Motivvorlagen), die der Reihe nach <<<image_1>>>, <<<image_2>>> usw. im Prompt entsprechen

Beschränkung: Maximal 10 Bilder Hinweis: Die Bild-URLs müssen vom Server direkt erreichbar sein oder beim Aufruf einen direkten Download auslösen

Maximum array length: 10

Beispiel:

["https://example.com/character.jpg"]

duration

integer

Standard:5

Videodauer in Sekunden. Standardwert: 5 Sekunden

Bereich:

Ganze Zahl von 3 bis 20

Erforderlicher Bereich: 3 <= x <= 20

Beispiel:

5

aspect_ratio

enum<string>

Standard:16:9

Video-Seitenverhältnis

Optionen:

16:9: Querformat
9:16: Hochformat
1:1: Quadratisch
21:9: Ultrabreitformat

Verfügbare Optionen:

16:9,

9:16,

1:1,

21:9

Beispiel:

"16:9"

quality

enum<string>

Standard:720p

Auflösungsstufe

Optionen:

Nur 720p wird unterstützt

Verfügbare Optionen:

720p

Beispiel:

"720p"

callback_url

string<uri>

HTTPS-Callback-URL für Aufgabenabschluss

Callback-Zeitpunkt:

Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen oder abgebrochen wurde
Wird nach Abrechnungsbestätigung gesendet

Sicherheitsbeschränkungen:

Nur HTTPS-Protokoll
Interne IP-Adressen sind verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
URL-Länge darf 2048 Zeichen nicht überschreiten

Callback-Mechanismus:

Timeout: 10 Sekunden
Maximal 3 Wiederholungsversuche nach Fehler (nach 1/2/4 Sekunden nach Fehler)
Callback-Antwortformat ist konsistent mit der Aufgabenabfrage-API
2xx-Statuscode gilt als erfolgreich, andere Codes lösen Wiederholung aus

Beispiel:

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

Antwort

Videogenerierungsaufgabe erfolgreich erstellt

created

integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1757169743

string

Aufgaben-ID

Beispiel:

"task-unified-1757169743-7cvnl5zw"

model

string

Tatsächlich verwendeter Modellname

Beispiel:

"kling-v4-flash-reference-to-video"

object

enum<string>

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

Details zur Videoaufgabe

Show child attributes

type

enum<string>

Aufgaben-Ausgabetyp

Verfügbare Optionen:

text,

image,

audio,

video

Beispiel:

"video"

usage

object

Nutzungs- und Abrechnungsinformationen

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Kling-4.0-Flash Referenz zu Video

Flash oder Kling 4.0: Welche Variante passt?

Autorisierungen

Alle APIs erfordern Bearer-Token-Authentifizierung

Body

Antwort