דילוג לתוכן

Heygen v5 Digital Twin

שילוב

מזהה מודל 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"

קבצים כמו בדוגמה: ⁨‏1.00 ‏$⁩ 1,000 קרדיטי API · ≈ ⁨‏107.58 ‏₽⁩ הקבצים שלכם נמדדים לפני ההרצה הרצה בדף הזה

קבלת מפתח API
HeyGen סנכרון שפתיים ואווטארים פלט 4Kסנכרון שפתייםעד 4k #avatar#digital-twin#talking-avatar#text-to-video

תאום דיגיטלי אווטאר V עם פלט 4k, ‏WebM שקוף, רקע, סימן מים וכיתובי SRT

HeyGen · ווידאו

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

הפקדים נוצרים מסכמת המודל. הקוד והמחיר מתעדכנים כשמשנים אותם.

טקסט הדיבור של האווטאר; נדרש אם `audio_url` מושמט.

audio_url
גרור קובץ, או

מקור לסנכרון שפתיים, המסופק ככתובת URL של קובץ אודיו מסוג HTTP(S), ומחליף המרת טקסט לדיבור כאשר הוא קיים. במקרה זה לא נעשה שימוש ב-`prompt` או ב-`voice`.

resolution ברירת מחדל 720p

קביעת הרזולוציה של הפלט שנוצר.

aspect_ratio ברירת מחדל 16:9

בחירת יחס הגובה-רוחב של הווידאו: 'auto' מבקש מ-HeyGen לקרוא ולשמור את יחס המקור, תוך שימוש ב-'16:9' אם אינו יכול. אפשרויות היחס המפורשות הן '16:9', '9:16', '4:5', '5:4', ו-'1:1'.

מתקדם fit · output_format · avatar · voice · remove_background · caption · enable_safety_checker · background · watermark
fit ברירת מחדל cover

בחירת מסגור האווטאר: 'cover' ממלא את פריים הפלט אך עשוי לחתוך את האווטאר, ואילו 'contain' מציג את האווטאר בשלמותו אך עשוי להוסיף פסים שחורים.

output_format ברירת מחדל mp4

בחירת מכל הווידאו, כאשר `webm` מאפשר שקיפות באמצעות הסרת רקע אוטומטית; במצב זה ל-`background` אין השפעה.

ברירת מחדל Abigail Sofa Front

שם המזהה אווטאר המתאים ל-Avatar V.

ברירת מחדל Warm Pro Narrator

בחירת קול האווטאר לפי שם להמרת טקסט לדיבור; חל רק ללא `audio_url`.

שכבת רקע שממוקמת באופן אופציונלי מאחורי האווטאר, למעט עם `output_format='webm'`: פלט webm שקוף מתעלם מהגדרה זו.

תמונה אופציונלית המשמשת כשכבת סימן מים בווידאו שנוצר.

POST /run/heygen/avatar5/digital-twin?wait=20 הצעת מחיר → ⁨‏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"

הרצת הבקשה הזו

המפתח שלך נשאר בדפדפן הזה: הוא נשלח רק אל Doitong API ונשמר ב-localStorage רק אם מסמנים זכור. קבל מפתח API

מידע על Heygen v5 Digital Twin

יוצר סרטון אווטאר מדבר מטקסט (`prompt` ו-`voice`) או מ-`audio_url` לסנכרון שפתיים. בוחרים `avatar` בשם, מצב `fit` מסוג contain או cover ורזולוציה של 720p, 1080p או 4k. `output_format` יכול להיות mp4 או webm; webm שקוף. האפשרויות כוללות שילוב רקע, שכבת סימן מים וקובץ כתוביות SRT נלווה.

פרמטרים

שלח את השם הקנוני או את השם המקומי, לא את שניהם. שמות קנוניים

שםסוג ברירת מחדלמותר תיאור
avatarאופציונלי
סוגstring | null
ברירת מחדלAbigail Sofa Front
שם המזהה אווטאר המתאים ל-Avatar V.
promptאופציונלי
סוגstring | null
טקסט הדיבור של האווטאר; נדרש אם `audio_url` מושמט.
voiceאופציונלי
סוגenum
ברירת מחדלWarm Pro Narrator
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyPatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabella
עוד 86AndrewSpuds 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
בחירת קול האווטאר לפי שם להמרת טקסט לדיבור; חל רק ללא `audio_url`.
audio_urlאופציונלי audio
סוגurl · audio
מקור לסנכרון שפתיים, המסופק ככתובת URL של קובץ אודיו מסוג HTTP(S), ומחליף המרת טקסט לדיבור כאשר הוא קיים. במקרה זה לא נעשה שימוש ב-`prompt` או ב-`voice`.
fitאופציונלי
סוגenum
ברירת מחדלcover
containcover
בחירת מסגור האווטאר: 'cover' ממלא את פריים הפלט אך עשוי לחתוך את האווטאר, ואילו 'contain' מציג את האווטאר בשלמותו אך עשוי להוסיף פסים שחורים.
remove_backgroundאופציונלי
סוגboolean
ברירת מחדלfalse
הסרת רקע מהאווטאר; זמינה רק לאווטארים התומכים בהפרדת חזית ורקע.
backgroundאופציונלי
סוגobject
שכבת רקע שממוקמת באופן אופציונלי מאחורי האווטאר, למעט עם `output_format='webm'`: פלט webm שקוף מתעלם מהגדרה זו.
background.typeאופציונלי
סוגenum
ברירת מחדלcolor
colorimage
סוג הרקע: `color` מציין צבע הקסדצימלי אחיד, ואילו `image` מציין כתובת URL של תמונה.
background.valueאופציונלי
סוגstring
ברירת מחדל#FFFFFF
תוכן הרקע: צבע הקסדצימלי כאשר הסוג הוא `color`, או כתובת URL מסוג HTTP(S) כאשר הסוג הוא `image`.
watermarkאופציונלי
סוגobject
תמונה אופציונלית המשמשת כשכבת סימן מים בווידאו שנוצר.
watermark.image_urlחובה
סוגurl · image
כתובת URL של תמונת סימן המים באמצעות HTTP(S), להוספה מעל הווידאו.
watermark.scaleאופציונלי
סוגnumber | null
≤ 2, > 0
גודל סימן המים ביחס לווידאו, גדול מ-0.0 ועד 2.0.
watermark.opacityאופציונלי
סוגnumber | null
0 – 1
רמת השקיפות של סימן המים: 0.0 שקוף לחלוטין ו-1.0 אטום לחלוטין.
watermark.placementאופציונלי
סוגenum
top-lefttop-rightbottom-leftbottom-right
מיקום סימן המים בתוך הווידאו.
captionאופציונלי
סוגboolean
ברירת מחדלfalse
קובע אם נוצר קובץ כתוביות SRT נפרד לצד הווידאו.
output_formatאופציונלי
סוגenum
ברירת מחדלmp4
mp4webm
בחירת מכל הווידאו, כאשר `webm` מאפשר שקיפות באמצעות הסרת רקע אוטומטית; במצב זה ל-`background` אין השפעה.
resolutionאופציונלי
סוגenum
ברירת מחדל720p
720p1080p4k
קביעת הרזולוציה של הפלט שנוצר.
aspect_ratioאופציונלי
סוגenum
ברירת מחדל16:9
16:99:164:55:41:1auto
בחירת יחס הגובה-רוחב של הווידאו: 'auto' מבקש מ-HeyGen לקרוא ולשמור את יחס המקור, תוך שימוש ב-'16:9' אם אינו יכול. אפשרויות היחס המפורשות הן '16:9', '9:16', '4:5', '5:4', ו-'1:1'.
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
ניתן להקל את הסינון באמצעות הגדרה ל-false, אם הצד הקורא מורשה לכך.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 10 MB, או את file_url של העלאה. קבצים

פלט

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"
  }
}
הקבצים שלכם, הבחירה שלכםכל outputs[].url הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
video
object {url, content_type, file_name, file_size}קובץ הווידאו שהופק על ידי Avatar V.
caption_file
object {url, content_type, file_name, file_size} | nullקובץ כתוביות SRT שנוצר כאשר `caption=True`, אם השירות מספק אותו.

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/heygen/avatar5/digital-twin.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt