---
title: "استخدم Grok Imagine في Hermes Agent عبر RunAPI — دليل Image & Video API"
url: "https://runapi.ai/ar/hermes-grok-imagine.md"
canonical: "https://runapi.ai/ar/hermes-grok-imagine"
locale: "ar"
model: "grok-imagine"
---

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

Grok Imagine هو مجموعة xAI لتوليد الصور والفيديو — text-to-image وimage-to-image وtext-to-video وimage-to-video. يستدعيها Hermes Agent عبر نفس موفر RunAPI المخصص ومفتاح API المستخدم للدردشة، دون الحاجة لأي إضافات.

## API example

```bash
curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-text-to-image",
    "prompt": "a robot hand placing a chess piece on a board, dramatic side lighting, slow motion feel"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "grok-imagine-text-to-image"
}

```

## How it works

1. **اضبط RunAPI** — اضبط متغير البيئة RUNAPI_API_KEY في ملف تعريف shell. إذا كان موفر custom:runapi مضبوطًا في Hermes Agent للدردشة، فنفس المفتاح يعمل مع Grok Imagine — لا إعداد إضافي.
2. **استدع Grok Imagine** — أرسل طلب POST إلى نقطة نهاية text_to_image مع ضبط model على grok-imagine-text-to-image. أضف prompt يصف الصورة. للفيديو، استخدم text_to_video مع grok-imagine-text-to-video.
3. **احصل على النتيجة** — تُعيد واجهة API معرّف المهمة فورًا. استطلع نقطة نهاية الحالة حتى يتغير الوضع إلى completed، ثم استرجع رابط الصورة أو الفيديو من الاستجابة.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | مطلوب. مثل grok-imagine-text-to-image أو grok-imagine-image-to-video. |
| `prompt` | `string` | وصف نصي للإخراج المطلوب. |
| `image_url` | `string` | رابط الصورة المصدر لـ image-to-image أو image-to-video. |
| `aspect_ratio` | `string` | اختياري. نسبة الأبعاد، مثل 16:9 أو 1:1. |

## FAQ

### هل يمكنني استخدام Grok Imagine في Hermes Agent؟

نعم. إذا كان RunAPI مضبوطًا بالفعل كموفر مخصص (custom:runapi) في Hermes Agent، فنفس مفتاح API والـ base_url يعملان مع Grok Imagine. اضبط model على grok-imagine-text-to-image واستدع نقطة نهاية text_to_image.

### هل أحتاج مفتاح API منفصلًا لـ Grok Imagine؟

لا. نفس RUNAPI_API_KEY المستخدم للدردشة وغيرها يعمل مع Grok Imagine. مفتاح واحد يغطي أكثر من 113 نموذجًا في كتالوج RunAPI.

### هل Grok Imagine متزامن أم غير متزامن؟

غير متزامن. تُعيد واجهة API معرّف المهمة فورًا. استطلع نقطة نهاية الحالة حتى تكتمل. تتولى SDKs وCLI الخاصة بـ RunAPI الاستطلاع تلقائيًا.

### كم يكلف Grok Imagine؟

يستخدم Grok Imagine فوترة لكل مهمة عبر RunAPI. راجع صفحة الأسعار للأسعار الحالية. لا تُحتسب العمليات الفاشلة.


## Links

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