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

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

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

## API example

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

```

### Response

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

```

## How it works

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

## Parameters

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

## FAQ

### هل يمكنني استخدام 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. كلاهما غير متزامن ويُحتسب لهما رسوم منفصلة.


## Links

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