Op den Inhalt sprangen

Kling Video · v3 · Pro · Motion Control

Integréieren

Modell-ID 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"

Dateie wéi am Beispill: 1,68 $ 1.680 API-Kreditter Är Dateie gi virun der Ausféierung gemooss Op dëser Säit ausféieren

API-Schlëssel kréien
Kling Video zu Video Referenzinput #stylized#transform#editing

Motion-Transfer am Pro-Tarif, deen d'Charakterbeweegunge vun engem Referenzvideo op e Charakterbild applizéiert

Kling · Video

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

0 / 2500
•obligatoresch image_url
Fichier erofzéien, oder

URL vum Referenzbild fir d'Video-Generatioun, mat enger Dateigréisstelimit vun 10.0MB, enger Breet an Héicht vun 340px bis 3850px an engem Bildverhältnis vun 0.40 bis 2.50. Dëst Bild steiert d'Personnagen, Hannergrënn an aner Elementer vum Video. Bei Personnagen mussen d'Kierperproportiounen däitlech sinn, ouni Iwwerdeckung, a méi wéi 5% vun der Bildfläch ausmaachen.

•obligatoresch video_url
Fichier erofzéien, oder

URL op de Video, deem seng Personnagen d'Aktiounen am Output steieren; e soll e fräie realistesch stiliséierte Personnage weisen, mat siichtbarem Kapp an entweder dem ganze Kierper oder dem Uewerkierper. D'Astellung character_orientation limitéiert d'Dauer op 10s fir 'image' oder 30s fir 'video'. Dateilimiten: héchstens 100 MB, Breet an Héicht tëscht 340px an 3850px, Dauer tëscht 3.0s an 30.05s.

character_orientation •obligatoresch

Quell vun der Personnageausriichtung: 'image' entsprécht dem Referenzbild a funktionéiert besser bei Kamerabeweegungen, mat engem Maximum vun 10 Sekonnen. Fir komplex Beweegunge ass 'video' besser: et entsprécht der Ausriichtung vum Referenzvideo an erlaabt bis zu 30 Sekonnen.

Erweidert enable_safety_checker · keep_original_sound · elements

Optional Gesiichtselement-Bindung fir d'Identitéit am Output-Video besser ze erhalen, limitéiert op 1 eropgelueden Element. Benotzt @Element1 am Prompt. D'Bindung ass nëmme verfügbar, wann character_orientation op 'video' gesat ass.

POST /run/kling-video/v3/pro/motion-control?wait=20 Präis → 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"

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer Kling Video · v3 · Pro · Motion Control

Kombinéiert e Charakterbild an `image_url` mat Beweegungen aus engem Referenzvideo an `video_url`. `character_orientation` ass obligatoresch a bestëmmt, ob d'Ausriichtung dem Bild oder dem Video follegt. E fakultative `prompt` mat bis zu 2500 Zeeche gëtt ënnerstëtzt, `keep_original_sound` behält den Referenzaudio, an en eenzegt Gesiichtselement kann iwwer `elements` gebonne ginn, fir d'Identitéit besser ze erhalen.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
enable_safety_checkeroptional
Typboolean
Standardtrue
Sécherheetskontrolle kënnen nëmme mat Kontautorisatioun deaktivéiert ginn; Ufroen ouni Autorisatioun ginn ëmmer kontrolléiert.
promptoptional
Typstring | null
≤ 2.500 Zeechen
image_urlobligatoresch image
Typurl · image
URL vum Referenzbild fir d'Video-Generatioun, mat enger Dateigréisstelimit vun 10.0MB, enger Breet an Héicht vun 340px bis 3850px an engem Bildverhältnis vun 0.40 bis 2.50. Dëst Bild steiert d'Personnagen, Hannergrënn an aner Elementer vum Video. Bei Personnagen mussen d'Kierperproportiounen däitlech sinn, ouni Iwwerdeckung, a méi wéi 5% vun der Bildfläch ausmaachen.
video_urlobligatoresch video
Typurl · video
URL op de Video, deem seng Personnagen d'Aktiounen am Output steieren; e soll e fräie realistesch stiliséierte Personnage weisen, mat siichtbarem Kapp an entweder dem ganze Kierper oder dem Uewerkierper. D'Astellung character_orientation limitéiert d'Dauer op 10s fir 'image' oder 30s fir 'video'. Dateilimiten: héchstens 100 MB, Breet an Héicht tëscht 340px an 3850px, Dauer tëscht 3.0s an 30.05s.
keep_original_soundoptional
Typboolean
Standardtrue
Steiert, ob den originale Sound vum Referenzvideo erhale bleift.
character_orientationobligatoresch
Typenum
imagevideo
Quell vun der Personnageausriichtung: 'image' entsprécht dem Referenzbild a funktionéiert besser bei Kamerabeweegungen, mat engem Maximum vun 10 Sekonnen. Fir komplex Beweegunge ass 'video' besser: et entsprécht der Ausriichtung vum Referenzvideo an erlaabt bis zu 30 Sekonnen.
elementsoptional
Typobject[]
Optional Gesiichtselement-Bindung fir d'Identitéit am Output-Video besser ze erhalen, limitéiert op 1 eropgelueden Element. Benotzt @Element1 am Prompt. D'Bindung ass nëmme verfügbar, wann character_orientation op 'video' gesat ass.
elements[].frontal_image_urloptional
Typurl · image
Frontalbild mat der Haaptusiicht vum Element. D'Datei däerf net méi wéi 50 MB hunn; Breet an Héicht mussen all op d'mannst 300px sinn, mat engem Bildverhältnis tëscht 0.40 an 2.50.
elements[].reference_image_urlsoptional
Typurl[] · image
Gitt 1–3 zousätzlech Referenzbiller aus verschiddene Wénkelen un. All Bild muss e Bildverhältnis tëscht 0.40 an 2.50 hunn, a béid Dimensioune mussen op d'mannst 300px sinn; d'Datei däerf net méi grouss wéi 50.0MB sinn.
obligatoresch Kanoneschen Numm, och akzeptéiert

Fichierparameter akzeptéieren eng ëffentlech https:// URL, eng data: URI bis zu 10 MB oder de file_url vun engem Upload. Fichieren

Output

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"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
video
object {url, content_type, file_name, file_size}Video, deen d'Modell produzéiert huet.

Méi Modeller: Video zu Video

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/kling-video/v3/pro/motion-control.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt