مواد پر جائیں

Heygen v5 Digital Twin

انٹیگریٹ کریں

ماڈل id 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

مثال جیسی فائلیں: ⁨$1.00⁩ 1,000 API کریڈٹس آپ کی فائلیں رن سے پہلے ناپی جاتی ہیں اس صفحے پر چلائیں

API کلید حاصل کریں
HeyGen لِپ سنک اور اوتار 4K آؤٹ پٹلِپ سنک4k تک #avatar#digital-twin#talking-avatar#text-to-video

اوتار V ڈیجیٹل ٹوئن، 4k آؤٹ پٹ، شفاف WebM، پس منظر، واٹرمارک اور SRT کیپشنز کے ساتھ

HeyGen · ویڈیو

آپ کا پہلا نتیجہ یہاں آئے گا

ذیل میں درخواست بنائیں اور اپنی API کلید کے ساتھ چلائیں۔ آؤٹ پٹس ہمارے اسٹوریج میں کاپی ہو جاتے ہیں، ہمیشہ کے لیے یا مفت میں 7 دن تک محفوظ رہتے ہیں۔

درخواست بنائیں

کنٹرولز ماڈل اسکیما سے تیار ہوتے ہیں۔ آپ کے بدلنے کے ساتھ کوڈ اور قیمت اپ ڈیٹ ہوتے ہیں۔

اوتار کے لیے تقریر کا متن؛ اگر `audio_url` موجود نہ ہو تو ضروری ہے۔

audio_url
فائل ڈراپ کریں، یا

Lip-sync کا ماخذ، جو HTTP(S) آڈیو فائل URL کے طور پر فراہم کیا جاتا ہے اور موجود ہونے پر متن سے تقریر کی جگہ لیتا ہے۔ اس صورت میں `prompt` اور `voice` استعمال نہیں ہوتے۔

resolution ڈیفالٹ 720p

تخلیق کردہ آؤٹ پٹ کے لیے ریزولوشن پری سیٹ۔

aspect_ratio ڈیفالٹ 16:9

ویڈیو aspect-ratio selection: 'auto' HeyGen سے source ratio پڑھ کر برقرار رکھنے کو کہتا ہے؛ ناکامی کی صورت میں '16:9' استعمال ہوتا ہے۔ واضح ratio choices '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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

یہ درخواست چلائیں

آپ کی key اسی براؤزر میں رہتی ہے: یہ صرف Doitong API کو بھیجی جاتی ہے اور صرف اس صورت میں localStorage میں محفوظ ہوتی ہے جب آپ Remember منتخب کریں۔ API کلید حاصل کریں

Heygen v5 Digital Twin کے بارے میں

ٹیکسٹ (`prompt` اور `voice`) یا لپ سنک کے لیے `audio_url` سے بولتے اوتار کی ویڈیو بناتا ہے۔ نامزد `avatar`، contain یا cover کا `fit` موڈ، اور 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
+86 مزیدAndrewSpuds 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
Lip-sync کا ماخذ، جو HTTP(S) آڈیو فائل URL کے طور پر فراہم کیا جاتا ہے اور موجود ہونے پر متن سے تقریر کی جگہ لیتا ہے۔ اس صورت میں `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` ہونے پر ہیکساڈیسیمل رنگ، یا قسم `image` ہونے پر HTTP(S) URL۔
watermarkاختیاری
قسمobject
تخلیق کردہ ویڈیو میں واٹرمارک کے طور پر اوورلے کی جانے والی اختیاری تصویر۔
watermark.image_urlلازمی
قسمurl · image
ویڈیو پر اوورلے کرنے کے لیے HTTP(S) کے ذریعے واٹرمارک تصویر کا URL۔
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
ویڈیو aspect-ratio selection: 'auto' HeyGen سے source ratio پڑھ کر برقرار رکھنے کو کہتا ہے؛ ناکامی کی صورت میں '16:9' استعمال ہوتا ہے۔ واضح ratio choices '16:9'، '9:16'، '4:5'، '5:4'، اور '1:1' ہیں۔
enable_safety_checkerاختیاری
قسمboolean
ڈیفالٹtrue
false سیٹ کر کے اسکریننگ نرم کی جا سکتی ہے، بشرطیکہ کال کرنے والا مجاز ہو۔
لازمی معیاری نام، یہ بھی قبول ہے

فائل پیرامیٹرز عوامی https:// URL، 10 MB تک کی data: URI، یا اپ لوڈ کے 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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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`caption=True` ہونے پر تیار کردہ SRT کیپشن فائل، اگر سروس فراہم کرے۔

AI ایجنٹس کے لیے: یہ صفحہ Markdown میں یہاں موجود ہے https://doitong.com/ur/developers/models/heygen/avatar5/digital-twin.md. تمام ماڈلز اور گائیڈز: https://doitong.com/developers/llms.txt