端点
POST /v1beta/models/{model}:generateContent
Gemini 原生协议端点，请求与响应格式和 Google 官方 API 一致。Base URL 不含 /v1，完整地址为 https://acapi.top/v1beta/models/{model}:generateContent（国内通道 https://api.acapi.top/v1beta/... 同样可用）。非流式请求超过约 30 秒可能被网络边缘断开，长输出请改用流式端点 :streamGenerateContent。
请求
请求头
| 请求头 | 取值 | 说明 |
|---|---|---|
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 |
其余字段按 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 |
candidates[].finishReason | 停止原因，如 STOP |
usageMetadata | token 用量 |
modelVersion | 模型版本标识，仅供参考（可能与请求的模型 ID 写法不同；计费与日志以请求的模型 ID 为准） |
responseId | 响应 ID |
示例
本页示例为海外模型，地址用国外通道 https://acapi.top；换成国内通道 https://api.acapi.top 同样可用，两个地址均可用，见 调用地址。
bash
curl https://acapi.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://api.acapi.top 或国外通道 https://acapi.top）、API Key 填写 云上创造 API Key；常用环境变量：
bash
export GOOGLE_GEMINI_BASE_URL="https://acapi.top"
export GEMINI_API_KEY="sk-xxxxxx"
export GEMINI_API_KEY_AUTH_MECHANISM="bearer"错误
| HTTP 状态 | error.type | 触发条件 |
|---|---|---|
| 401 | new_api_error（code 为空） | 鉴权失败，详见 鉴权 |
| 503 | model_not_found | 该模型当前不可用，改用 GET /v1/models 中的其他模型 |