Bỏ qua đến nội dung

Heygen · Avatar4 · Image to Video

Tích hợp

Id mô hình heygen/avatar4/image-to-video
# 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/avatar4/image-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg",
    "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 Lipsynctối đa 1080p #image-to-video

Hoạt hóa một ảnh khuôn mặt thành avatar biết nói, với phong cách nói ổn định hoặc biểu cảm

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 avatar sẽ nói.

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

Nguồn hoạt ảnh được cung cấp dưới dạng URL hình ảnh; hãy chọn hình ảnh có khuôn mặt hiển thị rõ.

audio_url
Thả tệp hoặc

Âm thanh đồng bộ môi được cung cấp qua URL tệp, được ưu tiên hơn cả lời nhắc và giọng nói khi có mặt.

resolution mặc định 720p

Giá trị đặt sẵn về độ phân giải cho video: 360p, 480p, 540p, 720p hoặc 1080p.

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 talking_style · voice · expression · caption · enable_safety_checker · background
talking_style mặc định stable

Kiểu hoạt ảnh nói: 'stable' giữ chuyển động ở mức tối thiểu, trong khi 'expressive' thêm nhiều hoạt ảnh hơn.

Tên giọng dùng để chọn giọng của avatar.

Biểu cảm hiển thị trên khuôn mặt.

Cài đặt cho nền.

POST /run/heygen/avatar4/image-to-video?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/avatar4/image-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg",
    "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 · Avatar4 · Image to Video

Chuyển một ảnh có khuôn mặt rõ thành video avatar biết nói. Cung cấp `prompt` chứa văn bản cần nói cùng tên `voice`, hoặc cung cấp `audio_url`, tùy chọn này sẽ ghi đè cả hai. `talking_style` chuyển giữa stable (chuyển động tối thiểu) và expressive. Bạn cũng có thể đặt biểu cảm, nền, phụ đề tùy chọn và độ phân giải từ 360p đến 1080p.

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ả
image_urlbắt buộc image
Kiểuurl · image
Nguồn hoạt ảnh được cung cấp dưới dạng URL hình ảnh; hãy chọn hình ảnh có khuôn mặt hiển thị rõ.
prompttùy chọn
Kiểustring | null
Văn bản avatar sẽ nói.
voicetùy chọn
Kiểuenum
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
Tên giọng dùng để chọn giọng của avatar.
audio_urltùy chọn audio
Kiểuurl · audio
Âm thanh đồng bộ môi được cung cấp qua URL tệp, được ưu tiên hơn cả lời nhắc và giọng nói khi có mặt.
talking_styletùy chọn
Kiểuenum
Mặc địnhstable
stableexpressive
Kiểu hoạt ảnh nói: 'stable' giữ chuyển động ở mức tối thiểu, trong khi 'expressive' thêm nhiều hoạt ảnh hơn.
expressiontùy chọn
Kiểustring | null
Biểu cảm hiển thị trên khuôn mặt.
backgroundtùy chọn
Kiểuobject
Cài đặt cho nền.
background.typetùy chọn
Kiểuenum
Mặc địnhcolor
colorimagevideo
Lựa chọn loại nền.
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 khi loại là 'image' hoặc 'video'.
resolutiontùy chọn
Kiểuenum
Mặc định720p
360p480p540p720p1080p
Giá trị đặt sẵn về độ phân giải cho video: 360p, 480p, 540p, 720p hoặc 1080p.
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'.
captiontùy chọn
Kiểuboolean
Mặc địnhfalse
Kiểm soát việc video có phụ đề hay không.
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/avatar4/image-to-video",
  "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": {
    "image_url": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg",
    "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
    }
  },
  "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 kết quả.

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/heygen/avatar4/image-to-video.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt