Ενσωμάτωση API για Kling V2.5 Turbo Pro
Χρησιμοποιήστε το Kling V2.5 Turbo Pro μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου kling-v2-5-turbo-pro, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.
kling-v2-5-turbo-pro
text, file
Απαιτείται για λειτουργίες αναφοράς
42
Βίντεο
FIXED
2500 χαρακτήρες
Σύμβαση αιτήματος
Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.
| Κλειδί | Τύπος | Υποχρεωτικό | Προεπιλογή | Περιγραφή |
|---|---|---|---|---|
| model | string | Ναι | kling-v2-5-turbo-pro | Χρησιμοποιήστε το kling-v2-5-turbo-pro ως αναγνωριστικό μοντέλου API. |
| prompt | string | Ναι | - | Μέγιστο 2500 χαρακτήρες για αυτό το μοντέλο. |
| params | object | Όχι | - | Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά. |
| client_request_id | string | Όχι | - | Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα. |
Παράμετροι μοντέλου
| Κλειδί | Τύπος | Υποχρεωτικό | Προεπιλογή | Εύρος | Επιλογές | Περιγραφή |
|---|---|---|---|---|---|---|
| duration | select | Όχι | 5 | - | 5, 10 | Διάρκεια |
| aspect_ratio | select | Όχι | 16:9 | - | 16:9, 9:16, 1:1 | Λόγος διαστάσεων |
| negative_prompt | text | Όχι | - | - | - | Αρνητική προτροπή |
| cfg_scale | number | Όχι | 0.5 | min 0 / max 1 | - | Ελέγχει πόσο στενά ακολουθεί το αποτέλεσμα την προτροπή σας. Οι υψηλότερες τιμές συνήθως μένουν πιο κοντά στην προτροπή, αλλά μπορούν επίσης να κάνουν την κίνηση ή τη σύνθεση να μοιάζει πιο άκαμπτη. |
Πολιτική μεταφόρτωσης
Ανεβάστε πρώτα αρχεία αναφοράς και μετά τοποθετήστε το URL που επιστράφηκε και το duration token μέσα στο params.referenceMediaItems.
Εικόνες αναφοράς: Προαιρετικά ανεβάστε έως 2 εικόνες για να περάσετε σε λειτουργία εικόνας σε βίντεο· η δεύτερη εικόνα αντιστοιχίζεται στο τελικό καρέ.
2
image
Οι αναφορές βίντεο και ήχου πρέπει να μεταφέρουν `durationToken` από το /api/v1/files όταν απαιτείται επαλήθευση διάρκειας.
| kind | Μέγιστο μέγεθος | MIME types |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Ελάχιστο αίτημα
{
"model": "kling-v2-5-turbo-pro",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"duration": "5",
"aspect_ratio": "16:9",
"negative_prompt": "Περιγράψτε τι πρέπει να αποφύγει το βίντεο",
"cfg_scale": 0.5
}
}Αίτημα με αρχείο αναφοράς
{
"model": "kling-v2-5-turbo-pro",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"duration": "5",
"aspect_ratio": "16:9",
"negative_prompt": "Περιγράψτε τι πρέπει να αποφύγει το βίντεο",
"cfg_scale": 0.5,
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Απόκριση δημιουργίας
Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.
{
"id": "task_kling_v2_5_turbo_pro_example",
"status": "queued",
"model": "kling-v2-5-turbo-pro",
"reserved_credits": 42,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Συνηθισμένα σφάλματα
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Ορισμένες λειτουργίες απαιτούν μεταφορτώσεις αναφοράς μέσω Files API.