Bỏ qua đến nội dung

Live Portrait

Tích hợp

Id mô hình 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"

Tối đa 4,50 $ mỗi lần chạy tính phí theo mức sử dụng thực tế, phần còn lại được hoàn tiền Chạy trên trang này

Lấy khóa API
Kuaishou Lipsync & avatar Lipsync #expression#animation

Tạo hoạt ảnh cho ảnh chân dung bằng biểu cảm lấy từ video điều khiển, với các điều khiển khuôn mặt tinh chỉnh

Kuaishou · Video

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc video_url
Thả tệp hoặc

URL video dùng để điều khiển đồng bộ chuyển động môi.

•bắt buộc image_url
Thả tệp hoặc

URL hình ảnh dùng cho hoạt ảnh.

Nâng cao 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
mặc định 0
mặc định 0

Mức độ nâng hoặc hạ lông mày.

mặc định 0

Mức độ nháy một mắt.

mặc định 0

Mức độ chuyển động ngang của đồng tử.

mặc định 0

Mức độ chuyển động dọc của đồng tử.

mặc định 0

Mức độ mở miệng theo dạng 'aaa'.

mặc định 0

Mức độ định hình miệng theo vị trí 'eee'.

mặc định 0

Mức độ định hình miệng theo vị trí 'woo'.

mặc định 0

Mức độ mỉm cười.

mặc định 0

Mức độ xoay khuôn mặt quanh trục pitch.

mặc định 0

Mức độ xoay khuôn mặt quanh trục yaw.

mặc định 0

Mức độ xoay khuôn mặt quanh trục roll.

mặc định 512

Kích thước của hình ảnh kết quả.

mặc định 2.3

Hệ số nhân tỷ lệ áp dụng cho phần cắt khuôn mặt.

mặc định 0

Tỷ lệ kiểm soát độ lệch ngang của phần cắt khuôn mặt.

mặc định -0.125

Tỷ lệ định vị dọc phần cắt khuôn mặt: dấu xác định hướng, giá trị dương hướng lên và giá trị âm hướng xuống.

mặc định 32

Kích thước batch của mô hình, đánh đổi giữa tốc độ và bộ nhớ: tăng giá trị này sẽ dùng nhiều bộ nhớ hơn để đổi lấy thời gian thực thi nhanh hơn.

POST /run/live-portrait?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Live Portrait

Chuyển chuyển động khuôn mặt từ video điều khiển lên chân dung tĩnh để tạo video. Ngoài `video_url` và `image_url`, mô hình có các điều khiển số cho chớp mắt, lông mày, nháy mắt, đồng tử, hình dạng miệng (aaa, eee, woo), nụ cười và xoay đầu theo pitch, yaw và roll. Có các tùy chọn cắt và ghép như `flag_do_crop` và `flag_pasteback`, còn `dsize` đặt kích thước đầu ra (mặc định 512).

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
video_urlbắt buộc video
Kiểuurl · video
URL video dùng để điều khiển đồng bộ chuyển động môi.
image_urlbắt buộc image
Kiểuurl · image
URL hình ảnh dùng cho hoạt ảnh.
eyebrowtùy chọn
Kiểunumber
Mặc định0
-30 – 30
Mức độ nâng hoặc hạ lông mày.
winktùy chọn
Kiểunumber
Mặc định0
0 – 25
Mức độ nháy một mắt.
pupil_xtùy chọn
Kiểunumber
Mặc định0
-45 – 45
Mức độ chuyển động ngang của đồng tử.
pupil_ytùy chọn
Kiểunumber
Mặc định0
-45 – 45
Mức độ chuyển động dọc của đồng tử.
aaatùy chọn
Kiểunumber
Mặc định0
-200 – 200
Mức độ mở miệng theo dạng 'aaa'.
eeetùy chọn
Kiểunumber
Mặc định0
-40 – 40
Mức độ định hình miệng theo vị trí 'eee'.
wootùy chọn
Kiểunumber
Mặc định0
-100 – 100
Mức độ định hình miệng theo vị trí 'woo'.
smiletùy chọn
Kiểunumber
Mặc định0
-2 – 2
Mức độ mỉm cười.
flag_lip_zerotùy chọn
Kiểuboolean
Mặc địnhtrue
Khép môi trước hoạt ảnh, chỉ áp dụng khi cả flag_eye_retargeting và flag_lip_retargeting đều được đặt thành False.
rotate_pitchtùy chọn
Kiểunumber
Mặc định0
-45 – 45
Mức độ xoay khuôn mặt quanh trục pitch.
rotate_yawtùy chọn
Kiểunumber
Mặc định0
-45 – 45
Mức độ xoay khuôn mặt quanh trục yaw.
rotate_rolltùy chọn
Kiểunumber
Mặc định0
-45 – 45
Mức độ xoay khuôn mặt quanh trục roll.
flag_eye_retargetingtùy chọn
Kiểuboolean
Mặc địnhfalse
Công tắc điều chỉnh lại mắt.
flag_lip_retargetingtùy chọn
Kiểuboolean
Mặc địnhfalse
Công tắc điều chỉnh lại môi.
flag_stitchingtùy chọn
Kiểuboolean
Mặc địnhtrue
Công tắc ghép nối; nên bật tùy chọn này.
flag_relativetùy chọn
Kiểuboolean
Mặc địnhtrue
Công tắc chuyển động tương đối.
flag_pastebacktùy chọn
Kiểuboolean
Mặc địnhtrue
Tùy chọn dán ngược/ghép nối, đặt phần khuôn mặt đã tạo hoạt ảnh trở lại hình ảnh gốc và ánh xạ ra khỏi tọa độ cắt khuôn mặt.
flag_do_croptùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc cắt chân dung nguồn vào không gian tọa độ cắt khuôn mặt.
flag_do_rottùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc xoay có được thực hiện khi flag_do_crop là true hay không.
dsizetùy chọn
Kiểuinteger
Mặc định512
Kích thước của hình ảnh kết quả.
scaletùy chọn
Kiểunumber
Mặc định2.3
Hệ số nhân tỷ lệ áp dụng cho phần cắt khuôn mặt.
vx_ratiotùy chọn
Kiểunumber
Mặc định0
Tỷ lệ kiểm soát độ lệch ngang của phần cắt khuôn mặt.
vy_ratiotùy chọn
Kiểunumber
Mặc định-0.125
Tỷ lệ định vị dọc phần cắt khuôn mặt: dấu xác định hướng, giá trị dương hướng lên và giá trị âm hướng xuống.
batch_sizetùy chọn
Kiểuinteger
Mặc định32
Kích thước batch của mô hình, đánh đổi giữa tốc độ và bộ nhớ: tăng giá trị này sẽ dùng nhiều bộ nhớ hơn để đổi lấy thời gian thực thi nhanh hơn.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhfalse
Kiểm soát việc bật kiểm tra an toàn. Khi hoạt động, bộ kiểm tra xử lý hình ảnh đầu vào để xác minh hình ảnh có chứa khuôn mặt trước khi mô hình xử lý.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
video
object {url, content_type, file_name, file_size}Tệp video được tạo sinh.

Thêm mô hình: Lipsync & avatar

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/live-portrait.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt