端点
POST /v1beta/models/{model}:generateContent
Gemini 原生协议端点，请求与响应格式和 Google 官方 API 一致。Base URL 不含 /v1，完整地址为 https://caapi.top/v1beta/models/{model}:generateContent。
请求
请求头
| 请求头 | 取值 | 说明 |
|---|---|---|
x-goog-api-key | sk-xxxxxx | 鉴权（Google GenAI SDK 默认用它）。也可以改用 Authorization: Bearer 或 x-api-key |
content-type | application/json |
最小请求体：
json
{
"contents": [
{"role": "user", "parts": [{"text": "用一句话介绍你自己"}]}
]
}参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
{model} | 路径 | 是 | Gemini 模型 ID，如 gemini-3.5-flash |
contents | array | 是 | 对话内容，role 为 user 或 model，parts 为文本（text）或内联数据（inlineData） |
generationConfig | object | 否 | 生成配置：temperature、topP、topK、maxOutputTokens、seed；图像模型另有 responseModalities、imageConfig |
其余字段按 Gemini API 格式透传。
响应
json
{
"candidates": [
{
"content": {"role": "model", "parts": [{"text": "我是 Gemini……"}]},
"finishReason": "STOP"
}
],
"usageMetadata": {"promptTokenCount": 12, "candidatesTokenCount": 22, "totalTokenCount": 34},
"modelVersion": "gemini-3.5-flash",
"responseId": "…"
}| 字段 | 说明 |
|---|---|
candidates[].content.parts[] | 回复内容，文本在 text；图像模型返回 inlineData |
candidates[].finishReason | 停止原因，如 STOP |
usageMetadata | token 用量 |
modelVersion | 实际响应的模型 |
responseId | 响应 ID |
示例
bash
curl https://caapi.top/v1beta/models/gemini-3.5-flash:generateContent \
-H "Authorization: Bearer sk-xxxxxx" \
-H "content-type: application/json" \
-d '{
"contents": [
{"role": "user", "parts": [{"text": "用一句话介绍你自己"}]}
]
}'使用 Google 官方 SDK 时，将 Base URL 指向 https://caapi.top、API Key 填写 CA API Key；常用环境变量：
bash
export GOOGLE_GEMINI_BASE_URL="https://caapi.top"
export GEMINI_API_KEY="sk-xxxxxx"
export GEMINI_API_KEY_AUTH_MECHANISM="bearer"错误
| HTTP 状态 | error.type | 触发条件 |
|---|---|---|
| 401 | missing_auth_credential / invalid_api_key / invalid_bearer_token | 鉴权失败，详见 鉴权 |
| 400 | model_not_supported | 该模型当前不支持调用，改用 GET /v1/models 中的其他模型 |