Hopp til innholdet

Kling bevegelseskontroll API docs

Kling Motion Control API-dokumenter for arbeidsflyter for bilde og bevegelsesvideo

Kling referanse for bevegelseskontroll

Kling Motion Control API-dokumenter for arbeidsflyter for bilde og bevegelsesvideo

Bruk denne veiledningen for å integrere Kling 2.6 bevegelseskontroll gjennom UlazAI API. Dagens integrasjon bruker model_slug="kling_3_0_motion_control"/api/v1/video-studio/generate/, eller kompatibilitetsbanen /api/v1/generate/video/ med video_model="kling_3_0_motion_control". Du sender nøyaktig ett bilde-URL, URL for én bevegelsesvideo, en prompt og en 720p eller 1080p kvalitetsmodus.

Kjerneendepunkter

/api/v1/video-studio/generate/

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

/api/v1/generate/video/

Nåværende støtte

1 bilde-URL + 1 bevegelsesvideo-URL

720p eller 1080p utgang

3 til 15 sekunder

Rutemerknad: Den offentlige nettadressen sier fortsatt kling-2-6-motion-control-api-docs, men gjeldende modell slug for live integrasjoner er kling_3_0_motion_control.
Bruk kompatibilitetsendepunktet bare hvis du allerede sender mot den eldre autentiserte videoen API.

Autentisering

Send en bærer token eller API nøkkel på hver forespørsel.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Kanonisk forespørsel

Denne forespørselen går til /api/v1/video-studio/generate/. Det er den foretrukne API-kontrakten for nye integrasjoner.

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

Feltreferanse

Felt Obligatorisk Notater
model_slug Ja Må være kling_3_0_motion_control
prompt Ja Maksimalt 2500 tegn
input_image_urls Ja Nøyaktig én nettadresse for offentlig bilde
input_video_urls Ja Nøyaktig én nettadresse for offentlig bevegelsesvideo
character_orientation Nei Bruk video for å følge bevegelsesklippets orientering eller image for å beholde den opplastede karakterinnrammingen
quality_mode Ja Bruk 720p eller 1080p
duration_seconds Ja Heltall fra 3 til 15. Prissetting bruker denne varigheten.

Eldre kompatibilitetsforespørsel

Denne forespørselen går til /api/v1/generate/video/. Bruk den hvis du allerede integrerer med den eldre autentiserte videoen 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å respons

Kanonisk generere respons

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

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

Statusmåling

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

Prissetting

Motion Control-priser er varighetsbasert.

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

Kreditter, modeller og status