curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-o3-video-edit",
  "prompt": "Adjust the color to warm tones and add a cinematic feel",
  "video_url": "https://example.com/original.mp4",
  "quality": "720p",
  "keep_original_sound": true
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-o3-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_call",
    "credits_reserved": 7,
    "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-o3-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-O3

Kling-O3 Videobearbeitung

Kling-O3 Video Edit (kling-o3-video-edit) bearbeitet und modifiziert das Originalvideo, basierend auf dem Kling AI kling-v3-omni Modell
Ausgabevideodauer und Seitenverhältnis bleiben konsistent mit dem Eingabevideo
Unterstützt Bearbeitung mit Textanweisungen, Referenzbildern und Elementen
Soundgenerierung wird nicht unterstützt, wenn ein Video bereitgestellt wird (Sound wird erzwungen deaktiviert)
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-o3-video-edit",
  "prompt": "Adjust the color to warm tones and add a cinematic feel",
  "video_url": "https://example.com/original.mp4",
  "quality": "720p",
  "keep_original_sound": true
}
'

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

erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:

kling-o3-video-edit

Beispiel:

"kling-o3-video-edit"

prompt

string

Bearbeitungsanweisung, maximal 2500 Zeichen

Referenzsyntax: Sie können Elemente, Bilder und Videos im Prompt mit der <<<xxx>>>-Syntax referenzieren, zum Beispiel: Replace the person in the video with <<<element_1>>>

Maximum string length: 2500

Beispiel:

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

video_url

string<uri>

Video-URL zur Bearbeitung

Anforderungen an das Videoformat:

Format: MP4 / MOV
Größe: <= 200MB
Dauer: >= 3 Sekunden
Abmessungen: Breite und Höhe 720px ~ 2160px
Bildrate: 24fps ~ 60fps

Einschränkungen:

Erstes/letztes Bild wird nicht unterstützt
Referenzbildanzahl + Elementanzahl <= 4 wenn ein Video bereitgestellt wird
Video-Charakterelemente werden nicht unterstützt (nur Mehrfachbild-Elemente werden unterstützt)
Die Video-URL muss vom Server direkt erreichbar sein

Beispiel:

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

keep_original_sound

boolean

Standard:true

Ob der Originalton des Videos beibehalten werden soll

Hinweis:

true: Originalton des Videos beibehalten (Standard)
false: Originalton des Videos nicht beibehalten

Beispiel:

true

image_urls

string<uri>[]

Referenzbild-URL-Array (Stilreferenz)

Einschränkung: Referenzbildanzahl + Elementanzahl <= 4 wenn ein Video bereitgestellt wird

Hinweis:

Bild-URLs müssen vom Server direkt erreichbar sein oder beim Aufruf direkt heruntergeladen werden

Beispiel:

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

quality

enum<string>

Standard:720p

Auflösungsqualität

Optionen:

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

Abrechnung: Basisstückpreis 81.000 UC/Sekunde x Eingabevideodauer (aufgerundet). 1080p-Multiplikator 1,334

Verfügbare Optionen:

720p,

1080p

Beispiel:

"720p"

model_params

object

Erweiterte Parameter

Show child attributes

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

Kling-O3 Referenz zu Video Kling-V3 Text zu Video

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Kling-O3 Videobearbeitung

Autorisierungen

Alle APIs erfordern Bearer-Token-Authentifizierung

Body

Antwort