Μετάβαση στο περιεχόμενο

Έγγραφα Kling Motion Control API

Έγγραφα Kling Motion Control API για ροές εργασίας εικόνας και βίντεο κίνησης

Αναφορά ελέγχου κίνησης Kling

Έγγραφα Kling Motion Control API για ροές εργασίας εικόνας και βίντεο κίνησης

Χρησιμοποιήστε αυτόν τον οδηγό για ενσωμάτωση Kling 2.6 Έλεγχος κίνησης μέσω του UlazAI API. Οι τρέχουσες χρήσεις ολοκλήρωσης model_slug="kling_3_0_motion_control" επάνω /api/v1/video-studio/generate/ή τη διαδρομή συμβατότητας /api/v1/generate/video/ με video_model="kling_3_0_motion_control". Στέλνεις ακριβώς μια διεύθυνση URL εικόνας, ένα URL βίντεο κίνησης, ένα prompt και μια λειτουργία ποιότητας 720p ή 1080p.

Βασικά τελικά σημεία

/api/v1/video-studio/generate/

/api/v1/video-studio/status/{job_id}/

/api/v1/generate/video/

Τρέχουσα υποστήριξη

1 διεύθυνση URL εικόνας + 1 διεύθυνση URL βίντεο κίνησης

Έξοδος 720p ή 1080p

3 έως 15 δευτερόλεπτα

Σημείωση διαδρομής: το δημόσιο URL εξακολουθεί να λέει kling-2-6-motion-control-api-docs, αλλά το τρέχον μοντέλο γυμνοσάλιαγκας για ζωντανές ενσωματώσεις είναι kling_3_0_motion_control.
Χρησιμοποιήστε το τελικό σημείο συμβατότητας μόνο εάν αποστέλλετε ήδη το βίντεο με έλεγχο ταυτότητας παλαιού τύπου API.

Έλεγχος ταυτότητας

Στείλτε ένα διακριτικό φορέα ή κλειδί API σε κάθε αίτημα.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Κανονικό αίτημα

Αυτό το αίτημα απευθύνεται σε /api/v1/video-studio/generate/. Είναι το προτιμώμενο συμβόλαιο API για νέες ενσωματώσεις.

{
  "model_slug": "kling_3_0_motion_control",
  "prompt": "No distortion, the character's movements are consistent with the video.",
  "input_image_urls": ["https://example.com/character.png"],
  "input_video_urls": ["https://example.com/motion.mp4"],
  "character_orientation": "video",
  "quality_mode": "720p",
  "duration_seconds": 15
}

Αναφορά πεδίου

Πεδίο Απαιτείται Σημειώσεις
model_slug Ναι Πρέπει να είναι kling_3_0_motion_control
prompt Ναι Μέγιστο 2500 χαρακτήρες
input_image_urls Ναι Ακριβώς ένα URL δημόσιας εικόνας
input_video_urls Ναι Ακριβώς ένα URL δημόσιου βίντεο κίνησης
character_orientation Όχι Χρήση video για να ακολουθήσετε τον προσανατολισμό του κλιπ κίνησης ή image για να διατηρήσετε το καδράρισμα των μεταφορτωμένων χαρακτήρων
quality_mode Ναι Χρήση 720p ή 1080p
duration_seconds Ναι Ακέραιος από 3 έως 15. Η τιμολόγηση χρησιμοποιεί αυτή τη διάρκεια.

Αίτημα συμβατότητας παλαιού τύπου

Αυτό το αίτημα απευθύνεται σε /api/v1/generate/video/. Χρησιμοποιήστε το εάν έχετε ήδη ενσωματωθεί με το παλαιότερο βίντεο με έλεγχο ταυτότητας API.

{
  "video_model": "kling_3_0_motion_control",
  "prompt": "No distortion, the character's movements are consistent with the video.",
  "source_image_urls": ["https://example.com/character.png"],
  "video_urls": ["https://example.com/motion.mp4"],
  "character_orientation": "video",
  "quality_mode": "720p",
  "duration_seconds": 15
}

Παραδείγματα ανταπόκρισης

Κανονική δημιουργία απόκρισης

{
  "success": true,
  "job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
  "credits_remaining_total": 438
}

Η κληρονομιά δημιουργεί ανταπόκριση

{
  "success": true,
  "data": {
    "generation_id": "7f8cfd64-5b91-4a31-a987-e0ea8fd9d0a1",
    "generation_type": "video",
    "video_model": "kling30_motion",
    "mode": "image-to-video",
    "status": "processing",
    "credits_used": 300
  }
}

Δημοσκόπηση κατάστασης

GET /api/v1/video-studio/status/{job_id}/
GET /api/v1/generate/{generation_id}/

Τιμολόγηση

Η τιμολόγηση του Motion Control βασίζεται στη διάρκεια.

720p
20 πιστώσεις / δευτερόλεπτο
1080p
27 πιστώσεις / δευτερόλεπτο

Πιστώσεις, μοντέλα και κατάσταση