Χρησιμοποιήστε το Kling 3.0 motion-control μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου kling-3-0-motion-control, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

Διαθέσιμο μέσω APIΕτοιμότηταΒίντεο

ID μοντέλου API

kling-3-0-motion-control

Είσοδοι

file

Files API

Απαιτείται για λειτουργίες αναφοράς

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

per_output_second · 720p=20 · 1080p=27 · ⌈total⌉

Δυνατότητα

Βίντεο

Χρέωση

METERED

Όριο prompt

2500 χαρακτήρες

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

Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Περιγραφή
model	string	Ναι	kling-3-0-motion-control	Χρησιμοποιήστε το kling-3-0-motion-control ως αναγνωριστικό μοντέλου API.
prompt	string	Ναι	-	Μέγιστο 2500 χαρακτήρες για αυτό το μοντέλο.
params	object	Όχι	-	Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά.
client_request_id	string	Όχι	-	Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα.

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

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Εύρος	Επιλογές	Περιγραφή
mode	select	Όχι	720p	-	720p, 1080p	Λειτουργία δημιουργίας
character_orientation	select	Όχι	video	-	video, image	Ελέγχει αν ο προσανατολισμός του χαρακτήρα πρέπει να μείνει πιο κοντά στο βίντεο κίνησης ή στην εικόνα αναφοράς.

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

Ανεβάστε πρώτα αρχεία αναφοράς και μετά τοποθετήστε το URL που επιστράφηκε και το duration token μέσα στο params.referenceMediaItems.

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

Εικόνα αναφοράς + βίντεο κίνησης: Ακριβές έργο 1 εικόνας + 1 βίντεο κίνησης, ώστε να είναι καθαρό ποιος ρόλος κρατά την ταυτότητα και ποιος την κίνηση Standard (720P): 20 × επαληθευμένα δευτερόλεπτα βίντεο κίνησης· Pro (1080P): 27 × δευτερόλεπτα

Μέγιστος αριθμός αρχείων

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

image, video

Token διάρκειας

Οι αναφορές βίντεο και ήχου πρέπει να μεταφέρουν `durationToken` από το /api/v1/files όταν απαιτείται επαλήθευση διάρκειας.

kind	Μέγιστο μέγεθος	MIME types
image	10 MB	image/jpeg, image/png
video	95 MB	video/mp4, video/quicktime

Ελάχιστο αίτημα

{
  "model": "kling-3-0-motion-control",
  "params": {
    "mode": "720p",
    "character_orientation": "video"
  }
}

Αίτημα με αρχείο αναφοράς

{
  "model": "kling-3-0-motion-control",
  "params": {
    "mode": "720p",
    "character_orientation": "video",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.

{
  "id": "task_kling_3_0_motion_control_example",
  "status": "queued",
  "model": "kling-3-0-motion-control",
  "reserved_credits": 27,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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.

Ενσωμάτωση API για Kling 3.0 motion-control