Langkau ke kandungan

Heygen · Avatar4 · Image to Video

Integrasikan

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

Fail seperti contoh: $1.00 1,000 kredit API · ≈ ₽107.58 fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
HeyGen Lip-sync & Avatar Lip-syncsehingga 1080p #image-to-video

Menghidupkan satu foto wajah menjadi avatar bercakap, dengan gaya pertuturan stabil atau ekspresif

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

Teks yang akan dituturkan oleh avatar.

•diperlukan image_url
Lepaskan fail, atau

Sumber animasi yang dibekalkan sebagai URL imej; pilih imej dengan wajah yang jelas kelihatan.

audio_url
Lepaskan fail, atau

Audio penyegerakan bibir yang dibekalkan melalui URL fail, mengutamakan prompt dan suara apabila tersedia.

resolution lalai 720p

Pratetap resolusi untuk video: 360p, 480p, 540p, 720p atau 1080p.

aspect_ratio lalai 16:9

Pilihan nisbah aspek video: 'auto' meminta HeyGen membaca dan mengekalkan nisbah sumber, menggunakan '16:9' jika gagal. Pilihan nisbah eksplisit ialah '16:9', '9:16', '4:5', '5:4' dan '1:1'.

Lanjutan talking_style · voice · expression · caption · enable_safety_checker · background
talking_style lalai stable

Gaya animasi pertuturan: 'stable' mengekalkan pergerakan minimum, manakala 'expressive' menambah lebih banyak animasi.

Nama suara yang digunakan untuk memilih suara avatar.

Ekspresi pada wajah.

Tetapan untuk latar belakang.

POST /run/heygen/avatar4/image-to-video?wait=20 sebut 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/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"

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 Heygen · Avatar4 · Image to Video

Menukar satu imej yang mengandungi wajah jelas kepada video avatar bercakap. Berikan `prompt` dengan teks untuk dituturkan serta nama `voice`, atau berikan `audio_url`, yang mengatasi kedua-duanya. `talking_style` bertukar antara stable (pergerakan minimum) dan expressive. Anda juga boleh menetapkan ekspresi, latar belakang, kapsyen pilihan serta resolusi daripada 360p hingga 1080p.

Parameter

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

NamaJenis LalaiDibenarkan Penerangan
image_urldiperlukan image
Jenisurl · image
Sumber animasi yang dibekalkan sebagai URL imej; pilih imej dengan wajah yang jelas kelihatan.
promptpilihan
Jenisstring | null
Teks yang akan dituturkan oleh avatar.
voicepilihan
Jenisenum
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyPatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabella
+86 lagiAndrewSpuds 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
Nama suara yang digunakan untuk memilih suara avatar.
audio_urlpilihan audio
Jenisurl · audio
Audio penyegerakan bibir yang dibekalkan melalui URL fail, mengutamakan prompt dan suara apabila tersedia.
talking_stylepilihan
Jenisenum
Lalaistable
stableexpressive
Gaya animasi pertuturan: 'stable' mengekalkan pergerakan minimum, manakala 'expressive' menambah lebih banyak animasi.
expressionpilihan
Jenisstring | null
Ekspresi pada wajah.
backgroundpilihan
Jenisobject
Tetapan untuk latar belakang.
background.typepilihan
Jenisenum
Lalaicolor
colorimagevideo
Pemilihan jenis latar belakang.
background.valuepilihan
Jenisstring
Lalai#FFFFFF
Kandungan latar belakang: warna heksadesimal apabila jenisnya 'color', atau URL apabila jenisnya 'image' atau 'video'.
resolutionpilihan
Jenisenum
Lalai720p
360p480p540p720p1080p
Pratetap resolusi untuk video: 360p, 480p, 540p, 720p atau 1080p.
aspect_ratiopilihan
Jenisenum
Lalai16:9
16:99:164:55:41:1auto
Pilihan nisbah aspek video: 'auto' meminta HeyGen membaca dan mengekalkan nisbah sumber, menggunakan '16:9' jika gagal. Pilihan nisbah eksplisit ialah '16:9', '9:16', '4:5', '5:4' dan '1:1'.
captionpilihan
Jenisboolean
Lalaifalse
Mengawal sama ada video menyertakan kapsyen.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
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": "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"
  }
}
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 terhasil.

Lebih banyak model: Lip-sync & Avatar

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/heygen/avatar4/image-to-video.md. Semua model dan panduan: https://doitong.com/developers/llms.txt