Naar inhoud

Kling Motion Control API documentatie

Kling Motion Control API-documentatie voor beeld- en filmworkflows

Kling-referentie voor bewegingsbesturing

Kling Motion Control API-documentatie voor beeld- en filmworkflows

Gebruik deze handleiding om te integreren Kling 2.6 Bewegingsbediening via de UlazAI API. De huidige integratie maakt gebruik van model_slug="kling_3_0_motion_control" op /api/v1/video-studio/generate/of het compatibiliteitspad /api/v1/generate/video/ met video_model="kling_3_0_motion_control". Je stuurt precies één afbeeldings-URL, één bewegingsvideo-URL, een prompt en een 720p- of 1080p-kwaliteitsmodus.

Kerneindpunten

/api/v1/video-studio/generate/

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

/api/v1/generate/video/

Huidige ondersteuning

1 afbeeldings-URL + 1 bewegende video-URL

720p- of 1080p-uitvoer

3 tot 15 seconden

Routenotitie: de openbare URL zegt nog steeds kling-2-6-motion-control-api-docs, maar de huidige modelslug voor live-integraties is kling_3_0_motion_control.
Gebruik het compatibiliteitseindpunt alleen als u al verzendt met de oudere, geverifieerde video API.

Authenticatie

Stuur bij elk verzoek een dragertoken of API-sleutel.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Canoniek verzoek

Dit verzoek gaat naar /api/v1/video-studio/generate/. Het is het voorkeurscontract API voor nieuwe integraties.

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

Veldreferentie

Veld Vereist Opmerkingen
model_slug Ja Moet zo zijn kling_3_0_motion_control
prompt Ja Maximaal 2500 tekens
input_image_urls Ja Precies één openbare afbeeldings-URL
input_video_urls Ja Precies één openbare bewegingsvideo-URL
character_orientation Nee Gebruik video om de oriëntatie van de bewegingsclip te volgen of image om de geüploade karakterframing te behouden
quality_mode Ja Gebruik 720p of 1080p
duration_seconds Ja Geheel getal van 3 tot 15. Prijzen gebruiken deze duur.

Verouderd compatibiliteitsverzoek

Dit verzoek gaat naar /api/v1/generate/video/. Gebruik het als u al integreert met de oudere, geverifieerde 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
}

Reactievoorbeelden

Canoniek genereert respons

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

Legacy genereert respons

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

Statusonderzoek

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

Prijzen

De prijzen voor Motion Control zijn gebaseerd op de duur.

720p
20 tegoeden / seconde
1080p
27 tegoeden / seconde

Credits, modellen en status