---
title: "استخدام GPT Image في OpenClaw عبر RunAPI — دليل واجهة برمجة الصور"
url: "https://runapi.ai/ar/openclaw-gpt-image.md"
canonical: "https://runapi.ai/ar/openclaw-gpt-image"
locale: "ar"
model: "gpt-image"
---

# استخدم GPT Image في OpenClaw.

GPT Image 2 هو نموذج توليد الصور المخصص من OpenAI — يدعم تحويل النص إلى صورة وتحرير الصور بالتعليمات اللغوية، بدقة إخراج تصل إلى 4K ودعم الخلفيات الشفافة. تستدعيه وكلاء OpenClaw عبر نفس مفتاح RunAPI ونقطة نهاية /v1 المستخدمة للدردشة، دون الحاجة إلى تثبيت مهارات إضافية.

## 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": "gpt-image-2-text-to-image",
    "prompt": "A product photo of a glass perfume bottle on a marble surface, transparent background, studio lighting, the label reads AURORA in gold serif font",
    "output_resolution": "2k",
    "aspect_ratio": "3:4"
  }'

```

### Response

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

```

## How it works

1. **هيّئ RunAPI** — عيّن متغير البيئة RUNAPI_API_KEY في ملف تعريف shell. إذا كانت RunAPI مُهيَّأة مسبقًا في OpenClaw للدردشة، فإن المفتاح ذاته يعمل مع GPT Image — دون الحاجة إلى إعداد إضافي.
2. **استدعِ GPT Image 2** — أرسل طلب POST إلى نقطة نهاية text_to_image مع تعيين النموذج إلى gpt-image-2-text-to-image. أضف مطالبة وصفية تتضمن تعليمات التخطيط والأسلوب. عيّن output_resolution على 2k أو 4k للحصول على دقة أعلى. لتعديل صور موجودة، استخدم نقطة نهاية edit_image مع gpt-image-2-image-to-image وأمدّ source_image_urls.
3. **احصل على النتيجة** — تُعيد الواجهة البرمجية task_id فورًا. استعلم عن نقطة نهاية حالة المهمة حتى تتغير الحالة إلى completed، ثم استرجع رابط صورة الإخراج من الاستجابة. يُكمل GPT Image 2 عادةً في غضون 10–30 ثانية تبعًا للدقة.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | مطلوب. gpt-image-2-text-to-image للتوليد، وgpt-image-2-image-to-image للتعديل. |
| `prompt` | `string` | مطلوب. وصف بلغة طبيعية للصورة المطلوبة. يدعم تعليمات تفصيلية للتخطيط ونصوص التراكب والأسلوب. |
| `output_resolution` | `string` | اختياري. دقة الإخراج — 1k (افتراضي)، أو 2k، أو 4k. الدقة الأعلى تكلّف أكثر لكل صورة. |
| `aspect_ratio` | `string` | اختياري. الافتراضي auto. يدعم 1:1، 3:2، 2:3، 4:3، 3:4، 16:9، 9:16، والمزيد. |
| `source_image_urls` | `array` | مطلوب لنقطة نهاية edit_image. رابط واحد أو أكثر لصور المصدر المراد تعديلها. |

## FAQ

### هل يمكنني استخدام GPT Image 2 في OpenClaw؟

نعم. يستدعي وكلاء OpenClaw نموذج GPT Image 2 عبر نقطة نهاية text_to_image في RunAPI. عيّن حقل النموذج إلى gpt-image-2-text-to-image وأرسل الطلب بنفس RUNAPI_API_KEY المستخدم للدردشة. لا حاجة إلى مهارات إضافية أو مكوّنات إضافية.

### ما الفرق بين GPT Image 2 و GPT-4o Image؟

GPT Image 2 هو نموذج توليد الصور المخصص من OpenAI بجودة أعلى ودقة 4K ودعم الخلفيات الشفافة. أما GPT-4o Image فيولّد الصور في سياق الدردشة لكنه محدود بنسب عرض إلى ارتفاع 1:1 أو 3:2 أو 2:3. كلاهما متاح عبر RunAPI — استخدم gpt-image-2-text-to-image للتوليد المستقل وgpt-4o-image لإخراج الصور المدمج في الدردشة.

### هل يدعم GPT Image 2 الخلفيات الشفافة؟

نعم. يمكن لـ GPT Image 2 إخراج صور بخلفيات شفافة عند تحديد ذلك في المطالبة. هذا مفيد لصور المنتجات والشعارات وعناصر واجهة المستخدم. حدّد الشفافية في مطالبتك — على سبيل المثال، "صورة منتج بخلفية شفافة."

### كيف تعمل تسعيرة GPT Image 2 على RunAPI؟

يُفوتر GPT Image 2 لكل صورة بحسب دقة الإخراج: 1k هو الأقل تكلفة، و2k متوسط، و4k هو الأعلى. ينطبق نفس السعر على text_to_image وedit_image. راجع صفحة التسعيرة في RunAPI للأسعار الحالية لكل صورة. التوليد الفاشل لا يُحتسب.

### هل يمكنني تعديل صورة موجودة بـ GPT Image 2؟

نعم. استخدم نقطة نهاية edit_image مع تعيين النموذج إلى gpt-image-2-image-to-image. أمدّ روابط الصور المصدر في source_image_urls وصف التعديل في المطالبة — مثلًا، "غيّر الخلفية إلى غروب شمس على الشاطئ" أو "أضف قبعة حمراء للشخص." يتبع GPT Image 2 تعليمات التعديل اللغوية الطبيعية.


## Links

- [دليل إعداد OpenClaw →](https://runapi.ai/ar/openclaw)
- [نماذج GPT Image →](https://runapi.ai/ar/models/gpt-image)
- [Model catalog](https://runapi.ai/ar/models)
- [API docs](https://runapi.ai/ar/docs)