Przejdź do treści

Dokumentacja Kling Motion Control API

Dokumentacja Kling Motion Control API dotycząca procesów pracy z obrazem i ruchomym wideo

Odniesienie do sterowania ruchem Klinga

Dokumentacja Kling Motion Control API dotycząca procesów pracy z obrazem i ruchomym wideo

Skorzystaj z tego przewodnika, aby dokonać integracji Kling 2.6 Sterowanie ruchem poprzez UlazAI API. Obecna integracja wykorzystuje model_slug="kling_3_0_motion_control" na /api/v1/video-studio/generate/lub ścieżkę zgodności /api/v1/generate/video/ z video_model="kling_3_0_motion_control". Wysyłasz dokładnie jeden adres URL obrazu, jeden adres URL wideo ruchomego, prompt i tryb jakości 720p lub 1080p.

Podstawowe punkty końcowe

/api/v1/video-studio/generate/

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

/api/v1/generate/video/

Bieżące wsparcie

1 adres URL obrazu + 1 adres URL filmu ruchomego

Wyjście 720p lub 1080p

3 do 15 sekund

Uwaga dotycząca trasy: publiczny adres URL nadal mówi kling-2-6-motion-control-api-docs, ale Obecny model integracji na żywo to kling_3_0_motion_control.
Używaj punktu końcowego zgodności tylko wtedy, gdy dostarczasz już starsze uwierzytelnione wideo API.

Uwierzytelnianie

Na każde żądanie wysyłaj token okaziciela lub klucz API.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Żądanie kanoniczne

Ta prośba trafia do /api/v1/video-studio/generate/. Jest to preferowana umowa API dla nowych integracji.

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

Odniesienie do pola

Pole Wymagane Notatki
model_slug Tak Musi być kling_3_0_motion_control
prompt Tak Maksymalnie 2500 znaków
input_image_urls Tak Dokładnie jeden adres URL obrazu publicznego
input_video_urls Tak Dokładnie jeden publiczny adres URL wideo ruchomego
character_orientation Nie Użyj video aby podążać za orientacją klipu ruchomego lub image aby zachować ramkę przesłanej postaci
quality_mode Tak Użyj 720p lub 1080p
duration_seconds Tak Liczba całkowita od 3 do 15. W wycenie używany jest ten czas trwania.

Żądanie zgodności ze starszą wersją

Ta prośba trafia do /api/v1/generate/video/. Użyj go, jeśli już integrujesz się ze starszym uwierzytelnionym wideo 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
}

Przykłady odpowiedzi

Odpowiedź kanoniczna

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

Starsza wersja generuje odpowiedź

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

Odpytywanie stanu

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

Wycena

Ceny Motion Control zależą od czasu trwania.

720p
20 kredytów / sekundę
1080p
27 kredytów / sekundę

Kredyty, modele i status