curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-v4-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-video-edit",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 300,
    "video_duration": 9
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 63.92,
    "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-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

Kling-4.0 Videobearbeitung

Kling-4.0 Video Edit (kling-v4-video-edit) bearbeitet ein vorhandenes Video
Das Ausgabevideo behält das ursprüngliche Seitenverhältnis und den Originalton bei. Die Dauer entspricht standardmäßig dem Originalvideo oder kann mit duration festgelegt werden
Textanweisungen und Referenzbilder können für die Bearbeitung kombiniert werden
Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zum Status abfragen
Generierte Videolinks sind 24 Stunden gültig, bitte speichern Sie diese umgehend

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-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-video-edit",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 300,
    "video_duration": 9
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 63.92,
    "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-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-video-edit

erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:

kling-v4-video-edit

Beispiel:

"kling-v4-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 30 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 30 Sekunden
auto: Dauer des Originalvideos übernehmen

Erforderlicher Bereich: 3 <= x <= 30

Beispiel:

"auto"

quality

enum<string>

Standard:720p

Auflösungsstufe

Optionen:

720p: Standard 720P
1080p: Hohe Qualität 1080P

Verfügbare Optionen:

720p,

1080p

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-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 Videobearbeitung

Autorisierungen

Alle APIs erfordern Bearer-Token-Authentifizierung

Body

Antwort