Przejdź do treści

Kling Video · v3 · Pro · Motion Control

Integracja

Identyfikator modelu kling-video/v3/pro/motion-control
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/kling-video/v3/pro/motion-control?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Pliki takie jak przykład: 1,68 $ 1680 kredytów API Twoje pliki są mierzone przed uruchomieniem Uruchom na tej stronie

Uzyskaj klucz API
Kling Wideo na wideo Dane referencyjne #stylized#transform#editing

Przenoszenie ruchu w planie Pro, stosujące ruch postaci z filmu referencyjnego do obrazu postaci

Kling · Wideo

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

0 / 2500
•wymagane image_url
Upuść plik lub

URL obrazu referencyjnego do generowania wideo, z limitem rozmiaru pliku 10.0MB, szerokością i wysokością od 340px do 3850px oraz proporcją od 0.40 do 2.50. Obraz wskazuje postacie, tła i inne elementy wideo. W przypadku postaci zapewnij wyraźne proporcje ciała, brak zasłonięć i zajmowanie ponad 5% powierzchni obrazu.

•wymagane video_url
Upuść plik lub

URL wskazujący wideo, którego działania postaci kierują wynikiem; powinno przedstawiać niezasłoniętą postać w realistycznym stylu, z widoczną głową oraz całym ciałem lub górną częścią ciała. Ustawienie character_orientation ogranicza długość do 10s dla 'image' lub 30s dla 'video'. Limity pliku: maksymalnie 100 MB, szerokość i wysokość od 340px do 3850px oraz długość od 3.0s do 30.05s.

character_orientation •wymagane

Źródło orientacji postaci: 'image' dopasowuje się do obrazu referencyjnego i lepiej śledzi ruchy kamery, z maksymalnym czasem 10 sekund. W przypadku złożonych ruchów lepsze jest 'video': dopasowuje się do orientacji wideo referencyjnego i pozwala na maksymalnie 30 sekund.

Zaawansowane enable_safety_checker · keep_original_sound · elements

Opcjonalne powiązanie elementu twarzy w celu lepszego zachowania tożsamości w wideo wyniku, ograniczone do 1 przesłanego elementu. Użyj @Element1, aby odwołać się do niego w promptcie. Powiązanie jest dostępne tylko przy character_orientation ustawionym na 'video'.

POST /run/kling-video/v3/pro/motion-control?wait=20 wycena → 1,68 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/kling-video/v3/pro/motion-control?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o Kling Video · v3 · Pro · Motion Control

Łączy obraz postaci w `image_url` z ruchami z filmu referencyjnego w `video_url`. `character_orientation` jest wymagane i określa, czy orientacja ma podążać za obrazem czy filmem. Obsługiwany jest opcjonalny `prompt` o długości do 2500 znaków, `keep_original_sound` zachowuje dźwięk referencyjny, a jeden element twarzy można powiązać przez `elements`, aby pomóc zachować tożsamość.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Kontrole bezpieczeństwa można wyłączyć tylko po autoryzacji konta; żądania bez autoryzacji zawsze są sprawdzane.
promptopcjonalne
Typstring | null
≤ 2500 znaków
image_urlwymagane image
Typurl · image
URL obrazu referencyjnego do generowania wideo, z limitem rozmiaru pliku 10.0MB, szerokością i wysokością od 340px do 3850px oraz proporcją od 0.40 do 2.50. Obraz wskazuje postacie, tła i inne elementy wideo. W przypadku postaci zapewnij wyraźne proporcje ciała, brak zasłonięć i zajmowanie ponad 5% powierzchni obrazu.
video_urlwymagane video
Typurl · video
URL wskazujący wideo, którego działania postaci kierują wynikiem; powinno przedstawiać niezasłoniętą postać w realistycznym stylu, z widoczną głową oraz całym ciałem lub górną częścią ciała. Ustawienie character_orientation ogranicza długość do 10s dla 'image' lub 30s dla 'video'. Limity pliku: maksymalnie 100 MB, szerokość i wysokość od 340px do 3850px oraz długość od 3.0s do 30.05s.
keep_original_soundopcjonalne
Typboolean
Domyślnetrue
Określa zachowanie oryginalnego dźwięku wideo referencyjnego.
character_orientationwymagane
Typenum
imagevideo
Źródło orientacji postaci: 'image' dopasowuje się do obrazu referencyjnego i lepiej śledzi ruchy kamery, z maksymalnym czasem 10 sekund. W przypadku złożonych ruchów lepsze jest 'video': dopasowuje się do orientacji wideo referencyjnego i pozwala na maksymalnie 30 sekund.
elementsopcjonalne
Typobject[]
Opcjonalne powiązanie elementu twarzy w celu lepszego zachowania tożsamości w wideo wyniku, ograniczone do 1 przesłanego elementu. Użyj @Element1, aby odwołać się do niego w promptcie. Powiązanie jest dostępne tylko przy character_orientation ustawionym na 'video'.
elements[].frontal_image_urlopcjonalne
Typurl · image
Obraz frontalny przedstawiający główny widok elementu. Rozmiar pliku nie może przekraczać 50 MB; szerokość i wysokość muszą wynosić co najmniej 300px, a proporcja obrazu musi mieścić się w zakresie od 0.40 do 2.50.
elements[].reference_image_urlsopcjonalne
Typurl[] · image
Dostarcz 1–3 dodatkowe obrazy referencyjne przedstawiające różne kąty. Każdy obraz musi mieć proporcję od 0.40 do 2.50, oba wymiary co najmniej 300px i rozmiar nie większy niż 50.0MB.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "kling-video/v3/pro/motion-control",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1680,
    "usd": "1.68",
    "charged": 1680,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
video
object {url, content_type, file_name, file_size}Wideo wygenerowane przez model.

Więcej modeli: Wideo na wideo

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/kling-video/v3/pro/motion-control.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt