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

# استخدم Seedance في OpenClaw.

يُنشئ Seedance 2.0 مقاطع فيديو مدتها 4–15 ثانية بدقة تصل إلى 1080p مع فوترة بالثانية تبدأ من حوالي $0.05/ثانية — أدنى تكلفة بالثانية بين نماذج الفيديو في RunAPI. يدعم مدخلات مرجعية متعددة الوسائط (صور وفيديو وروابط صوتية)، والتحكم في الإطار الأول والأخير، ومزامنة الصوت الأصلية. تستدعيه وكلاء OpenClaw من خلال نفس مفتاح 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 في بيئتك. إذا كنت قد ضبطت RunAPI للدردشة في OpenClaw من قبل، فإن نفس المفتاح يعمل لتوليد فيديو Seedance — لا حاجة لإعداد مزوّد إضافي.
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 للتحكم متعدد الوسائط.
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 في OpenClaw؟

نعم. ضبط RunAPI كمزوّد متوافق مع OpenAI في OpenClaw، ثم استدع نقطة نهاية text_to_video مع تعيين النموذج إلى seedance-2.0. نفس مفتاح API يتعامل مع الدردشة وتوليد الفيديو.

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

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

### ما الفرق بين seedance-2.0 وseedance-2.0-fast؟

يدعم Seedance 2.0 إخراجًا بدقة تصل إلى 1080p ويكلف أكثر بالثانية. أما Seedance 2.0-fast فيقتصر على 720p لكنه أسرع في التوليد وأقل تكلفة. كلاهما يقبل نفس مدخلات المراجع متعددة الوسائط.

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

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

### كيف تعمل reference_audio_urls مع Seedance؟

يستطيع Seedance 2.0 مزامنة حركة الفيديو المُنشأ مع مسار صوتي. مرّر رابط الملف الصوتي في reference_audio_urls وسيوافق النموذج الحركة البصرية مع الصوت — مفيد لمقاطع الموسيقى أو المشاهد الحوارية دون خطوة منفصلة لتحويل الصوت إلى فيديو.


## Links

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