Langkau ke kandungan

Kling Video · v3 · Pro · Motion Control

Integrasikan

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

Fail seperti contoh: $1.68 1,680 kredit API fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
Kling Video ke Video Input rujukan #stylized#transform#editing

Pemindahan gerakan peringkat Pro yang menerapkan pergerakan watak daripada video rujukan kepada imej watak

Kling · Video

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

0 / 2500
•diperlukan image_url
Lepaskan fail, atau

URL imej rujukan untuk penjanaan video, dengan had saiz fail 10.0MB, lebar dan tinggi masing-masing daripada 340px hingga 3850px, serta nisbah aspek daripada 0.40 hingga 2.50. Imej ini membimbing watak, latar belakang dan elemen lain dalam video. Untuk watak, pastikan perkadaran badan jelas, tiada terlindung, dan meliputi lebih daripada 5% kawasan imej.

•diperlukan video_url
Lepaskan fail, atau

URL yang merujuk kepada video yang aksi wataknya membimbing output; video hendaklah menunjukkan watak gaya realistik yang tidak terhalang dengan kepala dan sama ada seluruh badan atau bahagian atas badan kelihatan. Tetapan character_orientation mengehadkan tempoh kepada 10s untuk 'image' atau 30s untuk 'video'. Had fail: maksimum 100 MB, lebar dan tinggi masing-masing antara 340px dan 3850px, serta tempoh antara 3.0s dan 30.05s.

character_orientation •diperlukan

Sumber orientasi watak: 'image' memadankan imej rujukan dan lebih baik untuk mengikuti pergerakan kamera, dengan maksimum 10 saat. Untuk pergerakan kompleks, 'video' lebih baik: ia memadankan orientasi video rujukan dan membenarkan sehingga 30 saat.

Lanjutan enable_safety_checker · keep_original_sound · elements

Pengikatan elemen wajah pilihan untuk menambah baik pengekalan identiti dalam video output, terhad kepada 1 elemen yang dimuat naik. Gunakan @Element1 untuk merujuknya dalam prompt. Pengikatan hanya tersedia apabila character_orientation ditetapkan kepada 'video'.

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

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Kling Video · v3 · Pro · Motion Control

Menggabungkan imej watak dalam `image_url` dengan pergerakan daripada video rujukan dalam `video_url`. `character_orientation` diperlukan dan menentukan sama ada orientasi mengikuti imej atau video. `prompt` pilihan sehingga 2500 aksara disokong, `keep_original_sound` mengekalkan audio rujukan, dan satu elemen wajah boleh dipautkan melalui `elements` untuk membantu mengekalkan identiti.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan keselamatan hanya boleh dilumpuhkan dengan kebenaran akaun; permintaan tanpa kebenaran sentiasa menjalani pemeriksaan.
promptpilihan
Jenisstring | null
≤ 2,500 aksara
image_urldiperlukan image
Jenisurl · image
URL imej rujukan untuk penjanaan video, dengan had saiz fail 10.0MB, lebar dan tinggi masing-masing daripada 340px hingga 3850px, serta nisbah aspek daripada 0.40 hingga 2.50. Imej ini membimbing watak, latar belakang dan elemen lain dalam video. Untuk watak, pastikan perkadaran badan jelas, tiada terlindung, dan meliputi lebih daripada 5% kawasan imej.
video_urldiperlukan video
Jenisurl · video
URL yang merujuk kepada video yang aksi wataknya membimbing output; video hendaklah menunjukkan watak gaya realistik yang tidak terhalang dengan kepala dan sama ada seluruh badan atau bahagian atas badan kelihatan. Tetapan character_orientation mengehadkan tempoh kepada 10s untuk 'image' atau 30s untuk 'video'. Had fail: maksimum 100 MB, lebar dan tinggi masing-masing antara 340px dan 3850px, serta tempoh antara 3.0s dan 30.05s.
keep_original_soundpilihan
Jenisboolean
Lalaitrue
Mengawal pengekalan bunyi asal video rujukan.
character_orientationdiperlukan
Jenisenum
imagevideo
Sumber orientasi watak: 'image' memadankan imej rujukan dan lebih baik untuk mengikuti pergerakan kamera, dengan maksimum 10 saat. Untuk pergerakan kompleks, 'video' lebih baik: ia memadankan orientasi video rujukan dan membenarkan sehingga 30 saat.
elementspilihan
Jenisobject[]
Pengikatan elemen wajah pilihan untuk menambah baik pengekalan identiti dalam video output, terhad kepada 1 elemen yang dimuat naik. Gunakan @Element1 untuk merujuknya dalam prompt. Pengikatan hanya tersedia apabila character_orientation ditetapkan kepada 'video'.
elements[].frontal_image_urlpilihan
Jenisurl · image
Imej menghadap hadapan yang menunjukkan paparan utama elemen. Saiz fail mestilah tidak melebihi 50 MB; lebar dan tinggi mestilah sekurang-kurangnya 300px setiap satu, dengan nisbah aspek antara 0.40 dan 2.50.
elements[].reference_image_urlspilihan
Jenisurl[] · image
Bekalkan 1–3 imej rujukan tambahan yang menunjukkan sudut berbeza. Setiap imej mesti mempunyai nisbah aspek antara 0.40 dan 2.50, berukuran sekurang-kurangnya 300px pada kedua-dua dimensi, dan tidak melebihi 50.0MB.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
video
object {url, content_type, file_name, file_size}Video yang dihasilkan oleh model.

Lebih banyak model: Video ke Video

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/kling-video/v3/pro/motion-control.md. Semua model dan panduan: https://doitong.com/developers/llms.txt