Έγγραφα Rivya AI
Σελίδες API μοντέλων

Kling V2.5 Turbo Pro API integration

Χρησιμοποιήστε το Kling V2.5 Turbo Pro μέσω Rivya Public API v1 με model id kling-v2-5-turbo-pro, υποστηριζόμενα inputs, παραμέτρους, κανόνες Files API, credits και παραδείγματα response.

Διαθέσιμο μέσω APIText ή URL ready. Τα reference modes χρησιμοποιούν Files APIΒίντεο
ID μοντέλου API

kling-v2-5-turbo-pro

Inputs

text, file

Files API

Απαιτείται για reference modes

Βασικές πιστώσεις

42

Δυνατότητα

Βίντεο

Χρέωση

FIXED

Όριο prompt

2500 χαρακτήρες

Σύμβαση αιτήματος

Στείλτε το model id στο top level. Τα model-specific controls ανήκουν στο params.

KeyΤύποςΥποχρεωτικόΠροεπιλογήΠεριγραφή
modelstringΝαιkling-v2-5-turbo-proΧρησιμοποιήστε το kling-v2-5-turbo-pro ως API model id.
promptstringΝαι-Μέγιστο 2500 χαρακτήρες για αυτό το μοντέλο.
paramsobjectΌχι-Model-specific parameter object. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα keys.
client_request_idstringΌχι-Προαιρετικό client-side id για tracing requests στο δικό σας σύστημα.

Παράμετροι μοντέλου

KeyΤύποςΥποχρεωτικόΠροεπιλογήΕύροςΕπιλογέςΠεριγραφή
durationselectΌχι5-5, 10Διάρκεια
aspect_ratioselectΌχι16:9-16:9, 9:16, 1:1Λόγος διαστάσεων
negative_prompttextΌχι---Αρνητική προτροπή
cfg_scalenumberΌχι0.5min 0 / max 1-Ελέγχει πόσο στενά ακολουθεί το αποτέλεσμα την προτροπή σας. Οι υψηλότερες τιμές συνήθως μένουν πιο κοντά στην προτροπή, αλλά μπορούν επίσης να κάνουν την κίνηση ή τη σύνθεση να μοιάζει πιο άκαμπτη.

Πολιτική μεταφόρτωσης

Ανεβάστε πρώτα reference files και μετά τοποθετήστε το returned URL και το duration token μέσα στο params.referenceMediaItems.

Κανόνας αναφοράς

Εικόνες αναφοράς: Προαιρετικά ανεβάστε έως 2 εικόνες για να περάσετε σε λειτουργία εικόνας σε βίντεο· η δεύτερη εικόνα αντιστοιχίζεται στο τελικό καρέ.

Max files

2

Αποδεκτοί τύποι αρχείων

image

Token διάρκειας

Τα video και audio references πρέπει να μεταφέρουν durationToken από /api/v1/files όταν απαιτείται duration verification.

kindMax sizeMIME types
image10 MBimage/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"
      }
    ]
  }
}

Απόκριση δημιουργίας

Το create endpoint επιστρέφει public task id. Κάντε poll στο status endpoint μέχρι το task να succeed ή fail.

{
  "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

Ορισμένα modes απαιτούν reference uploads μέσω Files API.