Siirry sisältöön

Kling Video · v3 · Pro · Motion Control

Integroi

Mallin tunniste 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"

Esimerkin kaltaiset tiedostot: 1,68 $ 1 680 API-krediittiä tiedostosi mitataan ennen suorittamista Suorita tällä sivulla

Hanki API-avain
Kling Videosta videoksi Viitesyötteet #stylized#transform#editing

Pro-tason liikkeensiirto, joka soveltaa viitevideon hahmon liikkeitä hahmokuvaan

Kling · Video

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

0 / 2500
•pakollinen image_url
Pudota tiedosto tai

Videon generointiin käytettävän viitekuvan URL-osoite; tiedoston enimmäiskoko 10.0MB, leveyden ja korkeuden 340px–3850px ja kuvasuhteen 0.40–2.50. Kuva ohjaa videon hahmoja, taustoja ja muita elementtejä. Hahmojen on oltava selkeästi näkyvissä, kehon mittasuhteiden oikeat, ilman peittymistä, ja niiden on katettava yli 5% kuvan alasta.

•pakollinen video_url
Pudota tiedosto tai

Sen videon URL-osoite, jonka hahmon liikkeet ohjaavat tulostetta; hahmon tulee näkyä esteettä realistisessa tyylissä siten, että pää ja joko koko keho tai ylävartalo ovat näkyvissä. Asetus character_orientation rajoittaa keston 10 sekuntiin arvolla 'image' tai 30 sekuntiin arvolla 'video'. Tiedostorajat: enintään 100 MB, leveyden ja korkeuden 340px–3850px ja keston 3.0s–30.05s.

character_orientation •pakollinen

Hahmon orientaation lähde: 'image' vastaa viitekuvaa ja seuraa kameran liikkeitä paremmin, enintään 10 sekuntia. Monimutkaisiin liikkeisiin 'video' on parempi: se vastaa viitevideon orientaatiota ja sallii enintään 30 sekuntia.

Lisäasetukset enable_safety_checker · keep_original_sound · elements

Valinnainen kasvoelementin sidonta tulostevideon identiteetin säilyttämisen parantamiseksi; enintään 1 ladattu elementti. Viittaa siihen kehotteessa tunnisteella @Element1. Sidonta on käytettävissä vain, kun character_orientation on 'video'.

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

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Kling Video · v3 · Pro · Motion Control

Yhdistää `image_url`-parametrin hahmokuvan ja `video_url`-parametrin viitevideon liikkeet. `character_orientation` on pakollinen ja määrittää, seuraako suuntaus kuvaa vai videota. Valinnainen enintään 2500 merkin `prompt` on tuettu, `keep_original_sound` säilyttää viiteäänen ja yksi kasvoelementti voidaan liittää `elements`-parametrin kautta identiteetin säilyttämiseksi.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
enable_safety_checkervalinnainen
Tyyppiboolean
Oletustrue
Turvatarkistukset voi poistaa käytöstä vain tilin valtuutuksella; valtuuttamattomat pyynnöt tarkistetaan aina.
promptvalinnainen
Tyyppistring | null
≤ 2 500 merkkiä
image_urlpakollinen image
Tyyppiurl · image
Videon generointiin käytettävän viitekuvan URL-osoite; tiedoston enimmäiskoko 10.0MB, leveyden ja korkeuden 340px–3850px ja kuvasuhteen 0.40–2.50. Kuva ohjaa videon hahmoja, taustoja ja muita elementtejä. Hahmojen on oltava selkeästi näkyvissä, kehon mittasuhteiden oikeat, ilman peittymistä, ja niiden on katettava yli 5% kuvan alasta.
video_urlpakollinen video
Tyyppiurl · video
Sen videon URL-osoite, jonka hahmon liikkeet ohjaavat tulostetta; hahmon tulee näkyä esteettä realistisessa tyylissä siten, että pää ja joko koko keho tai ylävartalo ovat näkyvissä. Asetus character_orientation rajoittaa keston 10 sekuntiin arvolla 'image' tai 30 sekuntiin arvolla 'video'. Tiedostorajat: enintään 100 MB, leveyden ja korkeuden 340px–3850px ja keston 3.0s–30.05s.
keep_original_soundvalinnainen
Tyyppiboolean
Oletustrue
Määrittää, säilytetäänkö viitevideon alkuperäinen ääni.
character_orientationpakollinen
Tyyppienum
imagevideo
Hahmon orientaation lähde: 'image' vastaa viitekuvaa ja seuraa kameran liikkeitä paremmin, enintään 10 sekuntia. Monimutkaisiin liikkeisiin 'video' on parempi: se vastaa viitevideon orientaatiota ja sallii enintään 30 sekuntia.
elementsvalinnainen
Tyyppiobject[]
Valinnainen kasvoelementin sidonta tulostevideon identiteetin säilyttämisen parantamiseksi; enintään 1 ladattu elementti. Viittaa siihen kehotteessa tunnisteella @Element1. Sidonta on käytettävissä vain, kun character_orientation on 'video'.
elements[].frontal_image_urlvalinnainen
Tyyppiurl · image
Elementin päänäkymän näyttävä etukuva. Tiedoston koko saa olla enintään 50 MB, leveyden ja korkeuden on oltava vähintään 300px ja kuvasuhteen 0.40–2.50.
elements[].reference_image_urlsvalinnainen
Tyyppiurl[] · image
Toimita 1–3 lisäviitekuvaa eri kulmista. Kunkin kuvan kuvasuhteen on oltava 0.40–2.50, kummankin mitan vähintään 300px ja koon enintään 50.0MB.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
video
object {url, content_type, file_name, file_size}Mallin tuottama video.

Lisää malleja: Videosta videoksi

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/kling-video/v3/pro/motion-control.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt