İçerik oluşturma

POST

v1beta

models

{model}

{operator}

import os
from google import genai

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

response = client.models.generate_content(
    model="gemini-3.8-flash",
    contents='Explain how AI works in a few words',
)

print(response.text)

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "AI learns patterns from massive amounts of data to make predictions, solve problems, and generate new content. \n\nIn short: **Data in → Patterns found → Smart predictions out.**"
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 9,
    "candidatesTokenCount": 36,
    "thoughtsTokenCount": 388,
    "totalTokenCount": 433
  },
  "modelVersion": "gemini-3.8-flash"
}

Metin oluşturmak, video girişi göndermek ve düşünme ya da araçları yapılandırmak için CometAPI aracılığıyla Gemini yerel istek biçimini kullanın. Örneklerde gemini-3.8-flash kullanılır.

Google’ın GenerateContent API referansını alan tanımları ve modele özgü seçenekler için kullanın. Bu sayfada CometAPI temel URL’si, kimlik doğrulama ve istek örnekleri gösterilir.

Kimlik doğrulama için hem x-goog-api-key hem de Authorization: Bearer başlıkları desteklenir.

Hızlı başlangıç

Google Gen AI SDK’yı veya bir HTTP istemcisini CometAPI ile kullanmak için temel URL’yi ve API anahtarını yapılandırın:

Ayar	Google varsayılanı	CometAPI
Temel URL	`generativelanguage.googleapis.com`	`api.cometapi.com`
API anahtarı	`$GEMINI_API_KEY`	`$COMETAPI_KEY`

Şu GenerateContent metin oluşturma kılavuzunu yerel API örnekleri için kullanın. Temel URL’yi değiştirirken generateContent istek yapısını koruyun.

Video girişi gönderme

Videoyu içerik parçası olarak gönderin. Video giriş biçimini, videonun depolandığı yere göre seçin:

Video kaynağı	İstek parçası	Şu durumda kullanın
Yerel video dosyası	`inlineData`	Video, JSON isteğinde base64 olarak gönderilebilecek kadar küçüktür.
Herkese açık video URL’si	`fileData.fileUri`	Video, kimlik doğrulama gerektirmeyen herkese açık bir HTTPS URL’si üzerinden kullanılabilir.

REST ve curl istekleri için inlineData.mimeType ve fileData.fileUri gibi camelCase alan adlarını kullanın.

Bu örnek, satır içi MP4 verisi gönderir. <base64-encoded-mp4> değerini videonuzun base64 içeriğiyle değiştirin:

curl \
  "https://api.cometapi.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  --data-binary @- <<'EOF'
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "inlineData": {
            "mimeType": "video/mp4",
            "data": "<base64-encoded-mp4>"
          }
        },
        {
          "text": "Analyze this video and list the key scenes."
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 2048,
    "thinkingConfig": {
      "thinkingLevel": "LOW"
    }
  }
}
EOF

Bu örnek, açan bir çiçeğin herkese açık MP4 videosunu analiz eder:

curl \
  "https://api.cometapi.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  --data-binary @- <<'EOF'
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "fileData": {
            "mimeType": "video/mp4",
            "fileUri": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
          }
        },
        {
          "text": "Analyze this video and list the key scenes."
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 2048,
    "thinkingConfig": {
      "thinkingLevel": "LOW"
    }
  }
}
EOF

Düşünmeyi yapılandırın (akıl yürütme)

Akıl yürütme derinliğini yönlendirmek için thinkingConfig.thinkingLevel kullanın. Aşağıdaki örneklerde LOW ve MEDIUM kullanılır.

Düşünme düzeyi
Düşünme özetleri

Bu örnek, düşünme düzeyini LOW olarak ayarlar:

curl \
  "https://api.cometapi.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  --data-binary @- <<'EOF'
{
  "contents": [
    {
      "parts": [
        {
          "text": "How does quantum computing work?"
        }
      ]
    }
  ],
  "generationConfig": {
    "thinkingConfig": {
      "thinkingLevel": "LOW"
    }
  }
}
EOF

Düşünme özeti istemek için includeThoughts ayarlayın. Yanıt bir özet içerdiğinde, metin bölümü thought: true olur:

curl \
  "https://api.cometapi.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  --data-binary @- <<'EOF'
{
  "contents": [
    {
      "parts": [
        {
          "text": "What is the 10th Fibonacci number when F(0)=0 and F(1)=1? Briefly verify the result."
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 4096,
    "thinkingConfig": {
      "thinkingLevel": "MEDIUM",
      "includeThoughts": true
    }
  }
}
EOF

thinkingBudget Gemini 2.5 dahil olmak üzere uyumlu modeller için sayısal bir denetimdir. Gemini 3 örneklerinde thinkingLevel kullanın ve her iki denetimi birden göndermeyin. Google’ın düşünme kılavuzuna modele özgü değerler için göz atın.

Yanıtları akışla iletin

Server-Sent Events almak için streamGenerateContent?alt=sse kullanın. Her data: satırı bir JSON GenerateContentResponse nesnesi içerir:

curl \
  "https://api.cometapi.com/v1beta/models/gemini-3.8-flash:streamGenerateContent?alt=sse" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  --no-buffer \
  --data-binary @- <<'EOF'
{
  "contents": [
    {
      "parts": [
        {
          "text": "Write a short poem about the stars"
        }
      ]
    }
  ]
}
EOF

Sistem talimatlarını ayarlayın

Yanıtı yönlendirmek için systemInstruction kullanın. Bu örnek, ek metin olmadan bir denklem ister:

curl \
  "https://api.cometapi.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  --data-binary @- <<'EOF'
{
  "contents": [
    {
      "parts": [
        {
          "text": "What is 2+2?"
        }
      ]
    }
  ],
  "systemInstruction": {
    "parts": [
      {
        "text": "You are a math tutor. Answer with exactly one equation and no other text."
      }
    ]
  }
}
EOF

JSON çıktısı isteyin

responseMimeType değerini application/json olarak ayarlayın ve bir responseSchema sağlayın. Bu örnek, adları ve sayısal uzaklıkları olan bir gezegen dizisi ister:

curl \
  "https://api.cometapi.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  --data-binary @- <<'EOF'
{
  "contents": [
    {
      "parts": [
        {
          "text": "Return a JSON array of 3 planets with name and average_distance_from_sun_au."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseMimeType": "application/json",
    "responseSchema": {
      "type": "ARRAY",
      "items": {
        "type": "OBJECT",
        "properties": {
          "name": {
            "type": "STRING",
            "description": "Name of the planet."
          },
          "average_distance_from_sun_au": {
            "type": "NUMBER",
            "description": "Average distance from the Sun, in astronomical units."
          }
        },
        "required": [
          "name",
          "average_distance_from_sun_au"
        ]
      }
    }
  }
}
EOF

Google Search ile grounding yapın

Arama grounding’i istemek için bir googleSearch aracı ekleyin. Bu örnek, UEFA EURO 2024 finalinin sonucunu sorar:

curl \
  "https://api.cometapi.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  --data-binary @- <<'EOF'
{
  "contents": [
    {
      "parts": [
        {
          "text": "Use Google Search to find the winner and final score of the UEFA EURO 2024 final. Cite your sources."
        }
      ]
    }
  ],
  "tools": [
    {
      "googleSearch": {}
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 2048
  }
}
EOF

Arama kullanıldığında, arama sorguları, kaynak URL’leri ve kaynaklarla yanıt metni arasındaki bağlantılar için adayın groundingMetadata öğesini inceleyin.

Konuşma içeriğini koruyun

Çok turlu konuşmalar için önceki user ve model içeriğini contents içinde gönderin. SDK sohbet örnekleri bu geçmişi sizin için korur. Function Calling için, her functionResponse adına eşleşen functionCall, name ve döndürülen tüm id ile birlikte bir thoughtSignature döndürün. Önceki model içeriğini, alanları da dahil olmak üzere değiştirmeden geri iletin. İmza opaktır; görüntülenen metinden yeniden oluşturmayın.

Yanıt örneği

Bir metin yanıtı, oluşturulan içeriği ve Token kullanımını içerir. Bu kısaltılmış örnekte isteğe bağlı alanlar atlanmıştır:

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "AI learns patterns from massive amounts of data to make predictions, solve problems, and generate new content. \n\nIn short: **Data in → Patterns found → Smart predictions out.**"
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 9,
    "candidatesTokenCount": 36,
    "thoughtsTokenCount": 388,
    "totalTokenCount": 433
  },
  "modelVersion": "gemini-3.8-flash"
}

thoughtsTokenCount yanıt bir düşünme özeti içermese bile dahili düşünme Token’larını raporlar. Her içerik bölümünü inceleyin; bir yanıt metin, özetler veya işlev çağrıları içerebilir.

İstek biçimlerini karşılaştırın

Gemini istek ve yanıt alanları için yerel endpoint’i seçin. Bkz. Chat Completions OpenAI uyumlu biçim için.

Alan	Gemini yerel	OpenAI uyumlu sohbet
Konuşma girdisi	`contents` ile `parts`	`messages`
Model kimliği	İstek yolunda	`model` istek gövdesinde
Oluşturulan içerik	`candidates` ile `content.parts`	`choices` ile `message`

Yetkilendirmeler

x-goog-api-key

string

header

gerekli

Your CometAPI key passed via the x-goog-api-key header. Bearer token authentication (Authorization: Bearer $COMETAPI_KEY) is also supported.

Yol Parametreleri

model

string

varsayılan:gemini-3.8-flash

gerekli

Gemini model ID. These examples use gemini-3.8-flash. See the Models page for available model IDs.

operator

enum<string>

varsayılan:generateContent

gerekli

Operation to perform. Use generateContent for a JSON response. For Server-Sent Events, select streamGenerateContent and set the separate alt query parameter to sse.

Mevcut seçenekler:

generateContent,

streamGenerateContent

Sorgu Parametreleri

alt

enum<string>

Set to sse when the operator is streamGenerateContent. Omit this parameter for generateContent.

Mevcut seçenekler:

sse

Gövde

application/json

contents

object[]

Conversation content. Each entry has an optional role (user or model) and a parts array. For tool results, preserve the complete preceding model content, including any thoughtSignature fields.

Show child attributes

systemInstruction

object

System instructions that guide the model's behavior across the entire conversation. Text only.

Show child attributes

tools

object[]

Tools available to the model during generation. Use googleSearch for search grounding.

Show child attributes

toolConfig

object

Configuration for tool usage, such as function calling mode.

Show child attributes

safetySettings

object[]

Safety filter settings. Override default thresholds for specific harm categories.

Show child attributes

generationConfig

object

Configuration for model generation behavior including temperature, output length, and response format.

Show child attributes

cachedContent

string

The name of cached content to use as context. Format: cachedContents/{id}. See the Gemini context caching documentation for details.

Yanıt

200 - application/json

Successful response. For streaming requests, the response is a stream of SSE events, each containing a GenerateContentResponse JSON object prefixed with data:.

candidates

object[]

The generated response candidates.

Show child attributes

promptFeedback

object

Feedback on the prompt, including safety blocking information.

Show child attributes

usageMetadata

object

Token usage statistics for the request.

Show child attributes

modelVersion

string

The model version that generated this response.

createTime

string

The timestamp when this response was created (ISO 8601 format).

responseId

string

Unique identifier for this response.

Son değiştirilme tarihi 8 Eylül 2026

import os
from google import genai

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

response = client.models.generate_content(
    model="gemini-3.8-flash",
    contents='Explain how AI works in a few words',
)

print(response.text)

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "AI learns patterns from massive amounts of data to make predictions, solve problems, and generate new content. \n\nIn short: **Data in → Patterns found → Smart predictions out.**"
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 9,
    "candidatesTokenCount": 36,
    "thoughtsTokenCount": 388,
    "totalTokenCount": 433
  },
  "modelVersion": "gemini-3.8-flash"
}

İçerik moderasyonu

API anahtarları

Hızlı başlangıç

Video girişi gönderme

Düşünmeyi yapılandırın (akıl yürütme)

Yanıtları akışla iletin

Sistem talimatlarını ayarlayın

JSON çıktısı isteyin

Google Search ile grounding yapın

Konuşma içeriğini koruyun

Yanıt örneği

İstek biçimlerini karşılaştırın

Yetkilendirmeler

Yol Parametreleri

Sorgu Parametreleri

Gövde

Yanıt

​Hızlı başlangıç

​Video girişi gönderme

​Düşünmeyi yapılandırın (akıl yürütme)

​Yanıtları akışla iletin

​Sistem talimatlarını ayarlayın

​JSON çıktısı isteyin

​Google Search ile grounding yapın

​Konuşma içeriğini koruyun

​Yanıt örneği

​İstek biçimlerini karşılaştırın

Yetkilendirmeler

Yol Parametreleri

Sorgu Parametreleri

Gövde

Yanıt

Hızlı başlangıç

Video girişi gönderme

Düşünmeyi yapılandırın (akıl yürütme)

Yanıtları akışla iletin

Sistem talimatlarını ayarlayın

JSON çıktısı isteyin

Google Search ile grounding yapın

Konuşma içeriğini koruyun

Yanıt örneği

İstek biçimlerini karşılaştırın