> ## 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.

# البدء السريع في Gemini image API: إنشاء صور Nano Banana باستخدام CometAPI

> أنشئ صورًا باستخدام نماذج صور Gemini عبر CometAPI، بما في ذلك عائلات نماذج Nano Banana، واحفظ مخرجات inlineData باستخدام curl أو Python أو Node.js.

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

ستستدعي مسار Gemini image `generateContent` عبر CometAPI، وتطلب مخرج صورة من نماذج صور Gemini بما في ذلك عائلات نماذج Nano Banana، وتتجاوز أجزاء صور `thought` الوسيطة، وتحفظ صورة `inlineData` النهائية.

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

* مفتاح CometAPI API مخزَّن في `COMETAPI_KEY`
* Python 3.10+ مع `requests`، أو Node.js 18+
* model ID لنموذج صور Gemini. يستخدم مرجع API المُصان `gemini-3.1-flash-image-preview` كمثال لتحويل النص إلى صورة.

## مفتاح API وعنوان URL الأساسي والمصادقة

استخدم مسار Gemini image عبر CometAPI:

```text theme={null}
https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent
```

قم بالمصادقة باستخدام `x-goog-api-key`:

```text theme={null}
x-goog-api-key: $COMETAPI_KEY
```

## أمثلة على الشيفرة

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

<CodeGroup>
  ```bash cURL theme={null}
  curl -s -X POST \
    "https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
    -H "x-goog-api-key: $COMETAPI_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "contents": [
        {
          "parts": [
            {
              "text": "A Monarch butterfly anatomical sketch on textured parchment"
            }
          ]
        }
      ],
      "generationConfig": {
        "responseModalities": ["TEXT", "IMAGE"],
        "imageConfig": {
          "aspectRatio": "1:1",
          "imageSize": "4K"
        }
      }
    }'
  ```

  ```python Python theme={null}
  import base64
  import os
  import requests

  response = requests.post(
      "https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
      headers={
          "x-goog-api-key": os.environ["COMETAPI_KEY"],
          "Content-Type": "application/json",
      },
      json={
          "contents": [
              {
                  "parts": [
                      {
                          "text": "A Monarch butterfly anatomical sketch on textured parchment"
                      }
                  ]
              }
          ],
          "generationConfig": {
              "responseModalities": ["TEXT", "IMAGE"],
              "imageConfig": {"aspectRatio": "1:1", "imageSize": "4K"},
          },
      },
      timeout=120,
  )
  response.raise_for_status()

  parts = response.json()["candidates"][0]["content"]["parts"]
  for part in reversed(parts):
      if part.get("thought") is True:
          continue
      inline_data = part.get("inlineData")
      if inline_data:
          image_bytes = base64.b64decode(inline_data["data"])
          mime_type = inline_data.get("mimeType", "image/png")
          extension = "jpg" if mime_type == "image/jpeg" else "png"
          with open(f"nano-banana-result.{extension}", "wb") as file:
              file.write(image_bytes)
          break
  else:
      raise RuntimeError("No final image part found")
  ```

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

  const response = await fetch(
    "https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
    {
      method: "POST",
      headers: {
        "x-goog-api-key": process.env.COMETAPI_KEY,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        contents: [
          {
            parts: [
              {
                text: "A Monarch butterfly anatomical sketch on textured parchment",
              },
            ],
          },
        ],
        generationConfig: {
          responseModalities: ["TEXT", "IMAGE"],
          imageConfig: { aspectRatio: "1:1", imageSize: "4K" },
        },
      }),
    },
  );

  if (!response.ok) {
    throw new Error(await response.text());
  }

  const body = await response.json();
  const parts = body.candidates[0].content.parts;
  const finalImage = [...parts]
    .reverse()
    .find((part) => part.thought !== true && part.inlineData);

  if (!finalImage) {
    throw new Error("No final image part found");
  }

  const mimeType = finalImage.inlineData.mimeType || "image/png";
  const extension = mimeType === "image/jpeg" ? "jpg" : "png";
  await fs.writeFile(
    `nano-banana-result.${extension}`,
    Buffer.from(finalImage.inlineData.data, "base64"),
  );
  ```
</CodeGroup>

## شرح التدفق

إنشاء الصور في Gemini متزامن على هذا المسار. تستخدم الاستجابة البنية الأصلية لـ Gemini وهي `candidates[].content.parts[]`. يمكن أن تتضمن الأجزاء نصًا وصورًا مُنشأة وأجزاء صور وسيطة حيث تكون `thought` مساوية لـ `true`.

عند حفظ النتيجة، كرّر عبر أجزاء الصور، وتجاهل `thought: true`، واحفظ آخر صورة `inlineData` متبقية.

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

| Parameter                             | الاستخدام                                                                       |
| ------------------------------------- | ------------------------------------------------------------------------------- |
| `model` path segment                  | model ID لنموذج صور Gemini في مسار URL.                                         |
| `contents`                            | Prompt وأجزاء صورة إدخال اختيارية.                                              |
| `generationConfig.responseModalities` | أدرج `IMAGE` عندما تحتاج إلى مخرج صورة.                                         |
| `generationConfig.imageConfig`        | خيارات الصورة مثل نسبة الأبعاد وحجم الصورة عندما تكون مدعومة من النموذج المحدد. |
| `tools`                               | أدوات Gemini اختيارية. أضفها فقط عندما يوثّق مرجع API سير العمل المحدد.         |

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

<AccordionGroup>
  <Accordion title="تتضمن الاستجابة صور thought">
    لا تحفظ الأجزاء التي تكون فيها `thought` مساوية لـ `true`. هذه صور وسيطة وليست المخرج النهائي.
  </Accordion>

  <Accordion title="يعيد الطلب نصًا فقط">
    تحقق من أن `generationConfig.responseModalities` تتضمن `IMAGE`، وأن النموذج المحدد يدعم مخرج الصور.
  </Accordion>

  <Accordion title="أحتاج إلى image-to-image">
    استخدم أجزاء الطلب `inline_data` كما هو موضح في دليل Gemini image، وأبقِ منطق تحليل الصورة النهائية كما هو.
  </Accordion>
</AccordionGroup>

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

* اقرأ [مرجع Gemini image API](/api/image/gemini/gemini-generates-image).
* اطّلع على المزيد من الأمثلة في [استخدام نماذج صور Gemini](/api/image/gemini/generate-image-guide).
* اعثر على نماذج الصور المتاحة في [Models](/ar/overview/models).
* قدّر التكلفة باستخدام [تقدير تكلفة الطلب قبل استدعاء نموذج](/ar/guides/how-to-estimate-cost-before-calling-a-model).