Bỏ qua đến nội dung

Heygen v5 Digital Twin

Tích hợp

Id mô hình heygen/avatar5/digital-twin
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/heygen/avatar5/digital-twin?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Các tệp như ví dụ: 1,00 $ 1.000 tín dụng API · ≈ 107,58 ₽ tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
HeyGen Lipsync & avatar Đầu ra 4KLipsynctối đa 4k #avatar#digital-twin#talking-avatar#text-to-video

Digital twin Avatar V với đầu ra 4k, WebM trong suốt, nền, hình mờ và chú thích SRT

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

Văn bản lời thoại cho avatar; bắt buộc nếu bỏ qua `audio_url`.

audio_url
Thả tệp hoặc

Nguồn đồng bộ khẩu hình được cung cấp dưới dạng URL tệp âm thanh HTTP(S), thay thế chuyển văn bản thành giọng nói khi có. Trong trường hợp đó, không sử dụng `prompt` hoặc `voice`.

resolution mặc định 720p

Giá trị đặt sẵn cho độ phân giải của đầu ra được tạo.

aspect_ratio mặc định 16:9

Lựa chọn tỷ lệ khung hình video: 'auto' yêu cầu HeyGen đọc và giữ nguyên tỷ lệ nguồn, dùng '16:9' nếu không thể. Các lựa chọn tỷ lệ rõ ràng là '16:9', '9:16', '4:5', '5:4' và '1:1'.

Nâng cao fit · output_format · avatar · voice · remove_background · caption · enable_safety_checker · background · watermark
fit mặc định cover

Chọn khung hình của avatar: 'cover' lấp đầy khung đầu ra nhưng có thể cắt avatar, còn 'contain' hiển thị toàn bộ avatar nhưng có thể thêm viền đen.

output_format mặc định mp4

Lựa chọn vùng chứa video, trong đó `webm` bật độ trong suốt thông qua việc tự động xóa nền; ở chế độ đó, `background` không có tác dụng.

mặc định Abigail Sofa Front

Tên xác định avatar đủ điều kiện cho Avatar V.

mặc định Warm Pro Narrator

Lựa chọn giọng nói của avatar theo tên cho chuyển văn bản thành giọng nói; chỉ áp dụng khi không có `audio_url`.

Lớp nền tùy chọn được đặt phía sau avatar, ngoại trừ khi `output_format='webm'`: đầu ra webm trong suốt sẽ bỏ qua cài đặt này.

Hình ảnh tùy chọn dùng làm lớp phủ hình mờ trong video được tạo.

POST /run/heygen/avatar5/digital-twin?wait=20 báo giá → 1,00 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/heygen/avatar5/digital-twin?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/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ề Heygen v5 Digital Twin

Tạo video avatar nói từ văn bản (`prompt` và `voice`) hoặc từ `audio_url` để đồng bộ khẩu hình. Chọn `avatar` có tên, chế độ `fit` là contain hoặc cover và độ phân giải 720p, 1080p hoặc 4k. `output_format` có thể là mp4 hoặc webm; webm trong suốt. Các tùy chọn gồm ghép nền, lớp phủ hình mờ và tệp chú thích SRT đi kèm.

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ả
avatartùy chọn
Kiểustring | null
Mặc địnhAbigail Sofa Front
Tên xác định avatar đủ điều kiện cho Avatar V.
prompttùy chọn
Kiểustring | null
Văn bản lời thoại cho avatar; bắt buộc nếu bỏ qua `audio_url`.
voicetùy chọn
Kiểuenum
Mặc địnhWarm Pro Narrator
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyPatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabella
+86 giá trị khácAndrewSpuds Oxley Grace ElderHelenCanyon RiversDerya - Lifelike - Excited 🤩Mellow MarcusJack Sterling - Broadcaster 🎙️Brenda - UGC - 1.mp4ReidReaganTerryJennyRadio RickDeniseTim in car - Excited 🤩IskanderThompsonDelicate Daisy - Excited 🤩KingstonGeorge UGC 1Bold BlakeJaneExpressive EvanMarianne - IAAaronModern Recipe Host - Voice 1WillowCute Chloe - Friendly 😊RafaelJune - LifelikeCrisp ChloeSlick SimonNassim - InformativeBaritone BenMaxwellEllie Faye - Excited 🤩MilaniFeisty Fiona - Excited 🤩Professor DeanRose - UGC - 1.mp4ShonaHudson WilderAnn - IAAlastair KensingtonOxleyChristinaAndrew Rizz PeytonGerardo - OutdoorChloe - LifelikeStephanieAnthony - IASignal - Voice 1LucaLisa - Voice 1T.W.TuckerJack Sullivan - Serious 😐WinterMireia - LifelikeGeorgiaStellaMasha - LifelikeCharming Charles - Friendly 😊SerenityAnnie - ExcitedRalphBethanyDominicMason FinnLeenaVeteran VictorTamaraNik PublicCalm ChloeSevikReillyRaulImposing IanRelaxed RayDexter - ProfessionalRelaxed RickEdwinRupert BlackwoodGinnyHope
Lựa chọn giọng nói của avatar theo tên cho chuyển văn bản thành giọng nói; chỉ áp dụng khi không có `audio_url`.
audio_urltùy chọn audio
Kiểuurl · audio
Nguồn đồng bộ khẩu hình được cung cấp dưới dạng URL tệp âm thanh HTTP(S), thay thế chuyển văn bản thành giọng nói khi có. Trong trường hợp đó, không sử dụng `prompt` hoặc `voice`.
fittùy chọn
Kiểuenum
Mặc địnhcover
containcover
Chọn khung hình của avatar: 'cover' lấp đầy khung đầu ra nhưng có thể cắt avatar, còn 'contain' hiển thị toàn bộ avatar nhưng có thể thêm viền đen.
remove_backgroundtùy chọn
Kiểuboolean
Mặc địnhfalse
Xóa nền cho avatar; chỉ khả dụng với avatar hỗ trợ tách nền.
backgroundtùy chọn
Kiểuobject
Lớp nền tùy chọn được đặt phía sau avatar, ngoại trừ khi `output_format='webm'`: đầu ra webm trong suốt sẽ bỏ qua cài đặt này.
background.typetùy chọn
Kiểuenum
Mặc địnhcolor
colorimage
Loại nền: `color` chỉ định màu thập lục phân đơn sắc, còn `image` chỉ định URL hình ảnh.
background.valuetùy chọn
Kiểustring
Mặc định#FFFFFF
Nội dung nền: màu thập lục phân khi loại là `color`, hoặc URL HTTP(S) khi loại là `image`.
watermarktùy chọn
Kiểuobject
Hình ảnh tùy chọn dùng làm lớp phủ hình mờ trong video được tạo.
watermark.image_urlbắt buộc
Kiểuurl · image
URL hình ảnh hình mờ qua HTTP(S), dùng để phủ lên video.
watermark.scaletùy chọn
Kiểunumber | null
≤ 2, > 0
Kích thước hình mờ tương đối so với video, lớn hơn 0.0 và tối đa 2.0.
watermark.opacitytùy chọn
Kiểunumber | null
0 – 1
Mức trong suốt của hình mờ: 0.0 là hoàn toàn trong suốt và 1.0 là hoàn toàn không trong suốt.
watermark.placementtùy chọn
Kiểuenum
top-lefttop-rightbottom-leftbottom-right
Vị trí của hình mờ trong video.
captiontùy chọn
Kiểuboolean
Mặc địnhfalse
Kiểm soát việc tạo tệp phụ đề SRT riêng đi kèm video.
output_formattùy chọn
Kiểuenum
Mặc địnhmp4
mp4webm
Lựa chọn vùng chứa video, trong đó `webm` bật độ trong suốt thông qua việc tự động xóa nền; ở chế độ đó, `background` không có tác dụng.
resolutiontùy chọn
Kiểuenum
Mặc định720p
720p1080p4k
Giá trị đặt sẵn cho độ phân giải của đầu ra được tạo.
aspect_ratiotùy chọn
Kiểuenum
Mặc định16:9
16:99:164:55:41:1auto
Lựa chọn tỷ lệ khung hình video: 'auto' yêu cầu HeyGen đọc và giữ nguyên tỷ lệ nguồn, dùng '16:9' nếu không thể. Các lựa chọn tỷ lệ rõ ràng là '16:9', '9:16', '4:5', '5:4' và '1:1'.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Có thể nới lỏng việc kiểm duyệt bằng cách đặt thành false, nếu người gọi được cấp quyền.
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": "heygen/avatar5/digital-twin",
  "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": 1000,
    "usd": "1.00",
    "charged": 1000,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "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
    },
    "caption_file": {
      "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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 do Avatar V tạo.
caption_file
object {url, content_type, file_name, file_size} | nullTệp phụ đề SRT được tạo khi `caption=True`, nếu dịch vụ cung cấp.

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