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

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

يولّد Kling 3.0 من Kuaishou مقاطع فيديو من النصوص أو الصور بدقة تصل إلى 1080p مع صوت مدمج ومشاهد متعددة ومدة من 3 إلى 15 ثانية. يستدعيه Hermes Agent عبر RunAPI باستخدام المزود custom:runapi — نفس المفتاح وعنوان URL الذي هيّأته للدردشة.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/kling/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0",
    "prompt": "A drone shot pulling back from a mountain lake at sunrise, mist rising off the water, cinematic lighting",
    "duration_seconds": 5,
    "aspect_ratio": "16:9",
    "enable_sound": true,
    "output_resolution": "1080p"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "kling-3.0"
}

```

## How it works

1. **تهيئة RunAPI** — عيّن متغير البيئة RUNAPI_API_KEY. إذا أضفت بالفعل RunAPI كمزود custom:runapi في Hermes Agent للدردشة، فإن نفس المفتاح وbase_url يعملان لتوليد الفيديو — لا حاجة لتهيئة إضافية.
2. **استدعاء Kling text_to_video** — أرسل طلب POST إلى /api/v1/kling/text_to_video مع ضبط النموذج على kling-3.0. أضف prompt وduration_seconds (3–15) وaspect_ratio، واختياريًا enable_sound للصوت المدمج. للتوليد من صورة، استخدم /api/v1/kling/image_to_video مع first_frame_image_url عوضًا عن ذلك.
3. **استطلاع النتيجة** — تُعيد نقطة النهاية task_id فورًا. استطلع نقطة نهاية حالة المهمة حتى تتغير الحالة إلى completed، ثم احصل على رابط الفيديو من الاستجابة. يستغرق التوليد عادةً 30–120 ثانية حسب المدة والدقة.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | مطلوب. kling-3.0 للإصدار الأحدث. |
| `prompt` | `string` | وصف الفيديو. مطلوب إلا إذا كان multi_shots مفعّلاً. |
| `duration_seconds` | `integer` | مدة الفيديو. يدعم Kling 3.0 من 3 إلى 15 ثانية. الإصدارات الأقدم تقبل 5 أو 10 فقط. |
| `aspect_ratio` | `string` | نسبة أبعاد الإخراج: 16:9 أو 9:16 أو 1:1. |
| `output_resolution` | `string` | الدقة: 720p أو 1080p أو 4k. الدقة الأعلى تكلف أكثر في الثانية. |
| `enable_sound` | `boolean` | يولّد صوتًا مدمجًا مع الفيديو. يزيد تكلفة الثانية. |
| `negative_prompt` | `string` | عناصر يجب استبعادها من التوليد. |
| `first_frame_image_url` | `string` | رابط صورة لاستخدامها كإطار افتتاحي (وضع اللقطة الواحدة). |
| `cfg_scale` | `number` | مقياس التوجيه (0–1). القيم الأعلى تتبع الطلب بدقة أكبر. |
| `multi_shots` | `boolean` | تفعيل توليد مشاهد متعددة اللقطات مع طلبات منفصلة لكل مقطع. |

## FAQ

### كيف تعمل الفوترة بالثانية لـ Kling على RunAPI؟

يُفوتر Kling بالثانية للفيديو المولَّد. يعتمد السعر على output_resolution وما إذا كان enable_sound مفعّلاً. مقطع 5 ثوانٍ بدقة 720p بدون صوت هو الخيار الأقل تكلفة؛ 1080p مع الصوت يكلف ضعف ذلك تقريبًا في الثانية. راجع صفحة الأسعار في RunAPI للأسعار الدقيقة.

### ما الفرق بين text_to_video و image_to_video؟

يولّد text_to_video مقطعًا من طلب نصي فقط. يتطلب image_to_video first_frame_image_url ويحرّك الصورة للخارج. كلتا نقطتَي النهاية تُعيدان task_id غير متزامن وتدعمان نفس خيارات المدة والدقة.

### هل يمكنني استخدام إصدارات Kling أخرى غير 3.0؟

نعم. يستضيف RunAPI أيضًا kling-v2.5-turbo-text-to-video-pro وkling-v2.5-turbo-image-to-video-pro لتوليد أسرع وأقل تكلفة عند 5 أو 10 ثوانٍ. اضبط معامل النموذج على الإصدار المطلوب.

### هل يحتاج Hermes Agent إلى مزود منفصل لفيديو Kling؟

لا. إذا هيّأت بالفعل مزود custom:runapi في Hermes Agent للدردشة أو توليد الصور، فإن نفس base_url ومفتاح API يعملان لنقاط نهاية Kling للفيديو. فقط غيّر مسار الطلب ومعامل النموذج.

### ماذا يحدث إذا فشل توليد Kling — هل لا أزال أُفوتَر؟

لا. يُفوتر RunAPI على التوليدات المكتملة فقط. إذا فشلت المهمة أو انتهت مهلتها في المنبع، تُعاد الأرصدة المحجوزة إلى رصيد حسابك.


## Links

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