HeyGen: HeyGen Video
يولّد HeyGen Video مشاهد من 5–15 ثانية بحوار وأجواء ومؤثرات من النص أو صورة أولى أو مراجع بصرية وصوتية. يدعم نموذجه العام heygen-video-1 لقطات المنتجات والشخصيات، مع إعدادات مرجعية وإخراج MP4. تمنحه الأفعال الواضحة والمحصورة متطلبات إنتاج مفيدة.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
HeyGen Video هو نموذج HeyGen العام لتوليد المشاهد، وتعرّفه الشركة المصنّعة باسم heygen-video-1. ينشئ الموضوع والمكان والضوء والصوت معًا من متطلبات إبداعية. مدة كل مقطع 5–15 ثانية ويحتوي مساره الصوتي المولّد، بما يشمل الحوار والأجواء والمؤثرات. تتضمن مدخلات الإنتاج المفيدة وصف مشهد أو صورة منتج أو مادة تحدد شخصًا أو مكانًا أو حركة. والمادة الناتجة مشهد قصير لتقديم منتج أو إدراج تعريفي أو عرض عقار أو عمل فيديو محرر آخر.
تمنح ثلاثة أوضاع المدخلات أدوارًا مختلفة. ينشئ النص إلى فيديو مشهدًا من التوجيه. وتبدأ الصورة إلى فيديو حرفيًا من الصورة المقدّمة ثم تتبع المتطلبات للفعل. ويستخدم المرجع إلى فيديو صورًا وفيديو وصوتًا اختياريًا لتوجيه مشهد مركّب حديثًا؛ ويتطلب صورة مرجعية أو فيديو مرجعيًا واحدًا على الأقل. اختر صورة إطار أول عندما يجب أن يطابق التكوين الافتتاحي صورة ثابتة، أو مراجع عندما يجب أن يظهر شيء معروف في تكوين مختلف. يختلف نموذج المشاهد هذا عن محركات إخراج أفاتار HeyGen وسير عمل تركيب Video Agent.
يفضّل دليل الشركة المصنّعة توجيهات لقطة مفصلة ملموسة: موضوعًا واحدًا وموقعًا واحدًا وفعلًا محصورًا واحدًا، بكاميرا ثابتة أو تتحرك برفق. صف موضع الكاميرا أو قصد العدسة أو عمق المجال، والضوء وخامة السطح والمعالجة اللونية. اشرح مواضع تماس الأشياء عندما يعتمد الفعل على التلامس. ولمثال منتج أصلي، استخدم صورة مرجعية لقارورة سفر واطلب وقوفها على منضدة خشبية بينما يتحدث مقدم بجوارها، مع حركة كاميرا صغيرة نحو القارورة. افحص شكلها وموضعها وعلاماتها المرئية في النتيجة.
تدعم قوائم المراجع حتى تسع صور وثلاثة فيديوهات وثلاث مواد صوتية، بحد أقصى اثني عشر مرجعًا إجمالًا. وتُرقّم الصور والفيديوهات والصوت منفصلة في صيغة التوجيه لدى الشركة المصنّعة: الصورة الأولى <Picture 1>، والفيديو الأول <Video 1>. امنح كل مرجع دورًا وعرّفه صراحة في المتطلبات. يقرأ النموذج أول خمس ثوانٍ من كل فيديو مرجعي، لذا أعدّ الجزء المعني في البداية. ويحدد مرجع API أيضًا نسب الفيديو المرجعي بين 1:4 و4:1. المقطع الطويل الذي لا يحتوي الحركة المطلوبة إلا في نهايته إعداد ضعيف لنافذة الإدخال ذات الخمس ثوانٍ.
تقبل واجهة المراجع الموثّقة مورد HTTPS متاحًا مباشرة أو معرّف مادة مرفوعة أوbase64 داخل الطلب. يسرد الدليل أقصى أحجام الصور 16 MB عبر URL و5 MB داخل الطلب؛ وقد يصل الفيديو أو الصوت إلى 32 MB عبر URL و16 MB داخل الطلب. أعدّ مادة مصدر واضحة يسهل تمييز الموضوع المهم فيها ودون تعليمات متنافسة في مراجع مختلفة. احتفظ بالاتجاه المقصود في صورة الإطار الأول. تتعلق تفاصيل الإدخال هذه بسير عمل المراجع لدى الشركة المصنّعة وتساعد على تنظيم المواد الإبداعية للوضع المختار.
وجّه الصوت في المتطلبات نفسها مع الصورة. حدّد الحوار والإلقاء الصوتي وصوت الغرفة والمؤثرات المحددة، بما يشمل قرب الصوت أو بعده. حدّد معالجة الموسيقى المقصودة عندما يجب أن يحوي المشهد الكلام والأجواء فقط. يقترح الدليل السماح بنحو 2.5 كلمة منطوقة في الثانية كتقدير تخطيطي، لذا اترك مجالًا للتوقفات والفعل المرئي. ويمكن تخطيط مقدمة قصيرة في عبارة واحدة تتبعها لحظة قصيرة تكشف المنتج. استمع إلى الكلمات الفعلية ومدى مناسبة الصوت المولّد للمكان والفعل.
تُختار مدة الإخراج بثوانٍ صحيحة من خمس إلى خمس عشرة، مع خمس ثوانٍ افتراضيًا. الدقة فئة حجم: 480p أو768p أو1080p أو2k. اختيارات التأطير الموثّقة هي 21:9 و16:9 و4:3 و1:1 و3:4 و9:16. وللنص والمرجع إلى فيديو بدقة 1080p أو2k، اختر 16:9 أو9:16؛ ويوثّق التأطير المرجعي التكيفي عند 480p و768p. تتبع الصورة إلى فيديو نسب الصورة الأولى، لذا اقتطع قبل التوليد عندما يتغير الشكل المطلوب. راجع الأبعاد الفعلية للنتيجة المكتملة بدل افتراض أن اسم فئة الحجم يعني زوج بكسلات تقليديًا واحدًا.
يحدد دليل النموذج فيديو MP4 بترميز صورة H.264 وصوت AAC عند 32 kHz ستيريو. تُعالج عملية التوليد بصورة غير متزامنة، وتوفر المهمة المكتملة موقع الفيديو القابل للتشغيل ومدته وأبعاده. ويمكن تحديث موقعه الموقّع باسترجاع المهمة مجددًا. احتفظ بالمقطع الفعلي والمواد المرجعية والمتطلبات لمراجعة التحرير. يتتبّع سجل الانتظار أو المعالجة التوليد؛ أما الفيديو المكتمل فمادة الإنتاج المطلوب تقييم صورتها وكلامها وصوتها.
توثّق الشركة المصنّعة اختيارات تحسين التوجيه turbo وquality وdisabled؛ ويحافظ disabled على الصياغة المُعدّة كما كُتبت. تفيد البذرة الثابتة عند مقارنة تغيير في عبارة واحدة مع إبقاء المدخلات الأخرى. سجّل البذرة والإعدادات المختارة مع متطلبات اللقطة. وللحروف على الشاشة، اجعل العبارة المقصودة قصيرة واكتبها بدقة؛ ويوصي الدليل بتركيب الفقرات والخط الصغير والمخططات المسماة لاحقًا. تحقّق من كل محرف مرئي في عنوان مولّد بدل افتراض نقل الصياغة بصورة صحيحة.
يحدد الدليل النص الطويل على الشاشة والحركة العضوية الرقيقة مثل البتلات أو الورق أو الشعر والتعامل مع الأشياء بالأيدي عن قرب مجالات أقل موثوقية. ولشرح إجرائي، دع عبارة مكتوبة بوضوح توصل الخطوات بينما تعرض الصورة شخصًا أو شيئًا ثابتًا؛ واستخدم مرئيات متحققًا منها منفصلة عندما يجب أن تكون العملية الفيزيائية نفسها دقيقة. راجع اللقطة كلها لاستمرارية الشيء والتماس وتفاصيل الوجه واليد والحوار والصوت. وتجعل قائمة موجزة بما يجب تغييره في اللقطة التالية متطلبات الإنتاج المفصّلة عملية وقابلة للتنفيذ.
Ailoot Ultra · فيديو POST /v1/videos heygen/heygen-video-1
heygen/heygen-video-1البداية
يولّد HeyGen Video مشاهد من 5–15 ثانية بحوار وأجواء ومؤثرات من النص أو صورة أولى أو مراجع بصرية وصوتية. يدعم نموذجه العام heygen-video-1 لقطات المنتجات والشخصيات، مع إعدادات مرجعية وإخراج MP4. تمنحه الأفعال الواضحة والمحصورة متطلبات إنتاج مفيدة.
- المدخلات المقبولة
- النص · الصور · الصوت · فيديو
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · فيديو POST /v1/videos
- الإدخال
text,image,audio,video- الإخراج
video- صيغة الإخراج
- بايتات MP4 الأصلية؛ دون تطبيع أو إعادة ترميز
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود heygen/heygen-video-1 | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلبمطلوب | القيم والحدود 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 الحد الأدنى: 1 الحد الأقصى: 600 | القيمة الافتراضية— |
الحقلresolution | النوعstring | المتطلباختياري | القيم والحدود 480p, 768p, 2K | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلباختياري | القيم والحدود 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | القيمة الافتراضية— |
الحقلgenerate_audio | النوعboolean | المتطلباختياري | القيم والحدود false | القيمة الافتراضية— |
الحقلframe_images | النوعarray | المتطلباختياري | القيم والحدود الحد الأدنى للعناصر: 1 الحد الأقصى للعناصر: 1 محتوى الإدخال: مصفوفة من كائنات الإطارات. يحتوي كل كائن على type=image_url وimage_url الذي يحتوي على url، وعلى frame_type. استخدم عنوان URL لصورة عبر HTTPS واضبط frame_type على first_frame. لا يتكرر كل دور إطار أكثر من مرة. المفاتيح الدقيقة: type, image_url, frame_type الشروط: تصف هذه المفاتيح كل كائن إطار؛ ولا يحتوي image_url إلا على url. احذف frame_images في الطلبات النصية فقط. | القيمة الافتراضية— |
الحقلinput_references | النوعarray | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلseed | النوعinteger | المتطلباختياري | القيم والحدود الحد الأدنى: -9,223,372,036,854,775,808 الحد الأقصى: 9,223,372,036,854,775,807 | القيمة الافتراضية— |
الحقلcallback_url | النوعstring | المتطلباختياري | القيم والحدود النمط: ^https:// | القيمة الافتراضية— |
الحقلsession_id | النوعstring | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلtrace | النوعobject | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلuser | النوعstring | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
تركيبات مواد الإدخال
تحويل النص إلى فيديو · موجّه نصي. · مطلوب: model, prompt, duration
قدّم prompt كنص وduration بعدد صحيح من الثواني. اختر دقة مدعومة ونسبة أبعاد عند الحاجة.
model: النوع: string · heygen/heygen-video-1
prompt: النوع: string · الحد الأقصى لبايتات UTF-8: 10,000 · يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم
تحويل الصورة إلى فيديو · موجّه نصي وصورة للإطار الأول. · مطلوب: model, prompt, duration, frame_images
الحقل frame_images مصفوفة. يحتوي كل كائن إطار على type وimage_url وframe_type؛ ويحتوي image_url على url. اضبط type على image_url. استخدم first_frame. لا يتكرر كل دور إطار أكثر من مرة. وفّر عنوان URL عاماً لصورة عبر HTTPS لكل إطار. اختر دقة مدعومة ونسبة أبعاد عند الحاجة.
المفاتيح الدقيقة: type, image_url, frame_type
model: النوع: string · heygen/heygen-video-1
prompt: النوع: string · الحد الأقصى لبايتات UTF-8: 10,000 · يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم
Reference to video · موجّه نصي ومراجع صور وفيديو وصوت مدعومة. · مطلوب: model, prompt, duration, input_references
الحقل input_references مصفوفة كائنات. اضبط type على image_url أو video_url أو audio_url، واستخدم الحقل المطابق الذي يحتوي على url. استخدم عناوين URL عامة عبر HTTPS. احذف frame_images لاختيار نمط المراجع. اختر دقة مدعومة ونسبة أبعاد عند الحاجة.
model: النوع: string · heygen/heygen-video-1
prompt: النوع: string · الحد الأقصى لبايتات UTF-8: 10,000 · يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt, duration |
المعلمةmaterial_types | المواصفاتtext, image, audio, video |
المعلمةadditional_properties | المواصفاتfalse |
المعلمةoptional_controls | المواصفاتresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
دورة الحياة: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
الباقات
كيفية احتساب الرسوم النهائية
تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات تقديرية للمقارنة
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | وحدة الفوترة | شروط الفوترة | الرسوم |
|---|---|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | وحدة الفوترة— | شروط الفوترة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةresolution: 2k | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.2 لكل ثانية فيديو |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةresolution: 480p | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.04 لكل ثانية فيديو |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةresolution: 768p | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.072 لكل ثانية فيديو |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةنمط التوليد: reference؛ الدقة: 2k | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.36 لكل ثانية فيديو |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةنمط التوليد: reference؛ الدقة: 480p | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.14 لكل ثانية فيديو |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةنمط التوليد: reference؛ الدقة: 768p | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.2 لكل ثانية فيديو |
| الإعداداتصورة إدخال مرجعية | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل صورة إدخال مرجعية | شروط الفوترة— | الرسوم الإدخال · صورة إدخال مرجعية · تقدير للمقارنة فقط $0.08 لكل صورة إدخال مرجعية |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | وحدة الفوترة— | شروط الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.2 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
تفاصيل التعرفة المرجعية
لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.
مراجع أسعار إعدادات الفيديو
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | شروط الفوترة | الرسوم |
|---|---|---|
| الإعداداتسعر الفيديو | شروط الفوترةresolution: 2k | الرسوم الإخراج · سعر الفيديو $0.18 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةresolution: 480p | الرسوم الإخراج · سعر الفيديو $0.04 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةresolution: 768p | الرسوم الإخراج · سعر الفيديو $0.06 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةنمط التوليد: reference؛ الدقة: 2k | الرسوم الإخراج · سعر الفيديو $0.36 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةنمط التوليد: reference؛ الدقة: 480p | الرسوم الإخراج · سعر الفيديو $0.08 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةنمط التوليد: reference؛ الدقة: 768p | الرسوم الإخراج · سعر الفيديو $0.12 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
أمثلة للطلبات
Ailoot Ultra · فيديو
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"heygen/heygen-video-1","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
استلام النتائج وحفظها
Ailoot Ultra · فيديو
عناوين URL موقّعة لمحتوى مملوك لك
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
التحقق من حالة المهمة
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
عمليات أخرى لقراءة المحتوى
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
الاحتفاظ بكل النتائج المكتملة
احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.
احتفظ بكل مخرج فعلي مملوك لك وبالبيانات الوصفية المقاسة المُعادة معه.
عند الحاجة إلى التحقق من الاستجابة الأصلية
503 result_pending_check + المعرّف الأصلي + X-Should-Retry:false؛ لا تعِد تنفيذ العملية الأصلية مطلقاً
حقول الاستجابة
| الحقل | النوع | المعنى |
|---|---|---|
الحقلindex | النوعinteger | المعنىموضع هذا الفيديو في قائمة المخرجات، بدءاً من الصفر. |
الحقلcontent_url | النوعstring | المعنىعنوان URL موقّع عبر HTTPS لتنزيل هذا الفيديو المكتمل. |
الحقلsha256 | النوعstring | null | المعنىبصمة SHA-256 لبايتات الفيديو الأصلي؛ وتكون القيمة null إذا لم تتوفر. |
الحقلsize_bytes | النوعinteger | null | المعنىحجم ملف الفيديو الأصلي بالبايت؛ وتكون القيمة null إذا لم يتوفر. |
الحقلduration_ms | النوعinteger | null | المعنىمدة الفيديو المقاسة بالمللي ثانية؛ وتكون القيمة null إذا لم تتوفر. |
الحقلwidth | النوعinteger | null | المعنىعرض الفيديو بالبكسل؛ وتكون القيمة null إذا لم يتوفر. |
الحقلheight | النوعinteger | null | المعنىارتفاع الفيديو بالبكسل؛ وتكون القيمة null إذا لم يتوفر. |
الحقلvideo_codec | النوعstring | null | المعنىمعرّف ترميز الفيديو؛ وتكون القيمة null إذا لم يُسجَّل. |
الحقلhas_audio | النوعboolean | null | المعنىما إذا كان الفيديو يحتوي على مسار صوتي؛ وتكون القيمة null إذا لم يُقَس ذلك. |
الحقلaudio_codec | النوعstring | null | المعنىمعرّف ترميز الصوت؛ وتكون القيمة null إذا لم يُسجَّل معرّف. |
الأخطاء والخطوات التالية
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة404 · not_found_error | الشرطالوصول إلى الفيديو غير متاح، أو لم يُعثر على معرّف الفيديو هذا. | الخطوة التاليةتحقق من الوصول إلى الفيديو. للفيديو الموجود، استخدم معرّفه العام الأصلي ومفتاح API نفسه. |
الاستجابة401 · authentication_error | الشرطمفتاح API لا يطابق الحساب الذي تمت المصادقة عليه. | الخطوة التاليةتحقق من مفتاح API وإمكانية وصول حسابك قبل الإرسال. |
الاستجابة400 · invalid_request_error | الشرطتعذرت قراءة الطلب، أو فهرس التنزيل غير صالح. | الخطوة التاليةصحّح متن الطلب. للتنزيل، اختر فهرس مخرج أعادته المهمة الأصلية. |
الاستجابة422 · price_unavailable | الشرطيتعذر تسعير إعداد الفيديو المختار. | الخطوة التاليةاختر إعداد فيديو مدعوماً وأكمل خياراته المطلوبة قبل إرسال طلب مصحح. |
الاستجابة422 · invalid_request_error | الشرطإدخال الفيديو أو مهمة المتابعة الأصلية غير صالح. | الخطوة التاليةاستخدم مدخلات HTTPS صالحة. للمتابعة، استخدم المعرّف العام للفيديو الأصلي المكتمل لديك مع مفتاح API نفسه. |
الاستجابة402 · billing_error | الشرطالرصيد المتاح أو الحدود المقررة لا تسمح بحجز الرصيد. | الخطوة التاليةتحقق من رصيدك المتاح وحدودك قبل إرسال طلب جديد. |
الاستجابة503 · server_error | الشرطالتحقق من الفيديو أو التخزين أو الوصول إلى الخدمة غير متاح مؤقتاً. | الخطوة التاليةانتظر إتاحة الخدمة. إذا كان لديك معرّف فيديو بالفعل، فتحقق من تلك المهمة الأصلية بدلاً من إنشاء عملية توليد أخرى. |
الاستجابة503 · result_pending_check | الشرطتحتاج نتيجة الفيديو الأصلية والرسم المحتسب إلى التحقق. | الخطوة التاليةاحتفظ بمعرّف الفيديو المُعاد وتحقق من تلك المهمة. لا ترسل طلب توليد بديل أثناء التحقق منها. |
الاستجابة503 · owned_result_unavailable | الشرطتنزيل الفيديو الموجود غير متاح مؤقتاً. | الخطوة التاليةتحقق من مهمة الفيديو نفسها لاحقاً ونزّل مخرجها الموجود. ينشئ التوليد الجديد عملية منفصلة. |
الاستجابة409 · video_not_ready | الشرطلم يُنشر محتوى الفيديو. | الخطوة التاليةتحقق من حالة المهمة الأصلية. نزّل المخرجات بعد أن تُبلِغ عن completed؛ وإذا أبلغت عن failed، فاتبع إشعارها المتعلق بالتحقق من الرسم المحتسب. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra heygen/heygen-video-1
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · HeyGen: HeyGen Video
- ما المدخلات والنتائج المتاحة؟
POST /v1/videos·heygen/heygen-video-1:text,image,audio,video→video- ما الحقول التي يستخدمها الطلب؟
POST /v1/videos·heygen/heygen-video-1:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,seed,callback_url,session_id,trace,user- ما الحدود المطبقة؟
POST /v1/videos·heygen/heygen-video-1:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807