Content genereren

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

Gebruik de native aanvraagindeling van Gemini via CometAPI om tekst te genereren, video-invoer te verzenden en thinking of tools te configureren. De voorbeelden gebruiken gemini-3.8-flash.

Gebruik de GenerateContent API-referentie van Google voor velddefinities en modelspecifieke opties. Deze pagina toont de CometAPI-basis-URL, authenticatie en aanvraagvoorbeelden.

Zowel de headers x-goog-api-key als Authorization: Bearer worden ondersteund voor authenticatie.

Snel aan de slag

Configureer de basis-URL en API-sleutel om de Google Gen AI SDK of een HTTP-client met CometAPI te gebruiken:

Instelling	Google-standaard	CometAPI
Basis-URL	`generativelanguage.googleapis.com`	`api.cometapi.com`
API-sleutel	`$GEMINI_API_KEY`	`$COMETAPI_KEY`

Gebruik de handleiding voor tekstgeneratie met GenerateContent voor voorbeelden van de native API. Behoud de aanvraagstructuur van generateContent wanneer je de basis-URL wijzigt.

Video-invoer verzenden

Verzend video als een contentonderdeel. Kies de invoervorm op basis van waar de video is opgeslagen:

Videobron	Aanvraagonderdeel	Gebruik wanneer
Lokaal videobestand	`inlineData`	De video klein genoeg is om als base64 in de JSON-aanvraag te verzenden.
Openbare video-URL	`fileData.fileUri`	De video beschikbaar is via een openbare HTTPS-URL die geen authenticatie vereist.

Gebruik voor REST- en curl-aanvragen camelCase-veldnamen, zoals inlineData.mimeType en fileData.fileUri.

Dit voorbeeld verzendt inline MP4-gegevens. Vervang <base64-encoded-mp4> door de base64-inhoud van je video:

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

Dit voorbeeld analyseert een openbare MP4 van een bloem die opengaat:

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

Redeneren configureren (redeneren)

Gebruik thinkingConfig.thinkingLevel om de diepgang van het redeneren te sturen. In de onderstaande voorbeelden worden LOW en MEDIUM gebruikt.

Denkniveau
Denkoverzichten

In dit voorbeeld wordt het denkniveau ingesteld op 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

Stel includeThoughts in om een denkoverzicht aan te vragen. Wanneer het antwoord een overzicht bevat, heeft het tekstgedeelte ervan 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 is een numerieke instelling voor compatibele modellen, waaronder Gemini 2.5. Gebruik thinkingLevel in de Gemini 3-voorbeelden en verstuur niet beide instellingen. Zie de Google- thinking guide voor modelspecifieke waarden.

Antwoorden streamen

Gebruik streamGenerateContent?alt=sse om Server-Sent Events te ontvangen. Elke regel data: bevat een JSON-object 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

Systeeminstructies instellen

Gebruik systemInstruction om het antwoord te sturen. In dit voorbeeld wordt één vergelijking zonder aanvullende tekst aangevraagd:

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-uitvoer aanvragen

Stel responseMimeType in op application/json en geef een responseSchema op. In dit voorbeeld wordt een array met planeten, namen en numerieke afstanden aangevraagd:

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

Grounding met Google Search

Voeg een googleSearch-tool toe om search grounding aan te vragen. Dit voorbeeld vraagt naar het resultaat van de UEFA EURO 2024-finale:

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

Wanneer search wordt gebruikt, inspecteer je de groundingMetadata van de kandidaat op zoekopdrachten, bron-URL’s en koppelingen tussen bronnen en antwoordtekst.

Gespreksinhoud behouden

Stuur voor gesprekken met meerdere beurten de voorafgaande user- en model-inhoud mee in contents. De SDK-chatvoorbeelden bewaren deze geschiedenis voor je. Voor Function Calling retourneer je één functionResponse voor elke functionCall, met de overeenkomende name en eventuele geretourneerde id. Stuur de voorafgaande modelinhoud ongewijzigd terug, inclusief de velden thoughtSignature. De signature is ondoorzichtig; reconstrueer deze niet op basis van weergegeven tekst.

Antwoordvoorbeeld

Een tekstantwoord bevat gegenereerde inhoud en tokengebruik. Dit verkorte voorbeeld laat optionele velden weg:

{
  "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 rapporteert interne thinking tokens, zelfs wanneer het antwoord geen thinking summary bevat. Inspecteer elk inhoudsdeel; een antwoord kan tekst, samenvattingen of functieaanroepen bevatten.

Aanvraagindelingen vergelijken

Gebruik het native endpoint voor Gemini-aanvraag- en antwoordvelden. Zie Chat Completions voor de OpenAI-compatibele indeling.

Veld	Gemini native	OpenAI-compatibele chat
Gespreksinvoer	`contents` met `parts`	`messages`
Model-ID	In het aanvraagpad	`model` in de aanvraagbody
Gegenereerde inhoud	`candidates` met `content.parts`	`choices` met `message`

Autorisaties

x-goog-api-key

string

header

vereist

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

Padparameters

model

string

standaard:gemini-3.8-flash

vereist

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

operator

enum<string>

standaard:generateContent

vereist

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

Beschikbare opties:

generateContent,

streamGenerateContent

Queryparameters

alt

enum<string>

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

Beschikbare opties:

sse

Body

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.

Respons

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.

Laatst gewijzigd op 8 september 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"
}

Contentmoderatie

API-sleutels

Snel aan de slag

Video-invoer verzenden

Redeneren configureren (redeneren)

Antwoorden streamen

Systeeminstructies instellen

JSON-uitvoer aanvragen

Grounding met Google Search

Gespreksinhoud behouden

Antwoordvoorbeeld

Aanvraagindelingen vergelijken

Autorisaties

Padparameters

Queryparameters

Body

Respons

​Snel aan de slag

​Video-invoer verzenden

​Redeneren configureren (redeneren)

​Antwoorden streamen

​Systeeminstructies instellen

​JSON-uitvoer aanvragen

​Grounding met Google Search

​Gespreksinhoud behouden

​Antwoordvoorbeeld

​Aanvraagindelingen vergelijken

Autorisaties

Padparameters

Queryparameters

Body

Respons

Snel aan de slag

Video-invoer verzenden

Redeneren configureren (redeneren)

Antwoorden streamen

Systeeminstructies instellen

JSON-uitvoer aanvragen

Grounding met Google Search

Gespreksinhoud behouden

Antwoordvoorbeeld

Aanvraagindelingen vergelijken