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-video-edit",
  "prompt": "Adjust the color to warm tones and add a cinematic feel",
  "video_urls": [
    "https://example.com/original.mp4"
  ],
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v4-flash-video-edit",
  "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-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"
  }
}

Kling-4.0-Flash

Kling-4.0-Flash Videobearbeitung

Kling-4.0 Flash Video Edit (kling-v4-flash-video-edit) bearbeitet ein vorhandenes Video
Das Seitenverhältnis des Ausgangsvideos bleibt erhalten. Die Dauer entspricht standardmäßig dem Ausgangsvideo und kann auch über duration festgelegt werden
Textanweisungen und Referenzbilder können für die Bearbeitung kombiniert werden
Unterstützt nur 720p
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
Ausgangsvideo	`1` Clip, `3`–`20` Sekunden	`1` Clip, `3`–`30` Sekunden

Beide Modelle unterstützen duration=auto, um die Dauer des Ausgangsvideos zu übernehmen. Alternativ können Sie eine Ausgabedauer innerhalb der jeweiligen Grenzen festlegen. Bei Flash dürfen weder Eingabe noch Ausgabe länger als 20 Sekunden sein. Für längere Ausgangsvideos oder eine Ausgabe in 1080p verwenden Sie Kling 4.0 Videobearbeitung.

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-video-edit",
  "prompt": "Adjust the color to warm tones and add a cinematic feel",
  "video_urls": [
    "https://example.com/original.mp4"
  ],
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v4-flash-video-edit",
  "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-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 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-video-edit

erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:

kling-v4-flash-video-edit

Beispiel:

"kling-v4-flash-video-edit"

prompt

string

erforderlich

Bearbeitungsanweisungen mit maximal 2500 Zeichen

Referenzsyntax: Bilder und Videos können im Prompt mit <<<xxx>>> referenziert werden, zum Beispiel: Den Mantel der Person in <<<video_1>>> durch den Stil aus <<<image_1>>> ersetzen

Maximum string length: 2500

Beispiel:

"Adjust the color to warm tones and add a cinematic feel"

video_urls

string<uri>[]

erforderlich

Array der zu bearbeitenden Video-URLs. Unterstützt genau 1 Clip, der im Prompt als <<<video_1>>> referenziert wird

Videoanforderungen:

Formate: MP4 / MOV
Größe: ≤ 200MB
Dauer: 3 bis 20 Sekunden
Abmessungen: Breite und Höhe jeweils 720px bis 2160px
Bildrate: 24fps bis 60fps
Die Video-URL muss vom Server direkt erreichbar sein

Required array length: 1 element

Beispiel:

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

image_urls

string<uri>[]

Array von Referenzbild-URLs (Stilvorlagen)

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/style_ref.jpg"]

duration

Standard:auto

Dauer des Ausgabevideos in Sekunden. Standardwert: auto

Werte:

Ganze Zahl: 3 bis 20 Sekunden
auto: Dauer des Originalvideos übernehmen

Erforderlicher Bereich: 3 <= x <= 20

Beispiel:

"auto"

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-video-edit"

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 Videobearbeitung

Flash oder Kling 4.0: Welche Variante passt?

Autorisierungen

Alle APIs erfordern Bearer-Token-Authentifizierung

Body

Antwort