Lompat ke konten

Heygen v5 Digital Twin

Integrasikan

ID model 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"

File seperti contoh: $1,00 1.000 kredit API · ≈ ₽107,58 file Anda diukur sebelum dijalankan Jalankan di halaman ini

Dapatkan kunci API
HeyGen Lip sync & Avatar Output 4KLip synchingga 4k #avatar#digital-twin#talking-avatar#text-to-video

Kembaran digital Avatar V dengan output 4k, WebM transparan, latar belakang, tanda air, dan takarir SRT

HeyGen · Video

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

Teks ucapan untuk avatar; wajib diisi jika `audio_url` dihilangkan.

audio_url
Jatuhkan file, atau

Sumber sinkronisasi bibir yang diberikan sebagai URL file audio HTTP(S), menggantikan text-to-speech jika tersedia. Dalam kasus tersebut, `prompt` dan `voice` tidak digunakan.

resolution bawaan 720p

Preset resolusi untuk output yang dibuat.

aspect_ratio bawaan 16:9

Pilihan rasio aspek video: 'auto' meminta HeyGen membaca dan mempertahankan rasio sumber, menggunakan '16:9' jika tidak dapat membacanya. Pilihan rasio eksplisit adalah '16:9', '9:16', '4:5', '5:4', dan '1:1'.

Lanjutan fit · output_format · avatar · voice · remove_background · caption · enable_safety_checker · background · watermark
fit bawaan cover

Pilih pembingkaian avatar: 'cover' memenuhi bingkai output tetapi mungkin memotong avatar, sedangkan 'contain' menampilkan seluruh avatar tetapi mungkin menambahkan bilah hitam.

output_format bawaan mp4

Pemilihan kontainer video, dengan `webm` yang mengaktifkan transparansi melalui penghapusan latar belakang otomatis; dalam mode tersebut, `background` tidak berpengaruh.

bawaan Abigail Sofa Front

Nama yang mengidentifikasi avatar yang memenuhi syarat untuk Avatar V.

bawaan Warm Pro Narrator

Pemilihan suara avatar berdasarkan nama untuk text-to-speech; hanya berlaku tanpa `audio_url`.

Lapisan latar belakang yang secara opsional ditempatkan di belakang avatar, kecuali dengan `output_format='webm'`: output webm transparan mengabaikan pengaturan ini.

Gambar opsional yang digunakan sebagai overlay tanda air pada video yang dibuat.

POST /run/heygen/avatar5/digital-twin?wait=20 estimasi harga → $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"

Jalankan permintaan ini

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Heygen v5 Digital Twin

Membuat video avatar yang berbicara dari teks (`prompt` dan `voice`) atau dari `audio_url` untuk sinkronisasi bibir. Pilih `avatar` bernama, mode `fit` contain atau cover, dan resolusi 720p, 1080p, atau 4k. `output_format` dapat berupa mp4 atau webm; webm bersifat transparan. Opsi mencakup komposit latar belakang, overlay tanda air, dan file takarir SRT pendamping.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
avataropsional
Tipestring | null
BawaanAbigail Sofa Front
Nama yang mengidentifikasi avatar yang memenuhi syarat untuk Avatar V.
promptopsional
Tipestring | null
Teks ucapan untuk avatar; wajib diisi jika `audio_url` dihilangkan.
voiceopsional
Tipeenum
BawaanWarm Pro Narrator
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyPatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabella
+86 lainnyaAndrewSpuds 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
Pemilihan suara avatar berdasarkan nama untuk text-to-speech; hanya berlaku tanpa `audio_url`.
audio_urlopsional audio
Tipeurl · audio
Sumber sinkronisasi bibir yang diberikan sebagai URL file audio HTTP(S), menggantikan text-to-speech jika tersedia. Dalam kasus tersebut, `prompt` dan `voice` tidak digunakan.
fitopsional
Tipeenum
Bawaancover
containcover
Pilih pembingkaian avatar: 'cover' memenuhi bingkai output tetapi mungkin memotong avatar, sedangkan 'contain' menampilkan seluruh avatar tetapi mungkin menambahkan bilah hitam.
remove_backgroundopsional
Tipeboolean
Bawaanfalse
Penghapusan latar belakang avatar; hanya tersedia untuk avatar yang mendukung matting.
backgroundopsional
Tipeobject
Lapisan latar belakang yang secara opsional ditempatkan di belakang avatar, kecuali dengan `output_format='webm'`: output webm transparan mengabaikan pengaturan ini.
background.typeopsional
Tipeenum
Bawaancolor
colorimage
Jenis latar belakang: `color` menentukan warna heksadesimal solid, sedangkan `image` menentukan URL gambar.
background.valueopsional
Tipestring
Bawaan#FFFFFF
Konten latar belakang: warna heksadesimal jika jenisnya `color`, atau URL HTTP(S) jika jenisnya `image`.
watermarkopsional
Tipeobject
Gambar opsional yang digunakan sebagai overlay tanda air pada video yang dibuat.
watermark.image_urlwajib
Tipeurl · image
URL gambar tanda air menggunakan HTTP(S), untuk ditumpangkan pada video.
watermark.scaleopsional
Tipenumber | null
≤ 2, > 0
Ukuran tanda air relatif terhadap video, lebih besar dari 0.0 dan hingga 2.0.
watermark.opacityopsional
Tipenumber | null
0 – 1
Tingkat transparansi tanda air: 0.0 sepenuhnya transparan dan 1.0 sepenuhnya buram.
watermark.placementopsional
Tipeenum
top-lefttop-rightbottom-leftbottom-right
Posisi tanda air di dalam video.
captionopsional
Tipeboolean
Bawaanfalse
Mengontrol pembuatan file teks SRT terpisah yang menyertai video.
output_formatopsional
Tipeenum
Bawaanmp4
mp4webm
Pemilihan kontainer video, dengan `webm` yang mengaktifkan transparansi melalui penghapusan latar belakang otomatis; dalam mode tersebut, `background` tidak berpengaruh.
resolutionopsional
Tipeenum
Bawaan720p
720p1080p4k
Preset resolusi untuk output yang dibuat.
aspect_ratioopsional
Tipeenum
Bawaan16:9
16:99:164:55:41:1auto
Pilihan rasio aspek video: 'auto' meminta HeyGen membaca dan mempertahankan rasio sumber, menggunakan '16:9' jika tidak dapat membacanya. Pilihan rasio eksplisit adalah '16:9', '9:16', '4:5', '5:4', dan '1:1'.
enable_safety_checkeropsional
Tipeboolean
Bawaantrue
Penyaringan dapat dilonggarkan dengan menetapkan false, jika pemanggil berwenang.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

Output

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
video
object {url, content_type, file_name, file_size}File video yang dihasilkan oleh Avatar V.
caption_file
object {url, content_type, file_name, file_size} | nullFile teks SRT yang dihasilkan saat `caption=True`, jika layanan menyediakannya.

Untuk agen AI: halaman ini dalam Markdown tersedia di https://doitong.com/id/developers/models/heygen/avatar5/digital-twin.md. Semua model dan panduan: https://doitong.com/developers/llms.txt