Tạo nội dung

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

Sử dụng định dạng yêu cầu gốc của Gemini thông qua CometAPI để tạo văn bản, gửi đầu vào video và cấu hình quá trình suy luận hoặc công cụ. Các ví dụ sử dụng gemini-3.8-flash.

Hãy xem tài liệu tham khảo API GenerateContent của Google để biết định nghĩa trường và các tùy chọn dành riêng cho từng model. Trang này trình bày URL cơ sở CometAPI, phương thức xác thực và các ví dụ về yêu cầu.

Cả hai header x-goog-api-key và Authorization: Bearer đều được hỗ trợ để xác thực.

Bắt đầu nhanh

Để sử dụng Google Gen AI SDK hoặc ứng dụng HTTP client với CometAPI, hãy cấu hình URL cơ sở và API key:

Thiết lập	Mặc định của Google	CometAPI
URL cơ sở	`generativelanguage.googleapis.com`	`api.cometapi.com`
API key	`$GEMINI_API_KEY`	`$COMETAPI_KEY`

Hãy sử dụng hướng dẫn tạo văn bản bằng GenerateContent để xem các ví dụ về API gốc. Giữ nguyên cấu trúc yêu cầu generateContent khi thay đổi URL cơ sở.

Gửi đầu vào video

Gửi video dưới dạng một phần nội dung. Chọn cấu trúc đầu vào dựa trên nơi lưu trữ video:

Nguồn video	Phần yêu cầu	Dùng khi
Tệp video cục bộ	`inlineData`	Video đủ nhỏ để gửi dưới dạng base64 trong yêu cầu JSON.
URL video công khai	`fileData.fileUri`	Video có sẵn qua URL HTTPS công khai không yêu cầu xác thực.

Đối với các yêu cầu REST và curl, hãy sử dụng tên trường camelCase như inlineData.mimeType và fileData.fileUri.

Ví dụ này gửi dữ liệu MP4 inline. Thay thế <base64-encoded-mp4> bằng nội dung base64 của 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

Ví dụ này phân tích một video MP4 công khai về bông hoa đang nở:

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

Cấu hình quá trình suy luận (suy luận)

Sử dụng thinkingConfig.thinkingLevel để định hướng độ sâu suy luận. Các ví dụ dưới đây sử dụng LOW và MEDIUM.

Mức độ suy luận
Tóm tắt quá trình suy luận

Ví dụ này đặt mức độ suy luận thành 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

Đặt includeThoughts để yêu cầu bản tóm tắt quá trình suy luận. Khi phản hồi bao gồm bản tóm tắt, phần văn bản của phản hồi có 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 là một chế độ điều khiển bằng số dành cho các mô hình tương thích, bao gồm Gemini 2.5. Hãy sử dụng thinkingLevel trong các ví dụ về Gemini 3 và không gửi đồng thời cả hai chế độ điều khiển. Xem hướng dẫn về quá trình suy luận của Google hướng dẫn về quá trình suy luận để biết các giá trị dành riêng cho từng mô hình.

Truyền trực tuyến phản hồi

Sử dụng streamGenerateContent?alt=sse để nhận Server-Sent Events. Mỗi dòng data: chứa một đối tượng 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

Đặt chỉ dẫn hệ thống

Sử dụng systemInstruction để định hướng phản hồi. Ví dụ này yêu cầu một phương trình không kèm văn bản bổ sung:

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

Yêu cầu đầu ra JSON

Đặt responseMimeType thành application/json và cung cấp một responseSchema. Ví dụ này yêu cầu một mảng các hành tinh có tên và khoảng cách dạng số:

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

Ground bằng Google Search

Thêm một công cụ googleSearch để yêu cầu grounding bằng tìm kiếm. Ví dụ này yêu cầu kết quả trận chung kết 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

Khi sử dụng tính năng tìm kiếm, hãy kiểm tra groundingMetadata của candidate để biết các truy vấn tìm kiếm, URL nguồn và các liên kết giữa nguồn với văn bản phản hồi.

Bảo toàn nội dung cuộc trò chuyện

Đối với các cuộc hội thoại nhiều lượt, hãy gửi nội dung user và model trước đó trong contents. Các ví dụ chat của SDK sẽ duy trì lịch sử này cho bạn. Đối với function calling, hãy trả về một functionResponse cho mỗi functionCall, với name tương ứng và mọi id được trả về. Truyền lại nguyên vẹn nội dung model trước đó, bao gồm các trường thoughtSignature. Chữ ký là opaque; không tái tạo lại từ văn bản hiển thị.

Ví dụ phản hồi

Một phản hồi văn bản bao gồm nội dung được tạo và mức sử dụng Token. Ví dụ rút gọn này bỏ qua các trường tùy chọn:

{
  "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 báo cáo các Token suy luận nội bộ, ngay cả khi phản hồi không có bản tóm tắt suy luận. Hãy kiểm tra từng phần nội dung; một phản hồi có thể chứa văn bản, bản tóm tắt hoặc lệnh gọi hàm.

So sánh các định dạng yêu cầu

Chọn endpoint gốc cho các trường yêu cầu và phản hồi của Gemini. Xem Chat Completions để biết định dạng tương thích OpenAI.

Trường	Gemini gốc	Chat tương thích OpenAI
Dữ liệu đầu vào hội thoại	`contents` với `parts`	`messages`
ID mô hình	Trong đường dẫn yêu cầu	`model` trong phần thân yêu cầu
Nội dung được tạo	`candidates` với `content.parts`	`choices` với `message`

Ủy quyền

x-goog-api-key

string

header

bắt buộc

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

Tham số đường dẫn

model

string

mặc định:gemini-3.8-flash

bắt buộc

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

operator

enum<string>

mặc định:generateContent

bắt buộc

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

Tùy chọn có sẵn:

generateContent,

streamGenerateContent

Tham số truy vấn

alt

enum<string>

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

Tùy chọn có sẵn:

sse

Nội dung

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.

Phản hồi

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.

Lần sửa đổi cuối 8 tháng 9, 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"
}

Kiểm duyệt nội dung

Khóa API

Bắt đầu nhanh

Gửi đầu vào video

Cấu hình quá trình suy luận (suy luận)

Truyền trực tuyến phản hồi

Đặt chỉ dẫn hệ thống

Yêu cầu đầu ra JSON

Ground bằng Google Search

Bảo toàn nội dung cuộc trò chuyện

Ví dụ phản hồi

So sánh các định dạng yêu cầu

Ủy quyền

Tham số đường dẫn

Tham số truy vấn

Nội dung

Phản hồi

​Bắt đầu nhanh

​Gửi đầu vào video

​Cấu hình quá trình suy luận (suy luận)

​Truyền trực tuyến phản hồi

​Đặt chỉ dẫn hệ thống

​Yêu cầu đầu ra JSON

​Ground bằng Google Search

​Bảo toàn nội dung cuộc trò chuyện

​Ví dụ phản hồi

​So sánh các định dạng yêu cầu

Ủy quyền

Tham số đường dẫn

Tham số truy vấn

Nội dung

Phản hồi

Bắt đầu nhanh

Gửi đầu vào video

Cấu hình quá trình suy luận (suy luận)

Truyền trực tuyến phản hồi

Đặt chỉ dẫn hệ thống

Yêu cầu đầu ra JSON

Ground bằng Google Search

Bảo toàn nội dung cuộc trò chuyện

Ví dụ phản hồi

So sánh các định dạng yêu cầu