---
title: "استخدام Seedance في Hermes Agent عبر RunAPI — دليل واجهة برمجة الفيديو"
url: "https://runapi.ai/ar/hermes-seedance.md"
canonical: "https://runapi.ai/ar/hermes-seedance"
locale: "ar"
model: "seedance"
---

# استخدم Seedance في Hermes Agent.

يُنشئ Seedance 2.0 مقاطع فيديو مدتها 4–15 ثانية بدقة تصل إلى 1080p مع فوترة بالثانية تبدأ من حوالي $0.05/ثانية — أدنى تكلفة بالثانية بين نماذج الفيديو في RunAPI. يدعم مدخلات مرجعية متعددة الوسائط (صور وفيديو وروابط صوتية)، والتحكم في الإطار الأول والأخير، ومزامنة الصوت الأصلية. يستدعيه Hermes Agent عبر نقطة النهاية المخصصة في RunAPI — ضبط custom:runapi مرة واحدة وأعد استخدام نفس المفتاح.

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "seedance-2.0"
}

```

## How it works

1. **ضبط RunAPI** — عيّن RUNAPI_API_KEY في البيئة التي يعمل فيها Hermes Agent. إذا كنت قد أضفت RunAPI كمزوّد custom:runapi للدردشة من قبل، فإن نفس المفتاح و base_url يتعاملان مع توليد الفيديو. إذا لم يكن كذلك، أضف المزوّد المخصص بـ base_url https://runapi.ai/v1 وشغّل hermes doctor.
2. **استدعاء 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.
3. **الاستطلاع للحصول على النتيجة** — تُعيد نقطة النهاية task_id فورًا. استطلع نقطة نهاية حالة المهمة حتى تصبح الحالة completed، ثم اقرأ رابط الفيديو الناتج من الاستجابة. الفوترة بالثانية بناءً على مدة الفيديو المُنشأ ودقته.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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 عند اكتمال المهمة. |

## FAQ

### هل يمكنني استخدام Seedance في Hermes Agent؟

نعم. ضبط RunAPI كمزوّد مخصص في Hermes Agent بـ base_url https://runapi.ai/v1، ثم استدع نقطة نهاية text_to_video مع تعيين النموذج إلى seedance-2.0. نفس مفتاح API يتعامل مع الدردشة وتوليد الفيديو.

### كيف تعمل الفوترة بالثانية في Seedance؟

تُفوتر بناءً على المدة الفعلية للفيديو المُنشأ ودقة الإخراج التي تختارها. فيديو 480p يكلف أقل بالثانية من 1080p. تُخصم التكلفة بعد اكتمال الفيديو لا عند إنشاء المهمة.

### هل يحتاج Hermes Agent إلى إضافة لتوليد الفيديو؟

لا. يرسل Hermes Agent طلبات HTTP عبر مزوّد custom:runapi بنفس الطريقة التي يرسل بها طلبات الدردشة. تقبل نقطة نهاية text_to_video نص JSON وتُعيد معرّف المهمة. لا حاجة لإضافات أو امتدادات إضافية.

### هل يمكن لـ Seedance توليد فيديو من صورة؟

نعم. مرّر رابط صورة في المعامل first_frame_image_url مع مطالبة نصية. يستخدم Seedance الصورة كإطار افتتاحي ويُنشئ الحركة منها. يمكنك أيضًا تعيين last_frame_image_url لتقييد النهاية.

### ما الحد الأقصى لمدة فيديو Seedance 2.0؟

يُنشئ Seedance 2.0 مقاطع فيديو مدتها بين 4 و15 ثانية. عيّن المعامل duration_seconds بالمدة التي تريدها. الإصدارات الأقدم (v1-pro، v1-lite) تدعم فقط مدد ثابتة 5 أو 10 ثوانٍ. لمحتوى أطول، سلسل مقاطع متعددة باستخدام مطالبات متسقة للشخصية وتثبيت الإطار الأول والأخير.


## Links

- [دليل إعداد Hermes Agent →](https://runapi.ai/ar/hermes-agent)
- [نماذج Seedance →](https://runapi.ai/ar/models/seedance)
- [Model catalog](https://runapi.ai/ar/models)
- [API docs](https://runapi.ai/ar/docs)