İçerik oluştur

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-flash-preview",
    contents="Explain how AI works in a few words",
)

print(response.text)

{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {
            "text": "<string>",
            "functionCall": {
              "name": "<string>",
              "args": {}
            },
            "inlineData": {
              "mimeType": "<string>",
              "data": "<string>"
            },
            "thought": true
          }
        ]
      },
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "<string>",
          "blocked": true
        }
      ],
      "citationMetadata": {
        "citationSources": [
          {
            "startIndex": 123,
            "endIndex": 123,
            "uri": "<string>",
            "license": "<string>"
          }
        ]
      },
      "tokenCount": 123,
      "avgLogprobs": 123,
      "groundingMetadata": {
        "groundingChunks": [
          {
            "web": {
              "uri": "<string>",
              "title": "<string>"
            }
          }
        ],
        "groundingSupports": [
          {
            "groundingChunkIndices": [
              123
            ],
            "confidenceScores": [
              123
            ],
            "segment": {
              "startIndex": 123,
              "endIndex": 123,
              "text": "<string>"
            }
          }
        ],
        "webSearchQueries": [
          "<string>"
        ]
      },
      "index": 123
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {
        "category": "<string>",
        "probability": "<string>",
        "blocked": true
      }
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123,
    "trafficType": "<string>",
    "thoughtsTokenCount": 123,
    "promptTokensDetails": [
      {
        "modality": "<string>",
        "tokenCount": 123
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "<string>",
        "tokenCount": 123
      }
    ]
  },
  "modelVersion": "<string>",
  "createTime": "<string>",
  "responseId": "<string>"
}

CometAPI, Gemini yerel API biçimini destekler ve size thinking control, Google Search grounding, yerel görüntü oluşturma modalities ve daha fazlası gibi Gemini’ye özgü özelliklere tam erişim sağlar. OpenAI uyumlu chat endpoint üzerinden sunulmayan yeteneklere ihtiyaç duyduğunuzda bu endpoint’i kullanın.

Tam istek alanları, yanıt şeması ve Gemini modele özgü davranışlar için yetkili kaynak olarak Google’ın resmi GenerateContent API reference belgesini kullanın. Bu CometAPI sayfası, bu yerel istek yapısını CometAPI üzerinden nasıl göndereceğinizi açıklar.

Google yerel API’yi güncelledikçe Gemini istek parametreleri ve yanıt alanları değişebilir. En güncel tam parametre listesi ve sağlayıcıya özgü davranış için Gemini metin üretimi dokümantasyonuna göz atın.

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

Hızlı başlangıç

CometAPI ile herhangi bir Gemini SDK’sını veya HTTP istemcisini kullanmak için base URL’yi ve API anahtarını değiştirin:

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

Video girdisi gönderme

Gemini generateContent, videoyu bir içerik parçası olarak kabul eder. Videonun nerede depolandığına göre giriş şeklini seçin:

Video kaynağı	İstek parçası	Kullanım durumu
Yerel video dosyası	`inlineData`	Video, JSON isteğinde base64 olarak gönderilebilecek kadar küçükse.
Genel video URL’si	`fileData.fileUri`	Video, kimlik doğrulaması gerektirmeyen genel bir HTTPS URL’si üzerinden erişilebiliyorsa.

REST ve curl istekleri için, Gemini’nin inlineData.mimeType ve fileData.fileUri gibi camelCase alan adlarını kullanın. URL medyasını file_data.file_uri olarak göndermeyin.

Bu örnek, yerel bir MP4 dosyasını okur, base64 olarak kodlar ve istek gövdesinde gönderir:

read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY
VIDEO_PATH="./your_video.mp4"
VIDEO_B64=$(base64 < "$VIDEO_PATH" | tr -d '\n')

curl -X POST \
  "https://api.cometapi.com/v1beta/models/gemini-3.5-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": "${VIDEO_B64}"
          }
        },
        {
          "text": "Analyze this video and list the key scenes."
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 512,
    "thinkingConfig": {"thinkingLevel": "MINIMAL"}
  }
}
EOF

Bu örnek, fileData.fileUri ile genel bir MP4 URL’si gönderir:

read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY
VIDEO_URL="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"

curl -X POST \
  "https://api.cometapi.com/v1beta/models/gemini-3.5-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": "${VIDEO_URL}"
          }
        },
        {
          "text": "Analyze this video and list the key scenes."
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 512,
    "thinkingConfig": {"thinkingLevel": "MINIMAL"}
  }
}
EOF

CometAPI, bu endpoint için ayrı bir Gemini Files API yükleme akışını önermez. Medyayı inlineData veya fileData.fileUri ile doğrudan generateContent isteğinin içinde gönderin.

Thinking’i yapılandırma (reasoning)

Gemini modelleri, bir yanıt üretmeden önce dahili reasoning gerçekleştirebilir. Kontrol yöntemi, model nesline bağlıdır.

Gemini 3 (thinkingLevel)
Gemini 2.5 (thinkingBudget)

Gemini 3 modelleri, reasoning derinliğini kontrol etmek için thinkingLevel kullanır. Kullanılabilir seviyeler: MINIMAL, LOW, MEDIUM, HIGH.Özellikle farklı bir Gemini 3 varyantına ihtiyacınız yoksa varsayılan örnek model olarak gemini-3-flash-preview kullanın.

curl "https://api.cometapi.com/v1beta/models/gemini-3-flash-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  -d '{
    "contents": [{"parts": [{"text": "Explain quantum physics simply."}]}],
    "generationConfig": {
      "thinkingConfig": {"thinkingLevel": "LOW"}
    }
  }'

Gemini 2.5 modelleri, ayrıntılı Token düzeyinde kontrol için thinkingBudget kullanır:

0 — thinking’i devre dışı bırak
-1 — dinamik (modele bırakılır, varsayılan)
> 0 — belirli Token bütçesi (ör. 1024, 2048)

curl "https://api.cometapi.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  -d '{
    "contents": [{"parts": [{"text": "Solve this logic puzzle step by step."}]}],
    "generationConfig": {
      "thinkingConfig": {"thinkingBudget": 2048}
    }
  }'

Gemini 2.5 modelleriyle thinkingLevel kullanmak (veya Gemini 3 modelleriyle thinkingBudget kullanmak) hatalara neden olabilir. Model sürümünüz için doğru parametreyi kullanın.

Yanıtları stream etme

Model içerik üretirken Server-Sent Events almak için operatör olarak streamGenerateContent?alt=sse kullanın. Her SSE olayı, JSON GenerateContentResponse nesnesi içeren bir data: satırı barındırır.

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

System instructions ayarlama

Tüm konuşma boyunca modelin davranışını yönlendirmek için systemInstruction kullanın:

curl "https://api.cometapi.com/v1beta/models/gemini-3-flash-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  -d '{
    "contents": [{"parts": [{"text": "What is 2+2?"}]}],
    "systemInstruction": {
      "parts": [{"text": "You are a math tutor. Always show your work."}]
    }
  }'

JSON çıktı isteme

Yapılandırılmış JSON çıktısını zorlamak için responseMimeType ayarlayın. Katı şema doğrulaması için isteğe bağlı olarak responseSchema sağlayabilirsiniz:

curl "https://api.cometapi.com/v1beta/models/gemini-3-flash-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  -d '{
    "contents": [{"parts": [{"text": "List 3 planets with their distances from the sun"}]}],
    "generationConfig": {
      "responseMimeType": "application/json"
    }
  }'

Google Search ile Grounding ekleme

Gerçek zamanlı web aramasını etkinleştirmek için bir googleSearch aracı ekleyin:

curl "https://api.cometapi.com/v1beta/models/gemini-3-flash-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  -d '{
    "contents": [{"parts": [{"text": "Who won the euro 2024?"}]}],
    "tools": [{"google_search": {}}]
  }'

Yanıt, kaynak URL’leri ve güven skorlarıyla birlikte groundingMetadata içerir.

Yanıt örneği

CometAPI’nin Gemini endpoint’inden tipik bir yanıt:

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [{"text": "Hello"}]
      },
      "finishReason": "STOP",
      "avgLogprobs": -0.0023
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 1,
    "totalTokenCount": 30,
    "trafficType": "ON_DEMAND",
    "thoughtsTokenCount": 24,
    "promptTokensDetails": [{"modality": "TEXT", "tokenCount": 5}],
    "candidatesTokensDetails": [{"modality": "TEXT", "tokenCount": 1}]
  },
  "modelVersion": "gemini-3-flash-preview",
  "createTime": "2026-03-25T04:21:43.756483Z",
  "responseId": "CeynaY3LDtvG4_UP0qaCuQY"
}

usageMetadata içindeki thoughtsTokenCount alanı, düşünme çıktısı yanıta dahil edilmese bile modelin dahili akıl yürütme için kaç token harcadığını gösterir.

OpenAI-compatible endpoint ile karşılaştırma

Özellik	Gemini Native (`/v1beta/models/...`)	OpenAI-Compatible (`/v1/chat/completions`)
Düşünme kontrolü	`thinkingConfig` ile `thinkingLevel` / `thinkingBudget`	Kullanılamaz
Google Search grounding	`tools: [\{"google_search": \{\}\}]`	Kullanılamaz
Google Maps grounding	`tools: [\{"googleMaps": \{\}\}]`	Kullanılamaz
Görsel oluşturma modality’si	`responseModalities: ["IMAGE"]`	Kullanılamaz
Kimlik doğrulama başlığı	`x-goog-api-key` veya `Bearer`	Yalnızca `Bearer`
Yanıt biçimi	Gemini yerel biçimi (`candidates`, `parts`)	OpenAI biçimi (`choices`, `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

gerekli

Gemini model ID. Example: gemini-3-flash-preview, gemini-2.5-pro. See the Models page for current options.

operator

enum<string>

gerekli

The operation to perform. Use generateContent for synchronous responses, or streamGenerateContent?alt=sse for Server-Sent Events streaming.

Mevcut seçenekler:

generateContent,

streamGenerateContent?alt=sse

Gövde

application/json

contents

object[]

Conversation content. Each entry has an optional role (user or model) and a parts array.

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 the model may use to generate responses. Supports function declarations, Google Search, Google Maps, and code execution.

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.

Bir Message oluştur

Görüntü oluşturma ve düzenleme API'leri

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-flash-preview",
    contents="Explain how AI works in a few words",
)

print(response.text)

{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {
            "text": "<string>",
            "functionCall": {
              "name": "<string>",
              "args": {}
            },
            "inlineData": {
              "mimeType": "<string>",
              "data": "<string>"
            },
            "thought": true
          }
        ]
      },
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "<string>",
          "blocked": true
        }
      ],
      "citationMetadata": {
        "citationSources": [
          {
            "startIndex": 123,
            "endIndex": 123,
            "uri": "<string>",
            "license": "<string>"
          }
        ]
      },
      "tokenCount": 123,
      "avgLogprobs": 123,
      "groundingMetadata": {
        "groundingChunks": [
          {
            "web": {
              "uri": "<string>",
              "title": "<string>"
            }
          }
        ],
        "groundingSupports": [
          {
            "groundingChunkIndices": [
              123
            ],
            "confidenceScores": [
              123
            ],
            "segment": {
              "startIndex": 123,
              "endIndex": 123,
              "text": "<string>"
            }
          }
        ],
        "webSearchQueries": [
          "<string>"
        ]
      },
      "index": 123
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {
        "category": "<string>",
        "probability": "<string>",
        "blocked": true
      }
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123,
    "trafficType": "<string>",
    "thoughtsTokenCount": 123,
    "promptTokensDetails": [
      {
        "modality": "<string>",
        "tokenCount": 123
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "<string>",
        "tokenCount": 123
      }
    ]
  },
  "modelVersion": "<string>",
  "createTime": "<string>",
  "responseId": "<string>"
}

İçerik moderasyonu

API anahtarları

Hızlı başlangıç

Video girdisi gönderme

Thinking’i yapılandırma (reasoning)

Yanıtları stream etme

System instructions ayarlama

JSON çıktı isteme

Google Search ile Grounding ekleme

Yanıt örneği

OpenAI-compatible endpoint ile karşılaştırma

Yetkilendirmeler

Yol Parametreleri

Gövde

Yanıt

​Hızlı başlangıç

​Video girdisi gönderme

​Thinking’i yapılandırma (reasoning)

​Yanıtları stream etme

​System instructions ayarlama

​JSON çıktı isteme

​Google Search ile Grounding ekleme

​Yanıt örneği

​OpenAI-compatible endpoint ile karşılaştırma

Yetkilendirmeler

Yol Parametreleri

Gövde

Yanıt

Hızlı başlangıç

Video girdisi gönderme

Thinking’i yapılandırma (reasoning)

Yanıtları stream etme

System instructions ayarlama

JSON çıktı isteme

Google Search ile Grounding ekleme

Yanıt örneği

OpenAI-compatible endpoint ile karşılaştırma