Siirry sisältöön

Kling Motion Control API asiakirjat

Kling Motion Control API -dokumentit kuva- ja liikevideotyönkulkuihin

Kling-liikkeenohjauksen viite

Kling Motion Control API -dokumentit kuva- ja liikevideotyönkulkuihin

Käytä tätä opasta integroidaksesi Kling 2.6 Liikeohjaus UlazAI API kautta. Nykyinen integraatio käyttää model_slug="kling_3_0_motion_control" päällä /api/v1/video-studio/generate/tai yhteensopivuuspolku /api/v1/generate/video/ kanssa video_model="kling_3_0_motion_control". Lähetät täsmälleen yhden kuvan URL-osoite, yhden liikevideon URL-osoite, prompt ja 720p- tai 1080p-laatutila.

Ydinpäätepisteet

/api/v1/video-studio/generate/

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

/api/v1/generate/video/

Nykyinen tuki

1 kuvan URL-osoite + 1 liikevideon URL-osoite

720p tai 1080p ulostulo

3-15 sekuntia

Reittihuomautus: julkinen URL-osoite sanoo edelleen kling-2-6-motion-control-api-docs, mutta nykyinen malli etana live-integraatioihin on kling_3_0_motion_control.
Käytä yhteensopivuuden päätepistettä vain, jos toimitat jo vanhan todennettua videota vastaan API.

Todennus

Lähetä siirtotietunnus tai API-avain jokaisesta pyynnöstä.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Kanoninen pyyntö

Tämä pyyntö menee /api/v1/video-studio/generate/. Se on ensisijainen API-sopimus uusille integroinneille.

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

Kenttäviittaus

Kenttä Pakollinen Huomautuksia
model_slug Kyllä Täytyy olla kling_3_0_motion_control
prompt Kyllä Enintään 2500 merkkiä
input_image_urls Kyllä Täsmälleen yksi julkinen kuvan URL-osoite
input_video_urls Kyllä Täsmälleen yksi julkinen video-URL-osoite
character_orientation Ei Käytä video seurataksesi liikeleikkeen suuntaa tai image säilyttääksesi ladatun hahmon kehystyksen
quality_mode Kyllä Käytä 720p tai 1080p
duration_seconds Kyllä Kokonaisluku 3-15. Hinnoittelu käyttää tätä kestoa.

Vanha yhteensopivuuspyyntö

Tämä pyyntö menee /api/v1/generate/video/. Käytä sitä, jos olet jo integroinut vanhempaan todennettuun videoon 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
}

Vastausesimerkkejä

Canonical luoda vastaus

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

Legacy tuottaa vastauksen

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

Tilakysely

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

Hinnoittelu

Motion Control -hinnoittelu perustuu kestoon.

720p
20 krediittiä / sekunti
1080p
27 krediittiä / sekunti

Krediitit, mallit ja status