تخطّي إلى المحتوى

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
+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
مصدر مزامنة الشفاه، مُقدَّم كعنوان 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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 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`، إذا وفّره الخدمة.

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/heygen/avatar5/digital-twin.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt