استخدم Seedance في Hermes Agent.
يُنشئ Seedance 2.0 مقاطع فيديو مدتها 4–15 ثانية بدقة تصل إلى 1080p مع فوترة بالثانية تبدأ من حوالي $0.05/ثانية — أدنى تكلفة بالثانية بين نماذج الفيديو في RunAPI. يدعم مدخلات مرجعية متعددة الوسائط (صور وفيديو وروابط صوتية)، والتحكم في الإطار الأول والأخير، ومزامنة الصوت الأصلية. يستدعيه Hermes Agent عبر نقطة النهاية المخصصة في RunAPI — ضبط custom:runapi مرة واحدة وأعد استخدام نفس المفتاح.
Generate a product showcase video using Seedance 2.0 through RunAPI.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- Call POST https://runapi.ai/api/v1/seedance/text_to_video
- Set model to "seedance-2.0".
- Set prompt to describe the video scene.
- Set duration_seconds to the desired length (4–15).
- Set aspect_ratio to "16:9" for landscape video.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the video URL from the response output.
curl -X POST https://runapi.ai/api/v1/seedance/text_to_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0",
"prompt": "A ceramic coffee mug rotates slowly on a wooden table, steam rising, warm morning light from a window, cinematic",
"duration_seconds": 8,
"aspect_ratio": "16:9",
"output_resolution": "1080p"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "seedance-2.0"
}
استخدم Seedance في Hermes Agent في ثلاث خطوات
ضبط RunAPI
عيّن RUNAPI_API_KEY في البيئة التي يعمل فيها Hermes Agent. إذا كنت قد أضفت RunAPI كمزوّد custom:runapi للدردشة من قبل، فإن نفس المفتاح و base_url يتعاملان مع توليد الفيديو. إذا لم يكن كذلك، أضف المزوّد المخصص بـ base_url https://runapi.ai/v1 وشغّل hermes doctor.
export RUNAPI_API_KEY=runapi_xxx
استدعاء Seedance text_to_video
أرسل طلب POST إلى نقطة نهاية text_to_video مع تعيين النموذج إلى seedance-2.0. أضف prompt و duration_seconds (4–15) و aspect_ratio و output_resolution. يمكنك اختياريًا إرفاق first_frame_image_url أو reference_image_urls أو reference_audio_urls للتحكم متعدد الوسائط. يرسل Hermes Agent هذا عبر مزوّد custom:runapi.
POST /api/v1/seedance/text_to_video
الاستطلاع للحصول على النتيجة
تُعيد نقطة النهاية task_id فورًا. استطلع نقطة نهاية حالة المهمة حتى تصبح الحالة completed، ثم اقرأ رابط الفيديو الناتج من الاستجابة. الفوترة بالثانية بناءً على مدة الفيديو المُنشأ ودقته.
GET /api/v1/seedance/text_to_video/tsk_abc123
معاملات Seedance API
| المعامل | النوع | الوصف |
|---|---|---|
model |
string |
مطلوب. seedance-2.0, seedance-2.0-fast, seedance-1.5-pro, seedance-v1-pro, seedance-v1-lite. |
prompt |
string |
مطلوب. وصف نصي لمشهد الفيديو المراد إنشاؤه. |
duration_seconds |
integer |
مدة الفيديو بالثواني. 4–15 لـ Seedance 2.0، و5 أو 10 لإصدارات v1. |
aspect_ratio |
string |
نسبة العرض إلى الارتفاع. المقبولة: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto. |
output_resolution |
string |
دقة الفيديو. المقبولة: 480p, 720p, 1080p. الدقة الأعلى تكلّف أكثر بالثانية. |
first_frame_image_url |
string |
اختياري. رابط صورة تُستخدم كإطار أول. يتيح سير عمل الصورة إلى فيديو. |
last_frame_image_url |
string |
اختياري. رابط صورة تُستخدم كإطار أخير. يقيّد المشهد الختامي. |
reference_image_urls |
array |
اختياري. روابط صور مرجعية للتوجيه بالوضعية أو العمق أو الحواف. |
reference_audio_urls |
array |
اختياري. روابط ملفات صوتية مرجعية لمزامنة الصوت الأصلي في الفيديو المُنشأ. |
reference_video_urls |
array |
اختياري. روابط مقاطع فيديو مرجعية لنقل الحركة أو الأسلوب. |
callback_url |
string |
اختياري. رابط Webhook يستقبل طلب POST عند اكتمال المهمة. |
ما هو Seedance في Hermes Agent؟
يُقدم Seedance 2.0 من ByteDance توليد فيديو في مرحلة واحدة بمخرجات صوتية ومرئية موحدة. يصفه المستخدمون بالأفضل في فئته للسرد القصصي متعدد اللقطات ودقة مزامنة الشفاه. عبر الموفر custom:runapi في Hermes Agent، ينتج مقاطع من 4 إلى 15 ثانية بدقة تصل إلى 1080p بالفوترة لكل ثانية.
حالات استخدام Seedance
روايات متعددة اللقطات مع انتقالات مشاهد
ابنِ تسلسلات فيديو متعددة اللقطات حيث تحافظ الشخصيات على تماسكها عبر انتقالات المشاهد.
سرد قصصي متزامن مع الصوت
قدّم مساراً صوتياً مرجعياً ودع Seedance يُنشئ فيديو يتطابق معه تماماً.
ما قبل التصور للمشاهد الانتقالية
أنشئ نماذج أولية للمشاهد الانتقالية للألعاب أو الأفلام بالحوار وانتقالات المشاهد للإنتاج المسبق.
أسئلة Seedance + Hermes Agent
نعم. ضبط RunAPI كمزوّد مخصص في Hermes Agent بـ base_url https://runapi.ai/v1، ثم استدع نقطة نهاية text_to_video مع تعيين النموذج إلى seedance-2.0. نفس مفتاح API يتعامل مع الدردشة وتوليد الفيديو.
تُفوتر بناءً على المدة الفعلية للفيديو المُنشأ ودقة الإخراج التي تختارها. فيديو 480p يكلف أقل بالثانية من 1080p. تُخصم التكلفة بعد اكتمال الفيديو لا عند إنشاء المهمة.
لا. يرسل Hermes Agent طلبات HTTP عبر مزوّد custom:runapi بنفس الطريقة التي يرسل بها طلبات الدردشة. تقبل نقطة نهاية text_to_video نص JSON وتُعيد معرّف المهمة. لا حاجة لإضافات أو امتدادات إضافية.
نعم. مرّر رابط صورة في المعامل first_frame_image_url مع مطالبة نصية. يستخدم Seedance الصورة كإطار افتتاحي ويُنشئ الحركة منها. يمكنك أيضًا تعيين last_frame_image_url لتقييد النهاية.
يُنشئ Seedance 2.0 مقاطع فيديو مدتها بين 4 و15 ثانية. عيّن المعامل duration_seconds بالمدة التي تريدها. الإصدارات الأقدم (v1-pro، v1-lite) تدعم فقط مدد ثابتة 5 أو 10 ثوانٍ. لمحتوى أطول، سلسل مقاطع متعددة باستخدام مطالبات متسقة للشخصية وتثبيت الإطار الأول والأخير.
إعداد Hermes Agent العام
لم تُهيّئه بعد؟ ابدأ بدليل إعداد RunAPI لـ Hermes Agent.
دليل إعداد Hermes Agent →جرّب Seedance في Hermes Agent اليوم.
احصل على مفتاح RunAPI مجاني، ضبط مزوّد custom:runapi، وأنشئ فيديو بالفوترة بالثانية مع Seedance 2.0.