Přejít k obsahu

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

Poznámka k trase: veřejná adresa URL stále říká kling-2-6-motion-control-api-docs, ale aktuální model slug pro živé integrace je kling_3_0_motion_control.
Koncový bod kompatibility použijte pouze v případě, že již dodáváte se starším ověřeným videem API.

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í.

720p
20 kredity / sekunda
1080p
27 kredity / sekunda

Kredity, modely a stav