Generar contenido

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

Usa el formato de solicitud nativo de Gemini a través de CometAPI para generar texto, enviar entrada de video y configurar razonamiento o herramientas. Los ejemplos usan gemini-3.8-flash.

Consulta la referencia de la API GenerateContent para ver las definiciones de campos y las opciones específicas de cada modelo. Esta página muestra la URL base de CometAPI, la autenticación y ejemplos de solicitudes.

Se admiten los encabezados x-goog-api-key y Authorization: Bearer para la autenticación.

Inicio rápido

Para usar el SDK de Google Gen AI o un cliente HTTP con CometAPI, configura la URL base y la clave de API:

Configuración	Valor predeterminado de Google	CometAPI
URL base	`generativelanguage.googleapis.com`	`api.cometapi.com`
Clave de API	`$GEMINI_API_KEY`	`$COMETAPI_KEY`

Usa la guía de generación de texto de GenerateContent para ver ejemplos de la API nativa. Conserva la estructura de solicitud generateContent al cambiar la URL base.

Enviar entrada de video

Envía el video como una parte de contenido. Elige la estructura de entrada según dónde esté almacenado el video:

Origen del video	Parte de la solicitud	Cuándo usarlo
Archivo de video local	`inlineData`	El video es lo suficientemente pequeño como para enviarlo como base64 en la solicitud JSON.
URL pública de video	`fileData.fileUri`	El video está disponible mediante una URL HTTPS pública que no requiere autenticación.

Para las solicitudes REST y curl, usa nombres de campos camelCase como inlineData.mimeType y fileData.fileUri.

Este ejemplo envía datos MP4 en línea. Reemplaza <base64-encoded-mp4> por el contenido base64 de tu 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

Este ejemplo analiza un MP4 público de una flor que se abre:

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

Configurar el pensamiento (razonamiento)

Use thinkingConfig.thinkingLevel para guiar la profundidad del razonamiento. Los ejemplos siguientes usan LOW y MEDIUM.

Nivel de pensamiento
Resúmenes de pensamiento

Este ejemplo establece el nivel de pensamiento en 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

Establezca includeThoughts para solicitar un resumen de pensamiento. Cuando la respuesta incluye un resumen, su parte de texto tiene 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 es un control numérico para modelos compatibles, incluido Gemini 2.5. Use thinkingLevel en los ejemplos de Gemini 3 y no envíe ambos controles. Consulte la guía de Google sobre razonamiento para conocer los valores específicos de cada modelo.

Transmitir respuestas

Use streamGenerateContent?alt=sse para recibir Server-Sent Events. Cada línea data: contiene un objeto 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

Establecer instrucciones del sistema

Use systemInstruction para guiar la respuesta. Este ejemplo solicita una ecuación sin texto adicional:

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

Solicitar salida JSON

Establezca responseMimeType en application/json y proporcione un responseSchema. Este ejemplo solicita una matriz de planetas con nombres y distancias numéricas:

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 con Google Search

Agrega una herramienta googleSearch para solicitar grounding de búsqueda. Este ejemplo solicita el resultado de la final de la 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

Cuando se usa la búsqueda, inspecciona los groundingMetadata del candidato para ver las consultas de búsqueda, las URL de las fuentes y los vínculos entre las fuentes y el texto de respuesta.

Conserva el contenido de la conversación

Para conversaciones de varios turnos, envía el contenido precedente de user y model en contents. Los ejemplos de chat del SDK mantienen este historial por ti. Para las llamadas a funciones, devuelve un functionResponse por cada functionCall, con el name correspondiente y cualquier id devuelto. Vuelve a փոխանցar el contenido precedente del modelo sin cambios, incluidos los campos thoughtSignature. La firma es opaca; no la reconstruyas a partir del texto mostrado.

Ejemplo de respuesta

Una respuesta de texto incluye contenido generado y uso de Tokens. Este ejemplo abreviado omite campos opcionales:

{
  "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 informa sobre Tokens de razonamiento internos, incluso cuando la respuesta no incluye un resumen de razonamiento. Inspecciona cada parte del contenido; una respuesta puede contener texto, resúmenes o llamadas a funciones.

Compara los formatos de solicitud

Elige el endpoint nativo para los campos de solicitud y respuesta de Gemini. Consulta Chat Completions para conocer el formato compatible con OpenAI.

Campo	Gemini nativo	Chat compatible con OpenAI
Entrada de conversación	`contents` con `parts`	`messages`
ID de modelo	En la ruta de la solicitud	`model` en el cuerpo de la solicitud
Contenido generado	`candidates` con `content.parts`	`choices` con `message`

Autorizaciones

x-goog-api-key

string

header

requerido

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

Parámetros de ruta

model

string

predeterminado:gemini-3.8-flash

requerido

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

operator

enum<string>

predeterminado:generateContent

requerido

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

Opciones disponibles:

generateContent,

streamGenerateContent

Parámetros de consulta

alt

enum<string>

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

Opciones disponibles:

sse

Cuerpo

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.

Respuesta

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.

Última modificación el 8 de septiembre de 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"
}

Moderación de contenido

Claves API

Inicio rápido

Enviar entrada de video

Configurar el pensamiento (razonamiento)

Transmitir respuestas

Establecer instrucciones del sistema

Solicitar salida JSON

Grounding con Google Search

Conserva el contenido de la conversación

Ejemplo de respuesta

Compara los formatos de solicitud

Autorizaciones

Parámetros de ruta

Parámetros de consulta

Cuerpo

Respuesta

​Inicio rápido

​Enviar entrada de video

​Configurar el pensamiento (razonamiento)

​Transmitir respuestas

​Establecer instrucciones del sistema

​Solicitar salida JSON

​Grounding con Google Search

​Conserva el contenido de la conversación

​Ejemplo de respuesta

​Compara los formatos de solicitud

Autorizaciones

Parámetros de ruta

Parámetros de consulta

Cuerpo

Respuesta

Inicio rápido

Enviar entrada de video

Configurar el pensamiento (razonamiento)

Transmitir respuestas

Establecer instrucciones del sistema

Solicitar salida JSON

Grounding con Google Search

Conserva el contenido de la conversación

Ejemplo de respuesta

Compara los formatos de solicitud