curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kling-o3-text-to-video",
"prompt": "A cat running on a grassy field under bright sunshine",
"duration": 5,
"aspect_ratio": "16:9",
"quality": "720p"
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "kling-o3-text-to-video",
"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-text-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-O3
Kling-O3 Text zu Video
- Kling-O3 Text to Video (kling-o3-text-to-video) rein textgesteuerte Videogenerierung, basierend auf dem Kling AI kling-v3-omni Modell
- Unterstützt Einzelaufnahme- und Mehrfachaufnahme-Modi, kann Videos mit Soundeffekten generieren
- 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
/
v1
/
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-text-to-video",
"prompt": "A cat running on a grassy field under bright sunshine",
"duration": 5,
"aspect_ratio": "16:9",
"quality": "720p"
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "kling-o3-text-to-video",
"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-text-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
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
Name des Videogenerierungsmodells
Verfügbare Optionen:
kling-o3-text-to-video Beispiel:
"kling-o3-text-to-video"
Text-Prompt, der beschreibt, welches Video generiert werden soll
Hinweis:
- Maximal
2500Zeichen - Kann leer sein wenn
multi_shot=trueundshot_type=customize - Sie können Elemente mit der
<<<element_1>>>-Syntax referenzieren
Maximum string length:
2500Beispiel:
"A cat running on a grassy field under bright sunshine"
Videodauer in Sekunden, Standard ist 5 Sekunden
Hinweis:
- Unterstützt Ganzzahlen von
3bis15 - Die Abrechnung basiert auf dem
duration-Wert, längere Dauer kostet mehr
Erforderlicher Bereich:
3 <= x <= 15Beispiel:
5
Video-Seitenverhältnis
Optionen:
16:9: Querformat-Video9:16: Hochformat-Video1:1: Quadratisches Video
Verfügbare Optionen:
16:9, 9:16, 1:1 Beispiel:
"16:9"
Auflösungsqualität
Optionen:
720p: Standard 720P1080p: Hohe Qualität 1080P4k: Ultrahohe Auflösung 4K
Verfügbare Optionen:
720p, 1080p, 4k Beispiel:
"720p"
Soundeffekt-Steuerung
Optionen:
on: Soundeffekte aktivierenoff: Soundeffekte deaktivieren
Verfügbare Optionen:
on, off Beispiel:
"off"
Modellerweiterungsparameter
Einschränkung: Maximal 7 Elemente
Show child attributes
Show child attributes
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
2048Zeichen nicht überschreiten
Callback-Mechanismus:
- Timeout:
10Sekunden - Maximal
3Wiederholungsversuche nach Fehler (nach1/2/4Sekunden 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
Zeitstempel der Aufgabenerstellung
Beispiel:
1757169743
Aufgaben-ID
Beispiel:
"task-unified-1757169743-7cvnl5zw"
Tatsächlich verwendeter Modellname
Beispiel:
"kling-o3-text-to-video"
Aufgabentyp
Verfügbare Optionen:
video.generation.task Aufgabenfortschritt in Prozent (0-100)
Erforderlicher Bereich:
0 <= x <= 100Beispiel:
0
Aufgabenstatus
Verfügbare Optionen:
pending, processing, completed, failed Beispiel:
"pending"
Details zur Videoaufgabe
Show child attributes
Show child attributes
Aufgaben-Ausgabetyp
Verfügbare Optionen:
text, image, audio, video Beispiel:
"video"
Nutzungs- und Abrechnungsinformationen
Show child attributes
Show child attributes