---
title: "استخدم Z Image في Hermes Agent عبر RunAPI — دليل Image API"
url: "https://runapi.ai/ar/hermes-z-image.md"
canonical: "https://runapi.ai/ar/hermes-z-image"
locale: "ar"
model: "z-image"
---

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

Z Image نموذج توليد الصور السريع من Alibaba مع تصيير ثنائي اللغة بالصينية والإنجليزية. يستدعيه Hermes Agent عبر نقطة نهاية موفر RunAPI المخصص — نفس الـ base_url ومفتاح API المستخدم للدردشة، بدون إضافات أو استئجار GPU.

## 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": "z-image",
    "prompt": "A neon-lit Tokyo street at night with Japanese shop signs, cinematic lighting, 8K detail"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "z-image"
}

```

## How it works

1. **اضبط RunAPI** — اضبط مفتاح RunAPI API كمتغير بيئة. إذا ضبطت RunAPI مسبقًا كموفر مخصص في Hermes Agent، فنفس المفتاح والـ base_url يعملان لتوليد الصور.
2. **استدع Z Image** — أرسل طلب POST إلى نقطة نهاية text_to_image مع model على z-image وprompt نصي. يدعم Z Image الـ prompts بالصينية والإنجليزية مع تصيير دقيق للنصوص.
3. **احصل على النتيجة** — تُعيد واجهة API معرّف المهمة فورًا. استطلع نقطة نهاية الحالة حتى يتغير الوضع إلى completed، ثم استرجع رابط الصورة المولّدة من إخراج الاستجابة.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | مطلوب. استخدم z-image. |
| `prompt` | `string` | وصف نصي. يدعم الصينية والإنجليزية. |
| `negative_prompt` | `string` | اختياري. ما يجب تجنبه في الصورة. |
| `size` | `string` | اختياري. أبعاد الإخراج، مثل 1024x1024. |

## FAQ

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

نعم. إذا ضبطت RunAPI كموفر مخصص في Hermes Agent، فنفس مفتاح API والـ base_url يُعالجان طلبات Z Image. أرسل POST إلى نقطة نهاية text_to_image مع model على z-image.

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

لا. نفس RUNAPI_API_KEY المستخدم للدردشة وغيرها يعمل مع Z Image. جميع نماذج RunAPI تشترك في مفتاح واحد ورصيد واحد.

### هل Z Image متزامن أم غير متزامن؟

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

### كم يكلف Z Image؟

يستخدم Z Image تسعيرًا حسب الاستخدام مع فوترة لكل مهمة. راجع صفحة الأسعار للسعر الحالي. لا اشتراك شهري ولا حد أدنى للإنفاق.


## Links

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