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。