Gå til indhold

Kling Motion Control API-dokumentation

Kling Motion Control API-dokumenter til billed- og motionsvideo-workflows

Kling Motion Control-reference

Kling Motion Control API-dokumenter til billed- og motionsvideo-workflows

Brug denne vejledning til at integrere Kling 2.6 Motion Control gennem UlazAI API. Den nuværende integration bruger model_slug="kling_3_0_motion_control"/api/v1/video-studio/generate/, eller kompatibilitetsstien /api/v1/generate/video/ med video_model="kling_3_0_motion_control". Du sender præcis en billed-URL, one motion video url, en prompt og en 720p eller 1080p kvalitetstilstand.

Kerneendepunkter

/api/v1/video-studio/generate/

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

/api/v1/generate/video/

Aktuel support

1 billede URL + 1 motion video URL

720p eller 1080p output

3 til 15 sekunder

Rutebemærkning: Den offentlige URL siger stadig kling-2-6-motion-control-api-docs, men nuværende model slug til live integrationer er kling_3_0_motion_control.
Brug kun kompatibilitetsslutpunktet, hvis du allerede sender mod den ældre autentificerede video API.

Autentificering

Send en bærer-token eller API-nøgle ved hver anmodning.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Kanonisk anmodning

Denne anmodning går til /api/v1/video-studio/generate/. Det er den foretrukne API kontrakt for nye 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
}

Feltreference

Felt Påkrævet Noter
model_slug Ja Skal være kling_3_0_motion_control
prompt Ja Maksimalt 2500 tegn
input_image_urls Ja Præcis én offentlig billedwebadresse
input_video_urls Ja Præcis én offentlig motionsvideo-URL
character_orientation Nej Brug video for at følge bevægelsesklips-retningen eller image for at beholde den uploadede karakterramme
quality_mode Ja Brug 720p eller 1080p
duration_seconds Ja Heltal fra 3 til 15. Prisfastsættelse bruger denne varighed.

Ældre kompatibilitetsanmodning

Denne anmodning går til /api/v1/generate/video/. Brug det, hvis du allerede integrerer med den ældre autentificerede 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
}

Eksempler på svar

Kanonisk generere respons

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

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

Status afstemning

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

Prissætning

Motion Control-priserne er varighedsbaserede.

720p
20 kreditter/sekund
1080p
27 kreditter/sekund

Krediteringer, modeller og status