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

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

يكبّر Topaz من Topaz Labs دقة الصور حتى 8x باستخدام شبكات عصبية تستعيد التفاصيل دون تشوهات. يستدعيه Hermes Agent عبر نفس موفر RunAPI المخصص للدردشة وتوليد الصور — أرسل رابط صورة، اختر معامل التكبير، واستطلع النتيجة المحسّنة.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/topaz/upscale_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "topaz-upscale-image",
    "image_url": "https://example.com/photo.jpg",
    "scale": 4
  }'

```

### Response

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

```

## How it works

1. **اضبط RunAPI** — إذا لم تُعدّ RunAPI في Hermes Agent بعد، اتبع دليل الإعداد. أضف موفرًا مخصصًا باسم runapi مع base_url على https://runapi.ai/v1 وkey_env على RUNAPI_API_KEY وapi_mode على chat_completions.
2. **استدع Topaz upscale_image** — أرسل طلب POST إلى نقطة نهاية upscale_image مع model على topaz-upscale-image وimage_url المصدر ومعامل scale اختياري 2 أو 4 أو 8. نفس مفتاح RunAPI يُعالج المصادقة.
3. **استطلع النتيجة** — تُعيد نقطة النهاية معرّف المهمة بحالة pending. استطلع نقطة نهاية الحالة حتى يتغير الوضع إلى completed، ثم استرجع رابط الصورة المكبّرة من الاستجابة. تتولى SDKs وCLI الاستطلاع تلقائيًا.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | مطلوب. topaz-upscale-image أو topaz-upscale-video. |
| `image_url` | `string` | رابط الصورة المراد تكبيرها. |
| `scale` | `integer` | اختياري. معامل التكبير: 2 أو 4 أو 8. الافتراضي 2. |
| `callback_url` | `string` | اختياري. رابط webhook لإشعار الاكتمال غير المتزامن. |

## FAQ

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

نعم. اضبط RunAPI كموفر مخصص في Hermes Agent مع base_url على https://runapi.ai/v1 وkey_env على RUNAPI_API_KEY، ثم وجّه الـ agent لاستدعاء نقطة نهاية Topaz upscale_image. نفس موفر custom:runapi المستخدم للدردشة يُعالج طلبات التكبير.

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

لا. نفس RUNAPI_API_KEY الذي يُشغّل الدردشة وتوليد الصور وغيرها يعمل مع تكبير Topaz. جميع نماذج RunAPI تشترك في مفتاح API واحد ورصيد واحد.

### هل تكبير Topaz متزامن أم غير متزامن؟

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

### كم يكلف تكبير Topaz؟

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


## Links

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