Hoppa till innehållet

Kling rörelsekontroll API docs

Kling Motion Control API dokument för arbetsflöden för bild och rörlig video

Kling motion control referens

Kling Motion Control API dokument för arbetsflöden för bild och rörlig video

Använd den här guiden för att integrera Kling 2.6 Rörelsekontroll genom UlazAI API. Den nuvarande integrationen använder model_slug="kling_3_0_motion_control"/api/v1/video-studio/generate/, eller kompatibilitetssökvägen /api/v1/generate/video/ med video_model="kling_3_0_motion_control". Du skickar exakt URL för en bild, URL för en rörlig video, en prompt och ett 720p eller 1080p kvalitetsläge.

Kärnslutpunkter

/api/v1/video-studio/generate/

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

/api/v1/generate/video/

Aktuellt stöd

1 bild-URL + 1 rörlig video-URL

720p eller 1080p utgång

3 till 15 sekunder

Ruttnotering: den offentliga webbadressen säger fortfarande kling-2-6-motion-control-api-docs, men nuvarande modell slug för live integrationer är kling_3_0_motion_control.
Använd endast kompatibilitetsslutpunkten om du redan skickar mot den äldre autentiserade videon API.

Autentisering

Skicka en bärartoken eller API-nyckel vid varje begäran.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Kanonisk begäran

Denna begäran går till /api/v1/video-studio/generate/. Det är det föredragna API-kontraktet för nya integrationer.

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

Fältreferens

Fält Obligatoriskt Anteckningar
model_slug Ja Måste vara kling_3_0_motion_control
prompt Ja Max 2500 tecken
input_image_urls Ja Exakt en webbadress för offentlig bild
input_video_urls Ja Exakt en webbadress för offentlig rörlig video
character_orientation Nej Använd video för att följa rörelseklippets orientering eller image för att behålla den uppladdade karaktärsramen
quality_mode Ja Använd 720p eller 1080p
duration_seconds Ja Heltal från 3 till 15. Prissättningen använder denna varaktighet.

Begäran om äldre kompatibilitet

Denna begäran går till /api/v1/generate/video/. Använd den om du redan integrerar med den äldre autentiserade videon 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
}

Exempel på svar

Kanoniskt generera svar

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

Legacy genererar 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
  }
}

Statusundersökning

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

Prissättning

Prissättningen för Motion Control är varaktighetsbaserad.

720p
20 krediter/sekund
1080p
27 krediter/sekund

Krediter, modeller och status