Dokumenty Kling Motion Control API
Dokumenty Kling Motion Control API pro pracovní postupy obrazu a videa
Reference ovládání pohybu Kling
Dokumenty Kling Motion Control API pro pracovní postupy obrazu a videa
K integraci použijte tuto příručku Ovládání pohybu Kling 2.6 pomocí UlazAI API.
Současná integrace využívá model_slug="kling_3_0_motion_control" na
/api/v1/video-studio/generate/nebo cestu kompatibility
/api/v1/generate/video/ s video_model="kling_3_0_motion_control".
Posíláte přesně jedna adresa URL obrázku, URL jednoho pohyblivého videa, prompt a režim kvality 720p nebo 1080p.
Základní koncové body
/api/v1/video-studio/generate/
/api/v1/video-studio/status/{job_id}/
/api/v1/generate/video/
Aktuální podpora
1 adresa URL obrázku + 1 adresa URL pohyblivého videa
Výstup 720p nebo 1080p
3 až 15 sekund
kling-2-6-motion-control-api-docs, ale
aktuální model slug pro živé integrace je kling_3_0_motion_control.
Autentizace
Při každé žádosti odešlete token nosiče nebo klíč API.
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Kanonický požadavek
Tento požadavek jde na /api/v1/video-studio/generate/.
Je to preferovaná smlouva API pro nové integrace.
{
"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
}
Odkaz na pole
| Pole | Povinné | Poznámky |
|---|---|---|
model_slug |
Ano | Musí být kling_3_0_motion_control |
prompt |
Ano | Maximálně 2500 znaků |
input_image_urls |
Ano | Přesně jedna adresa URL veřejného obrázku |
input_video_urls |
Ano | Přesně jedna adresa URL veřejného pohyblivého videa |
character_orientation |
Ne | Použijte video sledovat orientaci pohybového klipu nebo image abyste zachovali rámování nahrané postavy |
quality_mode |
Ano | Použijte 720p nebo 1080p |
duration_seconds |
Ano | Celé číslo od 3 do 15. Cenu používá tuto dobu trvání. |
Starší požadavek na kompatibilitu
Tento požadavek jde na /api/v1/generate/video/.
Použijte jej, pokud již integrujete se starším ověřeným videem 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
}
Příklady odpovědí
Canonical generovat odpověď
{
"success": true,
"job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
"credits_remaining_total": 438
}
Legacy generuje odezvu
{
"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
}
}
Průzkum stavu
GET /api/v1/video-studio/status/{job_id}/
GET /api/v1/generate/{generation_id}/
Ceny
Ceny Motion Control jsou založeny na délce trvání.