Текстові моделі

Генерування контенту

Використовуйте нативний формат API Gemini через CometAPI для генерування тексту, відеовходу, підсумків міркувань, заземлення за допомогою Google Search, виведення JSON і Streaming.

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

Використовуйте нативний формат запиту Gemini через CometAPI, щоб генерувати текст, надсилати відеовхід і налаштовувати міркування або інструменти. У прикладах використовується gemini-3.8-flash.

Використовуйте довідкову документацію Google щодо API GenerateContent для визначень полів і параметрів, специфічних для моделі. На цій сторінці наведено базову URL-адресу CometAPI, автентифікацію та приклади запитів.

Для автентифікації підтримуються заголовки x-goog-api-key і Authorization: Bearer.

Швидкий початок

Щоб використовувати Google Gen AI SDK або HTTP-клієнт із CometAPI, налаштуйте базову URL-адресу та ключ API:

Параметр	Стандартне значення Google	CometAPI
Базова URL-адреса	`generativelanguage.googleapis.com`	`api.cometapi.com`
Ключ API	`$GEMINI_API_KEY`	`$COMETAPI_KEY`

Скористайтеся посібником із генерування тексту GenerateContent для прикладів нативного API. Змінюючи базову URL-адресу, зберігайте структуру запиту generateContent.

Надсилання відеовходу

Надсилайте відео як частину вмісту. Виберіть форму вхідних даних залежно від того, де зберігається відео:

Джерело відео	Частина запиту	Використовуйте, коли
Локальний відеофайл	`inlineData`	Відео достатньо мале, щоб надіслати його як base64 у JSON-запиті.
Загальнодоступна URL-адреса відео	`fileData.fileUri`	Відео доступне через загальнодоступну URL-адресу HTTPS, яка не потребує автентифікації.

Для запитів REST і curl використовуйте назви полів у camelCase, наприклад inlineData.mimeType і fileData.fileUri.

У цьому прикладі надсилаються вбудовані дані MP4. Замініть <base64-encoded-mp4> на вміст вашого відео у base64:

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

У цьому прикладі аналізується загальнодоступне відео MP4 із квіткою, що розкривається:

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

Налаштування мислення (міркування)

Використовуйте thinkingConfig.thinkingLevel, щоб керувати глибиною міркувань. У наведених нижче прикладах використовуються LOW і MEDIUM.

Рівень мислення
Підсумки мислення

У цьому прикладі рівень мислення встановлюється на LOW:

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

Установіть includeThoughts, щоб запитати підсумок мислення. Якщо відповідь містить підсумок, її текстова частина має thought: true:

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. Використовуйте thinkingLevel у прикладах для Gemini 3 і не надсилайте обидва параметри. Див. посібник Google щодо мислення для значень, специфічних для моделей.

Потокова передача відповідей

Використовуйте streamGenerateContent?alt=sse для отримання Server-Sent Events. Кожен рядок data: містить JSON-об’єкт GenerateContentResponse:

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

Установлення системних інструкцій

Використовуйте systemInstruction, щоб спрямувати відповідь. У цьому прикладі запитується одне рівняння без додаткового тексту:

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-виводу

Установіть responseMimeType на application/json і надайте responseSchema. У цьому прикладі запитується масив планет із назвами та числовими відстанями:

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

Додайте інструмент googleSearch для надсилання запиту на пошукове заземлення. У цьому прикладі запитується результат фіналу UEFA EURO 2024:

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

Коли використовується пошук, перевірте groundingMetadata кандидата на наявність пошукових запитів, URL-адрес джерел і посилань між джерелами та текстом відповіді.

Зберігайте вміст розмови

Для багатокрокових розмов надсилайте попередній вміст user і model у contents. Приклади чату в SDK підтримують цю історію за вас. Для виклику функцій повертайте один functionResponse для кожного functionCall із відповідним name і будь-яким повернутим id. Передавайте попередній вміст моделі без змін, зокрема поля thoughtSignature. Підпис є непрозорим; не відтворюйте його з відображеного тексту.

Приклад відповіді

Текстова відповідь містить згенерований вміст і використання Tokens. У цьому скороченому прикладі пропущено необов’язкові поля:

{
  "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 повідомляє про внутрішні Tokens міркування, навіть якщо відповідь не містить підсумку міркувань. Перевіряйте кожну частину вмісту: відповідь може містити текст, підсумки або виклики функцій.

Порівняння форматів запитів

Виберіть нативну кінцеву точку для полів запитів і відповідей Gemini. Див. Chat Completions для формату, сумісного з OpenAI.

Поле	Нативний Gemini	Чат, сумісний з OpenAI
Вхідні дані розмови	`contents` з `parts`	`messages`
ID моделі	У шляху запиту	`model` у тілі запиту
Згенерований вміст	`candidates` з `content.parts`	`choices` з `message`

Авторизації

x-goog-api-key

string

header

обов'язково

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

Параметри шляху

model

string

за замовчуванням:gemini-3.8-flash

обов'язково

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

operator

enum<string>

за замовчуванням:generateContent

обов'язково

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

Доступні опції:

generateContent,

streamGenerateContent

Параметри запиту

alt

enum<string>

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

Доступні опції:

sse

Тіло

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.

Відповідь

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.

Останнє оновлення 8 вересня 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"
}

Модерація контенту

API-ключі

Генерування контенту

Швидкий початок

Надсилання відеовходу

Налаштування мислення (міркування)

Потокова передача відповідей

Установлення системних інструкцій

Запит JSON-виводу

Заземлення за допомогою Google Search

Зберігайте вміст розмови

Приклад відповіді

Порівняння форматів запитів

Авторизації

Параметри шляху

Параметри запиту

Тіло

Відповідь

​Швидкий початок

​Надсилання відеовходу

​Налаштування мислення (міркування)

​Потокова передача відповідей

​Установлення системних інструкцій

​Запит JSON-виводу

​Заземлення за допомогою Google Search

​Зберігайте вміст розмови

​Приклад відповіді

​Порівняння форматів запитів

Авторизації

Параметри шляху

Параметри запиту

Тіло

Відповідь

Швидкий початок

Надсилання відеовходу

Налаштування мислення (міркування)

Потокова передача відповідей

Установлення системних інструкцій

Запит JSON-виводу

Заземлення за допомогою Google Search

Зберігайте вміст розмови

Приклад відповіді

Порівняння форматів запитів