Skip to content
文本生成

Gemini generateContent ​

Gemini 原生协议,路径前缀为 /v1beta。仅 Gemini 分组可用。

POST/v1beta/models/{model}:generateContent
POST/v1beta/models/{model}:streamGenerateContent

认证 ​

推荐 x-goog-api-key 请求头。为兼容 Google 客户端,/v1beta 也接受 ?key= 查询参数和 Authorization: Bearer,见认证。

示例 ​

bash
curl "https://api.thetaio.tech/v1beta/models/gemini-2.5-pro:generateContent" \
  -H "x-goog-api-key: $THETAIO_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "用三句话解释量子纠缠"}]}]
  }'
python
from google import genai
from google.genai import types

client = genai.Client(
    api_key="sk-...",
    http_options=types.HttpOptions(base_url="https://api.thetaio.tech"),
)
response = client.models.generate_content(
    model="gemini-2.5-pro",
    contents="用三句话解释量子纠缠",
)
print(response.text)

流式请求使用 :streamGenerateContent?alt=sse。

其他端点 ​

方法路径说明
GET/v1beta/models列出可用模型
GET/v1beta/models/{model}查询单个模型
POST/v1beta/models/{model}:countTokens计算 Token
POST/v1beta/cachedContents创建上下文缓存
GET/v1beta/cachedContents列出上下文缓存
GET/v1beta/cachedContents/{id}查询上下文缓存
DELETE/v1beta/cachedContents/{id}删除上下文缓存

请求与响应格式同 Google 官方 Gemini API。