هل يمكنني استخدام Veo 3 في Hermes Agent؟

نعم. يستدعي Hermes Agent نقطة نهاية RunAPI Veo 3 text_to_video عبر مزود custom:runapi. اضبط model على veo-3.1 وأرسل الطلب بنفس RUNAPI_API_KEY المستخدم في المحادثة. لا حاجة لحساب Google Cloud أو بيانات اعتماد API فيديو منفصلة.

كيف يتعامل مزود custom:runapi مع مهام الفيديو غير المتزامنة؟

تُعيد RunAPI task_id فورًا عند طلب POST الأولي. يستطلع سير عمل Hermes Agent نقطة نهاية حالة المهمة حتى تكتمل، ثم يقرأ رابط الفيديو الناتج. يمكنك أيضًا ضبط callback_url لاستقبال webhook بدلًا من الاستطلاع.

ما الفرق بين veo-3.1 وveo-3.1-fast؟

كلاهما يُنتج فيديو مع صوت مدمج بدقة تصل إلى 1080p. يستخدم veo-3.1 خط أنابيب الجودة الكاملة ويكلف أكثر لكل توليد. يتنازل veo-3.1-fast عن بعض الدقة البصرية مقابل تكلفة أقل وتسليم أسرع — مناسب للمسودات والتكرار.

هل يمكنني التحكم في حركة الكاميرا والصوت في Veo 3؟

نعم. صِف حركة الكاميرا في المطالبة (تقريب، لقطة تتبع، مسح جوي) ويفسّرها Veo 3 بمحاكاة مدركة للفيزياء. للصوت، أضف الحوار بين علامتَي اقتباس وصِف الأصوات المحيطة — يُولِّد النموذج الصوت المتزامن بشكل أصيل، دون الحاجة إلى TTS أو مكتبة صوتية منفصلة.

هل يمكنني تمديد أو تكبير فيديو Veo 3 بعد التوليد؟

نعم. تعرض RunAPI نقطتَي نهاية extend_video وupscale_video لـ Veo 3. مرِّر source_task_id من التوليد الأصلي لتمديد المقطع، أو قم بالتكبير إلى دقة 1080p أو 4K. كلاهما غير متزامن ويُحتسب لهما رسوم منفصلة.

HERMES + VEO 3

استخدم Veo 3 في Hermes Agent.

Veo 3 هو نموذج توليد الفيديو من Google DeepMind، يُنتج مقاطع بدقة 1080p مدتها حتى 8 ثوانٍ مع صوت مدمج — حوار متزامن وأصوات محيطة وموسيقى تُولَّد جنبًا إلى جنب مع الفيديو. يستدعيه Hermes Agent عبر نقطة نهاية المزود المخصص في RunAPI، مُعيدًا استخدام مفتاح API ذاته الذي هُيِّئ للمحادثة.

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

مفتاح API واحد · فيديو مع صوت مدمج · دقة 1080p

Generate a cinematic video clip with native audio using Google Veo 3 through RunAPI.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- Send a POST request to https://runapi.ai/api/v1/veo_3_1/text_to_video
- Set model to "veo-3.1".
- Write a descriptive prompt including scene, camera movement, and audio cues.
- Set duration_seconds to 4, 6, or 8.
- Set aspect_ratio to "16:9", "9:16", or "auto".
- 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/veo_3_1/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "prompt": "A woman walks through a bustling Tokyo street at night, neon signs reflecting on wet pavement. She speaks into her phone: I just arrived. Ambient city noise, distant car horns, light rain.",
    "duration_seconds": 8,
    "aspect_ratio": "16:9"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "veo-3.1"
}

انسخ أمر curl للاختبار veo-3

HOW IT WORKS

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

تهيئة RunAPI

عيّن RUNAPI_API_KEY في البيئة التي يعمل فيها Hermes Agent. إذا أضفت RunAPI بالفعل كمزود custom:runapi للمحادثة، فإن المفتاح ذاته وbase_url يتولّيان توليد الفيديو — دون الحاجة إلى بيانات اعتماد Google Cloud منفصلة.

export RUNAPI_API_KEY=runapi_xxx

استدعاء Veo 3 text_to_video

أرسل طلب POST إلى نقطة نهاية text_to_video مع ضبط model على veo-3.1. أضف مطالبة تتضمن وصف المشهد وإشارات صوتية (حوار، أصوات محيطة). اضبط duration_seconds على 4 أو 6 أو 8 وaspect_ratio على 16:9 أو 9:16. يُوجِّه Hermes Agent الطلبات عبر مزود custom:runapi.

POST /api/v1/veo_3_1/text_to_video

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

تُعيد نقطة النهاية task_id فورًا. استطلع نقطة نهاية حالة المهمة حتى تتغير الحالة إلى completed، ثم استرجع رابط الفيديو الناتج. يتضمن الفيديو صوتًا متزامنًا مُولَّدًا من مطالبتك.

GET /api/v1/veo_3_1/text_to_video/tsk_abc123

PARAMETERS

معاملات Veo 3 text_to_video API

المعامل	النوع	الوصف
`model`	`string`	مطلوب. veo-3.1 (الجودة القياسية) أو veo-3.1-fast (تكلفة أقل، توليد أسرع).
`prompt`	`string`	مطلوب. وصف المشهد يشمل الحركة البصرية وحركة الكاميرا وإشارات صوتية للحوار أو الأصوات المحيطة.
`duration_seconds`	`integer`	اختياري. مدة الفيديو بالثواني. القيم المقبولة: 4، 6، 8. الافتراضي 8.
`aspect_ratio`	`string`	اختياري. نسبة عرض الإخراج. القيم المقبولة: 16:9، 9:16، auto.
`input_mode`	`string`	اختياري. وضع التوليد. text (الافتراضي)، أو first_and_last_frames (موجَّه بالإطارات المفتاحية)، أو reference (مرجع أسلوب).
`first_frame_image_url`	`string`	اختياري. رابط صورة الإطار الأول. يُستخدم عندما يكون input_mode هو first_and_last_frames.
`last_frame_image_url`	`string`	اختياري. رابط صورة الإطار الأخير. يُستخدم عندما يكون input_mode هو first_and_last_frames.
`reference_image_urls`	`array`	اختياري. روابط صور مرجعية للأسلوب. يُستخدم عندما يكون input_mode هو reference.
`callback_url`	`string`	اختياري. رابط webhook يستقبل طلب POST عند اكتمال المهمة.

ما هو Veo 3 في Hermes Agent؟

يُنشئ Veo 3 من Google DeepMind فيديو يبدو حياً — مرئيات سينمائية مع حوار متزامن وصوت محيط وموسيقى تُولَّد معاً في مرحلة واحدة. عبر الموفر custom:runapi في Hermes Agent، تحصل على مقاطع 1080p تصل إلى 8 ثوانٍ مع صوت أصلي دون خطوة TTS أو تحرير صوتي منفصلة.