Generer innhold

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

Bruk det opprinnelige Gemini-forespørselsformatet gjennom CometAPI for å generere tekst, sende videoinndata og konfigurere tenkning eller verktøy. Eksemplene bruker gemini-3.8-flash.

Googles GenerateContent API-referanse for feltdefinisjoner og modellspesifikke alternativer. Denne siden viser CometAPI-basis-URL-en, autentisering og forespørselseksempler.

Både x-goog-api-key- og Authorization: Bearer-headere støttes for autentisering.

Hurtigstart

For å bruke Google Gen AI SDK eller en HTTP-klient med CometAPI, konfigurerer du basis-URL-en og API-nøkkelen:

Innstilling	Googles standard	CometAPI
Basis-URL	`generativelanguage.googleapis.com`	`api.cometapi.com`
API-nøkkel	`$GEMINI_API_KEY`	`$COMETAPI_KEY`

Bruk GenerateContent-veiledningen for tekstgenerering for eksempler på det opprinnelige API-et. Behold generateContent-forespørselsstrukturen når du endrer basis-URL-en.

Send videoinndata

Send video som en innholdsdel. Velg inndataformen basert på hvor videoen er lagret:

Videokilde	Forespørselsdel	Brukes når
Lokal videofil	`inlineData`	Videoen er liten nok til å sendes som base64 i JSON-forespørselen.
Offentlig video-URL	`fileData.fileUri`	Videoen er tilgjengelig via en offentlig HTTPS-URL som ikke krever autentisering.

For REST- og curl-forespørsler bruker du camelCase-feltnavn som inlineData.mimeType og fileData.fileUri.

Dette eksempelet sender innebygde MP4-data. Erstatt <base64-encoded-mp4> med base64-innholdet i videoen din:

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

Dette eksempelet analyserer en offentlig MP4-video av en blomst som åpner seg:

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

Konfigurer tenking (resonnering)

Bruk thinkingConfig.thinkingLevel for å styre dybden på resonneringen. Eksemplene nedenfor bruker LOW og MEDIUM.

Tenkenivå
Tankesammendrag

Dette eksemplet angir tenkenivået til 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

Angi includeThoughts for å be om et tankesammendrag. Når svaret inneholder et sammendrag, har tekstdelen 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 er en numerisk kontroll for kompatible modeller, inkludert Gemini 2.5. Bruk thinkingLevel i eksemplene for Gemini 3, og ikke send begge kontrollene. Se Googles veiledning om resonnering for modellspesifikke verdier.

Strøm svar

Bruk streamGenerateContent?alt=sse for å motta Server-Sent Events. Hver data:-linje inneholder et JSON-objekt av typen 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

Angi systeminstruksjoner

Bruk systemInstruction for å styre svaret. Dette eksemplet ber om én ligning uten tilleggstekst:

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

Be om JSON-utdata

Angi responseMimeType til application/json, og oppgi en responseSchema. Dette eksemplet ber om en matrise med planeter med navn og numeriske avstander:

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

Forankre med Google Search

Legg til et googleSearch-verktøy for å be om søkeforankring. Dette eksemplet spør etter resultatet av UEFA EURO 2024-finalen:

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

Når søk brukes, bør du undersøke kandidatens groundingMetadata for søk, kilde-URL-er og koblinger mellom kilder og svartest.

Bevar samtaleinnhold

For samtaler med flere runder sender du det foregående user- og model-innholdet i contents. SDK-chatteksemplene opprettholder denne historikken for deg. For funksjonskall returnerer du én functionResponse for hver functionCall, med samsvarende name og eventuelle returnerte id. Send det foregående modellinnholdet tilbake uendret, inkludert feltene thoughtSignature. Signaturen er ugjennomsiktig; ikke rekonstruer den fra vist tekst.

Eksempel på respons

En tekstrespons inneholder generert innhold og tokenbruk. Dette forkortede eksemplet utelater valgfrie felt:

{
  "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 rapporterer interne tenke-Tokens, selv når responsen ikke inneholder et sammendrag av tenkingen. Undersøk hver innholdsdel; en respons kan inneholde tekst, sammendrag eller funksjonskall.

Sammenlign forespørselsformater

Velg det opprinnelige endepunktet for Gemini-forespørsels- og responsfelter. Se Chat Completions for det OpenAI-kompatible formatet.

Felt	Opprinnelig Gemini	OpenAI-kompatibel chat
Samtaleinndata	`contents` med `parts`	`messages`
Modell-ID	I forespørselsbanen	`model` i forespørselsteksten
Generert innhold	`candidates` med `content.parts`	`choices` med `message`

Autorisasjoner

x-goog-api-key

string

header

påkrevd

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

Stien-parametere

model

string

standard:gemini-3.8-flash

påkrevd

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

operator

enum<string>

standard:generateContent

påkrevd

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

Tilgjengelige alternativer:

generateContent,

streamGenerateContent

Spørring-parametere

alt

enum<string>

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

Tilgjengelige alternativer:

sse

Kropp

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.

Svar

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.

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

Innholdsmoderering

API-nøkler

Hurtigstart

Send videoinndata

Konfigurer tenking (resonnering)

Strøm svar

Angi systeminstruksjoner

Be om JSON-utdata

Forankre med Google Search

Bevar samtaleinnhold

Eksempel på respons

Sammenlign forespørselsformater

Autorisasjoner

Stien-parametere

Spørring-parametere

Kropp

Svar

​Hurtigstart

​Send videoinndata

​Konfigurer tenking (resonnering)

​Strøm svar

​Angi systeminstruksjoner

​Be om JSON-utdata

​Forankre med Google Search

​Bevar samtaleinnhold

​Eksempel på respons

​Sammenlign forespørselsformater

Autorisasjoner

Stien-parametere

Spørring-parametere

Kropp

Svar

Hurtigstart

Send videoinndata

Konfigurer tenking (resonnering)

Strøm svar

Angi systeminstruksjoner

Be om JSON-utdata

Forankre med Google Search

Bevar samtaleinnhold

Eksempel på respons

Sammenlign forespørselsformater