Langkau ke kandungan

Live Portrait

Integrasikan

ID model live-portrait
# 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/live-portrait?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg"
  }'

# 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"

Sehingga $4.50 setiap larian dicaj berdasarkan penggunaan sebenar, selebihnya dibayar balik Jalankan pada halaman ini

Dapatkan kunci API
Kuaishou Lip-sync & Avatar Lip-sync #expression#animation

Menganimasikan imej potret dengan ekspresi yang diambil daripada video pemacu, dengan kawalan muka terperinci

Kuaishou · 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.

•diperlukan video_url
Lepaskan fail, atau

URL video yang digunakan untuk memacu penyegerakan bibir.

•diperlukan image_url
Lepaskan fail, atau

URL imej untuk animasi.

Lanjutan blink · eyebrow · wink · pupil_x · pupil_y · aaa · eee · woo · smile · rotate_pitch · rotate_yaw · rotate_roll · dsize · scale · vx_ratio · vy_ratio · batch_size · flag_lip_zero · flag_eye_retargeting · flag_lip_retargeting · flag_stitching · flag_relative · flag_pasteback · flag_do_crop · flag_do_rot · enable_safety_checker
lalai 0
lalai 0

Darjah penaikan atau penurunan kening.

lalai 0

Darjah kerlingan mata.

lalai 0

Jumlah pergerakan anak mata mendatar.

lalai 0

Jumlah pergerakan anak mata menegak.

lalai 0

Darjah pembukaan mulut kepada bentuk 'aaa'.

lalai 0

Darjah pembentukan mulut kepada posisi 'eee'.

lalai 0

Darjah pembentukan mulut kepada posisi 'woo'.

lalai 0

Darjah senyuman.

lalai 0

Jumlah putaran wajah sepanjang paksi pitch.

lalai 0

Jumlah putaran wajah sepanjang paksi yaw.

lalai 0

Jumlah putaran wajah sepanjang paksi roll.

lalai 512

Dimensi imej yang terhasil.

lalai 2.3

Pengganda skala yang digunakan pada pangkasan wajah.

lalai 0

Nisbah yang mengawal ofset mendatar pangkasan wajah.

lalai -0.125

Nisbah kedudukan menegak pangkasan wajah: tanda menentukan arah, ke atas untuk nilai positif dan ke bawah untuk nilai negatif.

lalai 32

Saiz kelompok model, dengan pertukaran antara kelajuan dan memori: meningkatkannya menggunakan lebih banyak memori sebagai pertukaran untuk pelaksanaan yang lebih pantas.

POST /run/live-portrait?wait=20 sebut harga → $4.50
# 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/live-portrait?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg"
  }'

# 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 Live Portrait

Memindahkan gerakan muka daripada video pemacu kepada potret pegun untuk menghasilkan video. Selain `video_url` dan `image_url`, ia menawarkan kawalan berangka untuk kelipan, kening, kenyitan mata, anak mata, bentuk mulut (aaa, eee, woo), senyuman serta putaran kepala pada pitch, yaw dan roll. Pilihan pemangkasan dan cantuman seperti `flag_do_crop` dan `flag_pasteback` tersedia, manakala `dsize` menetapkan saiz output (lalai 512).

Parameter

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

NamaJenis LalaiDibenarkan Penerangan
video_urldiperlukan video
Jenisurl · video
URL video yang digunakan untuk memacu penyegerakan bibir.
image_urldiperlukan image
Jenisurl · image
URL imej untuk animasi.
eyebrowpilihan
Jenisnumber
Lalai0
-30 – 30
Darjah penaikan atau penurunan kening.
winkpilihan
Jenisnumber
Lalai0
0 – 25
Darjah kerlingan mata.
pupil_xpilihan
Jenisnumber
Lalai0
-45 – 45
Jumlah pergerakan anak mata mendatar.
pupil_ypilihan
Jenisnumber
Lalai0
-45 – 45
Jumlah pergerakan anak mata menegak.
aaapilihan
Jenisnumber
Lalai0
-200 – 200
Darjah pembukaan mulut kepada bentuk 'aaa'.
eeepilihan
Jenisnumber
Lalai0
-40 – 40
Darjah pembentukan mulut kepada posisi 'eee'.
woopilihan
Jenisnumber
Lalai0
-100 – 100
Darjah pembentukan mulut kepada posisi 'woo'.
smilepilihan
Jenisnumber
Lalai0
-2 – 2
Darjah senyuman.
flag_lip_zeropilihan
Jenisboolean
Lalaitrue
Penutupan bibir sebelum animasi, hanya terpakai apabila kedua-dua flag_eye_retargeting dan flag_lip_retargeting ditetapkan kepada False.
rotate_pitchpilihan
Jenisnumber
Lalai0
-45 – 45
Jumlah putaran wajah sepanjang paksi pitch.
rotate_yawpilihan
Jenisnumber
Lalai0
-45 – 45
Jumlah putaran wajah sepanjang paksi yaw.
rotate_rollpilihan
Jenisnumber
Lalai0
-45 – 45
Jumlah putaran wajah sepanjang paksi roll.
flag_eye_retargetingpilihan
Jenisboolean
Lalaifalse
Suis penyasaran semula mata.
flag_lip_retargetingpilihan
Jenisboolean
Lalaifalse
Suis penyasaran semula bibir.
flag_stitchingpilihan
Jenisboolean
Lalaitrue
Suis jahitan; pengaktifannya disyorkan.
flag_relativepilihan
Jenisboolean
Lalaitrue
Suis gerakan relatif.
flag_pastebackpilihan
Jenisboolean
Lalaitrue
Pilihan tampal semula/jahitan yang meletakkan pangkasan wajah beranimasi ke dalam imej asal, memetakannya keluar daripada koordinat pangkasan wajah.
flag_do_croppilihan
Jenisboolean
Lalaitrue
Mengawal sama ada potret sumber dipangkas ke dalam ruang koordinat pangkasan wajah.
flag_do_rotpilihan
Jenisboolean
Lalaitrue
Mengawal sama ada putaran dilakukan apabila flag_do_crop ialah true.
dsizepilihan
Jenisinteger
Lalai512
Dimensi imej yang terhasil.
scalepilihan
Jenisnumber
Lalai2.3
Pengganda skala yang digunakan pada pangkasan wajah.
vx_ratiopilihan
Jenisnumber
Lalai0
Nisbah yang mengawal ofset mendatar pangkasan wajah.
vy_ratiopilihan
Jenisnumber
Lalai-0.125
Nisbah kedudukan menegak pangkasan wajah: tanda menentukan arah, ke atas untuk nilai positif dan ke bawah untuk nilai negatif.
batch_sizepilihan
Jenisinteger
Lalai32
Saiz kelompok model, dengan pertukaran antara kelajuan dan memori: meningkatkannya menggunakan lebih banyak memori sebagai pertukaran untuk pelaksanaan yang lebih pantas.
enable_safety_checkerpilihan
Jenisboolean
Lalaifalse
Mengawal sama ada pemeriksaan keselamatan diaktifkan. Apabila aktif, pemeriksa memproses imej input untuk mengesahkan bahawa imej itu mengandungi wajah sebelum pemprosesan model.
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": "live-portrait",
  "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": 4500,
    "usd": "4.50",
    "charged": 4500,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image_url": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg"
  },
  "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}Fail video yang dihasilkan oleh penjanaan.

Lebih banyak model: Lip-sync & Avatar

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/live-portrait.md. Semua model dan panduan: https://doitong.com/developers/llms.txt