> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# البدء السريع لـ GPT Image API: إنشاء الصور باستخدام CometAPI

> أنشئ صورة GPT عبر CometAPI، وفك ترميز `b64_json`، واحفظ النتيجة باستخدام curl أو Python أو Node.js.

## ما الذي ستبنيه

ستستدعي `POST /v1/images/generations`، وتولّد صورة واحدة باستخدام نموذج صور GPT، وتفك ترميز `b64_json` المُعاد، ثم تحفظه كملف صورة.

## المتطلبات المسبقة

* مفتاح API من CometAPI مخزّن في `COMETAPI_KEY`
* Python 3.10+ أو Node.js 18+ لأمثلة حفظ الملفات
* بيئة من جهة الخادم. لا تستدعِ إنشاء الصور من كود واجهة أمامية عام باستخدام مفتاح سري.

## مفتاح API، وBase URL، والمصادقة

استخدم endpoint الصور المتوافق مع OpenAI:

```text theme={null}
https://api.cometapi.com/v1/images/generations
```

قم بالمصادقة باستخدام Bearer token:

```text theme={null}
Authorization: Bearer $COMETAPI_KEY
```

## أمثلة الكود

استخدم علامات التبويب أدناه للحصول على أمثلة قابلة للنسخ في cURL وPython وNode.js.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/images/generations \
    -H "Authorization: Bearer $COMETAPI_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "gpt-image-2",
      "prompt": "A paper boat floating on calm water at sunrise.",
      "quality": "low",
      "size": "1024x1024",
      "output_format": "jpeg"
    }'
  ```

  ```python Python theme={null}
  import base64
  import os
  from openai import OpenAI

  client = OpenAI(
      api_key=os.environ["COMETAPI_KEY"],
      base_url="https://api.cometapi.com/v1",
  )

  image = client.images.generate(
      model="gpt-image-2",
      prompt="A paper boat floating on calm water at sunrise.",
      quality="low",
      size="1024x1024",
      output_format="jpeg",
  )

  image_base64 = image.data[0].b64_json
  with open("cometapi-gpt-image.jpeg", "wb") as file:
      file.write(base64.b64decode(image_base64))
  ```

  ```javascript Node.js theme={null}
  import fs from "node:fs/promises";
  import OpenAI from "openai";

  const client = new OpenAI({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com/v1",
  });

  const image = await client.images.generate({
    model: "gpt-image-2",
    prompt: "A paper boat floating on calm water at sunrise.",
    quality: "low",
    size: "1024x1024",
    output_format: "jpeg",
  });

  const imageBase64 = image.data[0].b64_json;
  await fs.writeFile("cometapi-gpt-image.jpeg", Buffer.from(imageBase64, "base64"));
  ```
</CodeGroup>

## شرح التدفق

يعيد إنشاء صور GPT الاستجابة المكتملة في طلب واحد. تُرجع نماذج صور GPT بيانات الصورة بترميز base64 في `data[0].b64_json`. فك ترميز تلك القيمة ثم اكتب البايتات إلى ملف يطابق `output_format`.

إذا كنت تحتاج إلى مخرجات URL، فتحقق مما إذا كان النموذج المحدد يدعم استجابات URL. تستخدم نماذج صور GPT مخرجات base64 في المثال المرجعي المعتمد.

## المعلمات الشائعة

| Parameter       | Use                                                                 |
| --------------- | ------------------------------------------------------------------- |
| `model`         | model ID لنموذج صور GPT. يستخدم المثال المرجعي `gpt-image-2`.       |
| `prompt`        | وصف نصي للصورة المراد إنشاؤها.                                      |
| `size`          | حجم المخرجات المطلوب. تعتمد القيم المدعومة على النموذج المحدد.      |
| `quality`       | إعداد الجودة للنماذج التي تدعمه.                                    |
| `output_format` | نوع الصورة المُرمّزة لنتائج صور GPT، مثل `jpeg` أو `png` أو `webp`. |

## استكشاف الأخطاء وإصلاحها / الأسئلة الشائعة

<AccordionGroup>
  <Accordion title="الملف المحفوظ لا يفتح">
    تأكد من أنك فككت ترميز `b64_json` إلى بايتات base64 وحفظت امتداد الملف المطابق لـ `output_format`.
  </Accordion>

  <Accordion title="النموذج يرفض معلمة">
    تختلف معلمات الصور حسب النموذج. ابدأ بالمثال المرجعي الأدنى، ثم أضف حقلاً اختيارياً واحداً في كل مرة.
  </Accordion>

  <Accordion title="الاستجابة لا تحتوي على URL">
    استخدم `b64_json` مع نماذج صور GPT. مخرجات URL تعتمد على النموذج.
  </Accordion>
</AccordionGroup>

## الخطوات التالية

* اقرأ [مرجع API لإنشاء الصور](/api/image/openai/images).
* اعثر على model ID الخاصة بنماذج الصور في [Models](/ar/overview/models).
* قدّر تكلفة الطلب باستخدام [تقدير تكلفة الطلب قبل استدعاء نموذج](/ar/guides/how-to-estimate-cost-before-calling-a-model).
* تعامل مع حالات الفشل باستخدام [رموز الأخطاء واستراتيجية إعادة المحاولة](/ar/guides/error-codes-and-retry-strategy).