كيف تعمل الفوترة بالثانية لـ 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 على التوليدات المكتملة فقط. إذا فشلت المهمة أو انتهت مهلتها في المنبع، تُعاد الأرصدة المحجوزة إلى رصيد حسابك.

HERMES + KLING

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

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

احصل على API Key اقرأ الوثائق

مفتاح API واحد · نص إلى فيديو + صورة إلى فيديو · فوترة بالثانية

Use RunAPI to generate a video with Kling 3.0 through Hermes Agent.

Requirements:
- Use the custom:runapi provider already configured in Hermes Agent
- Call POST https://runapi.ai/api/v1/kling/text_to_video
- Set model to "kling-3.0"
- The RUNAPI_API_KEY environment variable provides authorization
- Set duration_seconds to control length (3–15 seconds)
- Set aspect_ratio to "16:9" for landscape video
- Enable sound with enable_sound: true for native audio
- The response is async — poll the task status endpoint until the task completes, then retrieve the video URL

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

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

انسخ أمر curl للاختبار kling

HOW IT WORKS

استخدام Kling في Hermes Agent في ثلاث خطوات

تهيئة RunAPI

عيّن متغير البيئة RUNAPI_API_KEY. إذا أضفت بالفعل RunAPI كمزود custom:runapi في Hermes Agent للدردشة، فإن نفس المفتاح وbase_url يعملان لتوليد الفيديو — لا حاجة لتهيئة إضافية.

export RUNAPI_API_KEY=runapi_xxx

استدعاء 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 عوضًا عن ذلك.

POST /api/v1/kling/text_to_video

استطلاع النتيجة

تُعيد نقطة النهاية task_id فورًا. استطلع نقطة نهاية حالة المهمة حتى تتغير الحالة إلى completed، ثم احصل على رابط الفيديو من الاستجابة. يستغرق التوليد عادةً 30–120 ثانية حسب المدة والدقة.

GET /api/v1/kling/text_to_video/tsk_abc123

PARAMETERS

معاملات Kling text_to_video API

المعامل	النوع	الوصف
`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`	تفعيل توليد مشاهد متعددة اللقطات مع طلبات منفصلة لكل مقطع.

ما هو Kling في Hermes Agent؟

يُقدم Kling 3.0 من Kuaishou مقاطع سينمائية باتساق الشخصيات وفيزياء حركة قوية — تدرج الأقمشة وديناميكيات السوائل وحركة الكاميرا الواقعية. عبر الموفر custom:runapi في Hermes Agent، تحصل على تحويل النص والصورة إلى فيديو بدقة تصل إلى 1080p مع صوت أصلي.