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-image-to-video",
  "prompt": "The person in the image slowly turns their head and smiles",
  "image_start": "https://example.com/portrait.jpg",
  "duration": 5,
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v4-flash-image-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": 31.96,
    "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-image-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 Bild zu Video

Kling-4.0 Flash Image to Video (kling-v4-flash-image-to-video) generiert Videos aus Bildern
Unterstützt nur das Startbild; Endbilder und Zwischenbilder werden nicht unterstützt
Das Seitenverhältnis wird durch das erste Rahmenbild bestimmt, aspect_ratio wird nicht akzeptiert
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
Bildsteuerung	Nur Startbild: `image_start`	Startbild, optionales Endbild `image_end` und bis zu `8` Zwischenbilder in `keyframes`

Für Übergänge zwischen Start- und Endbild, die Steuerung über Zwischenbilder, 1080p oder Videos mit mehr als 20 Sekunden verwenden Sie Kling 4.0 Bild zu Video. Übergeben Sie bei Flash nur das Startbild, ohne image_end oder keyframes.

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-image-to-video",
  "prompt": "The person in the image slowly turns their head and smiles",
  "image_start": "https://example.com/portrait.jpg",
  "duration": 5,
  "quality": "720p"
}
'

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

erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:

kling-v4-flash-image-to-video

Beispiel:

"kling-v4-flash-image-to-video"

image_start

string<uri>

erforderlich

URL des ersten Rahmenbildes für die Bild-zu-Video-Generierung (erforderlich)

Hinweis:

Bildgröße: bis zu 10MB
Unterstützte Formate: .jpg, .jpeg, .png
Bildabmessungen: Breite und Höhe >= 300px, Seitenverhältnis zwischen 1:2.5 und 2.5:1
Die Bild-URL muss vom Server direkt erreichbar sein oder beim Aufruf direkt heruntergeladen werden

Beispiel:

"https://example.com/portrait.jpg"

prompt

string

erforderlich

Text-Prompt zur Beschreibung des gewünschten Videos

Hinweis:

Maximal 2500 Zeichen

Maximum string length: 2500

Beispiel:

"The person in the image slowly turns their head and smiles"

duration

integer

Standard:5

Videodauer in Sekunden. Standardwert: 5 Sekunden

Bereich:

Ganze Zahl von 3 bis 20

Erforderlicher Bereich: 3 <= x <= 20

Beispiel:

5

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-image-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 Bild zu Video

Flash oder Kling 4.0: Welche Variante passt?

Autorisierungen

Alle APIs erfordern Bearer-Token-Authentifizierung

Body

Antwort