Gemini ile görseller oluşturun

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
  }
}

Adım adım örnekler için Use Gemini image models sayfasına bakın.

Google görsel modellerini ve generateContent özelliğini güncelledikçe Gemini görsel oluşturma seçenekleri değişebilir. En güncel ve eksiksiz parametre listesi ile sağlayıcıya özgü davranışlar için Gemini görsel oluşturma belgelerini kontrol edin.

gemini-2.5-flash-image sağlayıcı tarafından 2026-10-02 tarihinde kapatılacak şekilde planlanmıştır. Yeni projeler için gemini-3.1-flash-image-preview veya gemini-3-pro-image-preview kullanın. Ayrıntılar için Google’ın kullanımdan kaldırma takvimine bakın.

Gemini görsel yanıtları, thought değeri true olan ara görsel parçaları içerebilir. Bunlar nihai çıktı değildir. Oluşturulan görselleri kaydederken thought: true parçalarını atlayın ve inlineData bulunan ve thought değeri true olmayan son görsel parçasını kullanın.

Yetkilendirmeler

Authorization

string

header

gerekli

Use your CometAPI API key.

Yol Parametreleri

model

string

varsayılan:gemini-3.1-flash-image-preview

gerekli

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

Gövde

application/json

contents

object[]

gerekli

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

Yanıt

200 - application/json

Success

candidates

object[]

Show child attributes

usageMetadata

object

Show child attributes

Görüntü düzenleme oluştur

Gemini image modellerini kullanın

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
  }
}

İçerik moderasyonu

API anahtarları

Yetkilendirmeler

Yol Parametreleri

Gövde

Yanıt