Aqbeż għall-kontenut

Kling Video · v3 · Pro · Motion Control

Integra

Id tal-mudell 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"

Fajls bħall-eżempju: $1.68 1,680 krediti tal-API il-fajls tiegħek jitkejlu qabel it-tħaddim Ħaddmu f’din il-paġna

Ikseb ċavetta API
Kling Vidjo għal vidjo Inputs ta’ referenza #stylized#transform#editing

Trasferiment tal-moviment tal-livell Pro li japplika l-moviment tal-karattru minn vidjo ta’ referenza għal immaġni ta’ karattru

Kling · Vidjo

L-ewwel riżultat tiegħek jidher hawn

Ibni talba hawn taħt u ħaddimha biċ-ċavetta API tiegħek. L-outputs jiġu kkupjati fil-ħażna tagħna, miżmuma għal dejjem jew 7 ijiem b’xejn.

Ibni talba

Il-kontrolli jiġu ġġenerati mill-iskema tal-mudell. Il-kodiċi u l-prezz jaġġornaw hekk kif tibdilhom.

0 / 2500
•meħtieġ image_url
Waqqa’ fajl, jew

URL tal-immaġni ta' referenza għall-ġenerazzjoni tal-vidjo, b'limitu ta' daqs tal-fajl ta' 10.0MB, wisa' u għoli kull wieħed minn 340px sa 3850px, u proporzjon tal-aspett minn 0.40 sa 2.50. Din l-immaġni tiggwida l-karattri, l-isfondi u elementi oħra tal-vidjo. Għall-karattri, kun żgur minn proporzjonijiet ċari tal-ġisem, l-ebda ostruzzjoni, u kopertura ta' aktar minn 5% taż-żona tal-immaġni.

•meħtieġ video_url
Waqqa’ fajl, jew

URL li jindika l-vidjo li l-azzjonijiet tal-karattru tiegħu jiggwidaw l-output; għandu juri karattru realistiku u mingħajr ostruzzjonijiet, bir-ras u jew il-ġisem kollu jew il-parti ta' fuq tal-ġisem viżibbli. L-issettjar character_orientation jillimita t-tul għal 10s għal 'image' jew 30s għal 'video'. Limiti tal-fajl: massimu ta' 100 MB, wisa' u għoli kull wieħed bejn 340px u 3850px, u tul bejn 3.0s u 30.05s.

character_orientation •meħtieġ

Sors tal-orjentazzjoni tal-karattru: 'image' jaqbel mal-immaġni ta' referenza u huwa aħjar biex isegwi l-movimenti tal-kamera, b'massimu ta' 10 sekondi. Għal movimenti kumplessi, 'video' huwa aħjar: jaqbel mal-orjentazzjoni tal-vidjo ta' referenza u jippermetti sa 30 sekonda.

Avvanzat enable_safety_checker · keep_original_sound · elements

Irbit fakultattiv ta' element tal-wiċċ biex titjieb il-preservazzjoni tal-identità fil-vidjo output, limitat għal element wieħed imtella'. Uża @Element1 biex tindirizzah fil-prompt. L-irbit huwa disponibbli biss b'character_orientation issettjat għal 'video'.

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

Ħaddem din it-talba

Iċ-ċavetta tiegħek tibqa’ f’dan il-browser: tintbagħat biss lid-Doitong API u tiġi ssejvjata (localStorage) biss jekk timmarka Ftakar. Ikseb ċavetta API

Dwar Kling Video · v3 · Pro · Motion Control

Jgħaqqad immaġni ta’ karattru f’`image_url` ma’ movimenti minn vidjo ta’ referenza f’`video_url`. `character_orientation` hija meħtieġa u tagħżel jekk l-orjentazzjoni ssegwix l-immaġni jew il-vidjo. Huwa appoġġjat `prompt` fakultattiv sa 2500 karattru, `keep_original_sound` iżomm l-awdjo ta’ referenza, u element wieħed tal-wiċċ jista’ jintrabat permezz ta’ `elements` biex jgħin jippreserva l-identità.

Parametri

Ibgħat jew l-isem kanoniku jew l-isem nattiv, mhux it-tnejn. Ismijiet kanoniċi

IsemTip PrestabbilitPermess Deskrizzjoni
enable_safety_checkermhux obbligatorju
Tipboolean
Prestabbilittrue
Il-kontrolli tas-sikurezza jistgħu jiġu diżattivati biss bl-awtorizzazzjoni tal-kont; it-talbiet mingħajr awtorizzazzjoni dejjem jgħaddu minn kontroll.
promptmhux obbligatorju
Tipstring | null
≤ 2,500 karattri
image_urlmeħtieġ image
Tipurl · image
URL tal-immaġni ta' referenza għall-ġenerazzjoni tal-vidjo, b'limitu ta' daqs tal-fajl ta' 10.0MB, wisa' u għoli kull wieħed minn 340px sa 3850px, u proporzjon tal-aspett minn 0.40 sa 2.50. Din l-immaġni tiggwida l-karattri, l-isfondi u elementi oħra tal-vidjo. Għall-karattri, kun żgur minn proporzjonijiet ċari tal-ġisem, l-ebda ostruzzjoni, u kopertura ta' aktar minn 5% taż-żona tal-immaġni.
video_urlmeħtieġ video
Tipurl · video
URL li jindika l-vidjo li l-azzjonijiet tal-karattru tiegħu jiggwidaw l-output; għandu juri karattru realistiku u mingħajr ostruzzjonijiet, bir-ras u jew il-ġisem kollu jew il-parti ta' fuq tal-ġisem viżibbli. L-issettjar character_orientation jillimita t-tul għal 10s għal 'image' jew 30s għal 'video'. Limiti tal-fajl: massimu ta' 100 MB, wisa' u għoli kull wieħed bejn 340px u 3850px, u tul bejn 3.0s u 30.05s.
keep_original_soundmhux obbligatorju
Tipboolean
Prestabbilittrue
Jikkontrolla ż-żamma tal-ħoss oriġinali tal-vidjo ta' referenza.
character_orientationmeħtieġ
Tipenum
imagevideo
Sors tal-orjentazzjoni tal-karattru: 'image' jaqbel mal-immaġni ta' referenza u huwa aħjar biex isegwi l-movimenti tal-kamera, b'massimu ta' 10 sekondi. Għal movimenti kumplessi, 'video' huwa aħjar: jaqbel mal-orjentazzjoni tal-vidjo ta' referenza u jippermetti sa 30 sekonda.
elementsmhux obbligatorju
Tipobject[]
Irbit fakultattiv ta' element tal-wiċċ biex titjieb il-preservazzjoni tal-identità fil-vidjo output, limitat għal element wieħed imtella'. Uża @Element1 biex tindirizzah fil-prompt. L-irbit huwa disponibbli biss b'character_orientation issettjat għal 'video'.
elements[].frontal_image_urlmhux obbligatorju
Tipurl · image
Immaġni frontali li turi l-veduta ewlenija tal-element. Id-daqs tal-fajl ma jistax jaqbeż 50 MB; il-wisa' u l-għoli jridu jkunu kull wieħed mill-inqas 300px, bi proporzjon tal-aspett bejn 0.40 u 2.50.
elements[].reference_image_urlsmhux obbligatorju
Tipurl[] · image
Ipprovdi 1–3 immaġnijiet ta' referenza addizzjonali li juru angoli differenti. Kull immaġni għandu jkollha proporzjon tal-aspett bejn 0.40 u 2.50, tkejjel mill-inqas 300px fiż-żewġ dimensjonijiet, u ma tkunx akbar minn 50.0MB.
meħtieġ Isem kanoniku, aċċettat ukoll

Il-parametri tal-fajls jaċċettaw URL pubbliku https://, URI data: sa 10 MB, jew file_url ta’ upload. Fajls

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"
  }
}
Il-fajls tiegħek, l-għażla tiegħekKull outputs[].url huwa kopja fil-ħażna tagħna: miżmuma għal dejjem (imħallsa għal kull GB-xahar) jew 7 ijiem b’xejn, skont l-issettjar tal-kont tiegħek jew ?storage=.
L-istess struttura fuq kull mudelltype, url, content_type, width, height u duration, kemm għall-immaġnijiet kif ukoll għall-vidjo u l-awdjo. output huwa l-oġġett tar-riżultat tal-mudell innifsu.
Oqsma tal-output
video
object {url, content_type, file_name, file_size}Vidjo prodott mill-mudell.

Aktar mudelli: Vidjo għal vidjo

Għall-aġenti tal-AI: din il-paġna bħala Markdown tinsab fuq https://doitong.com/mt/developers/models/kling-video/v3/pro/motion-control.md. Il-mudelli u l-gwidi kollha: https://doitong.com/developers/llms.txt