Sari la conținut

Kling Motion Control API documente

Kling Motion Control API documente pentru fluxuri de lucru imagine și video în mișcare

Referință pentru controlul mișcării Kling

Kling Motion Control API documente pentru fluxuri de lucru imagine și video în mișcare

Utilizați acest ghid pentru a integra Kling 2.6 Controlul mișcării prin UlazAI API. Actuala integrare utilizează model_slug="kling_3_0_motion_control" pe /api/v1/video-studio/generate/, sau calea de compatibilitate /api/v1/generate/video/ cu video_model="kling_3_0_motion_control". Tu trimiți exact o adresă URL a imaginii, o adresă URL a unui videoclip în mișcare, un prompt și un mod de calitate 720p sau 1080p.

Puncte finale de bază

/api/v1/video-studio/generate/

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

/api/v1/generate/video/

Suport curent

1 adresă URL a imaginii + 1 adresă URL a videoclipului în mișcare

Ieșire 720p sau 1080p

3 până la 15 secunde

Notă de traseu: adresa URL publică încă spune kling-2-6-motion-control-api-docs, dar modelul actual slug pentru integrări live este kling_3_0_motion_control.
Utilizați punctul final de compatibilitate numai dacă livrați deja pentru videoclipul autentificat vechi API.

Autentificare

Trimiteți un simbol purtător sau cheie API la fiecare cerere.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Cerere canonică

Această cerere merge la /api/v1/video-studio/generate/. Este contractul API preferat pentru noi integrări.

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

Referință de câmp

Câmp Necesar Note
model_slug Da Trebuie să fie kling_3_0_motion_control
prompt Da Maxim 2500 de caractere
input_image_urls Da Exact o adresă URL a imaginii publice
input_video_urls Da Exact o adresă URL publică a videoclipului în mișcare
character_orientation Nu Utilizați video pentru a urma orientarea clipului de mișcare sau image pentru a păstra încadrarea caracterelor încărcate
quality_mode Da Utilizați 720p sau 1080p
duration_seconds Da Număr întreg de la 3 la 15. Prețul utilizează această durată.

Cerere de compatibilitate moștenită

Această cerere merge la /api/v1/generate/video/. Folosiți-l dacă vă integrați deja cu videoclipul autentificat mai vechi 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
}

Exemple de răspuns

Canonic generează răspuns

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

Moștenirea generează răspuns

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

Sondaj de stare

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

Prețuri

Prețurile pentru controlul mișcării sunt bazate pe durată.

720p
20 credite/secunda
1080p
27 credite/secunda

Credite, modele și statut