إنشاء الصور باستخدام Gemini

POST

v1beta

models

{model}

:generateContent

import os
from google import genai
from google.genai import types

client = genai.Client(
    http_options={"api_version": "v1beta", "base_url": "https://api.cometapi.com"},
    api_key=os.environ.get("COMETAPI_KEY"),
)

response = client.models.generate_content(
    model="gemini-3.1-flash-lite-image",
    contents="A Monarch butterfly anatomical sketch on textured parchment",
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(aspect_ratio="1:1", image_size="1K"),
    ),
)

final_image = None
for part in response.parts:
    if getattr(part, "thought", False):
        continue
    if part.text:
        print(part.text)
    elif image := part.as_image():
        final_image = image

if final_image:
    final_image.save("output.png")

{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {
            "text": "<string>",
            "inlineData": {
              "mimeType": "<string>",
              "data": "<string>"
            },
            "thought": true,
            "thoughtSignature": "<string>"
          }
        ]
      },
      "index": 123,
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "<string>"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123,
    "thoughtsTokenCount": 123
  }
}

للاطلاع على أمثلة خطوة بخطوة، راجع استخدام نماذج صور Gemini.

يمكن أن تتغير خيارات إنشاء الصور في Gemini مع قيام Google بتحديث نماذج الصور وgenerateContent. راجع وثائق إنشاء الصور في Gemini للحصول على أحدث قائمة كاملة بالمعلمات والسلوك الخاص بمزوّد الخدمة.

من المقرر أن يقوم مزوّد الخدمة بإيقاف gemini-2.5-flash-image في 2026-10-02. بالنسبة للمشاريع الجديدة، استخدم gemini-3.1-flash-image-preview أو gemini-3-pro-image-preview. راجع جدول الإيقاف من Google لمزيد من التفاصيل.

قد تتضمن استجابات صور Gemini أجزاء صور وسيطة يكون فيها thought مساويًا لـ true. هذه ليست المخرجات النهائية. عند حفظ الصور المُنشأة، تخطَّ الأجزاء التي تحتوي على thought: true واستخدم آخر جزء صورة يوجد فيه inlineData ولا يكون فيه thought مساويًا لـ true.

التفويضات

Authorization

string

header

مطلوب

Use your CometAPI API key.

معلمات المسار

model

string

افتراضي:gemini-3.1-flash-image-preview

مطلوب

The Gemini image model to use. See the Models page for current options.

الجسم

application/json

contents

object[]

مطلوب

Conversation turns. Each item has a role ("user" or "model") and parts array containing text and/or image data.

Show child attributes

generationConfig

object

Controls generation behavior — output modalities, image resolution, thinking, etc.

Show child attributes

tools

object[]

Optional tools. Pass [{"google_search": {}}] to enable Google Search grounding for real-time information in generated images.

Show child attributes

الاستجابة

200 - application/json

Success

candidates

object[]

Show child attributes

usageMetadata

object

Show child attributes

إنشاء تعديل صورة

استخدام نماذج صور Gemini

import os
from google import genai
from google.genai import types

client = genai.Client(
    http_options={"api_version": "v1beta", "base_url": "https://api.cometapi.com"},
    api_key=os.environ.get("COMETAPI_KEY"),
)

response = client.models.generate_content(
    model="gemini-3.1-flash-lite-image",
    contents="A Monarch butterfly anatomical sketch on textured parchment",
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(aspect_ratio="1:1", image_size="1K"),
    ),
)

final_image = None
for part in response.parts:
    if getattr(part, "thought", False):
        continue
    if part.text:
        print(part.text)
    elif image := part.as_image():
        final_image = image

if final_image:
    final_image.save("output.png")

{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {
            "text": "<string>",
            "inlineData": {
              "mimeType": "<string>",
              "data": "<string>"
            },
            "thought": true,
            "thoughtSignature": "<string>"
          }
        ]
      },
      "index": 123,
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "<string>"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123,
    "thoughtsTokenCount": 123
  }
}

الإشراف على المحتوى

مفاتيح API

إنشاء الصور باستخدام Gemini

التفويضات

معلمات المسار

الجسم

الاستجابة