生成内容
端点
POST
/v1beta/models/{model}:generateContentGemini 原生协议端点，请求与响应格式和 Google 官方 API 一致。Base URL 不含 /v1，完整地址为 https://api.moyiapi.cn/v1beta/models/{model}:generateContent。
请求
| 请求头 | 取值 | 说明 |
|---|---|---|
x-goog-api-key |
sk-moyiapi-xxxxxx |
鉴权（Google GenAI SDK 默认用它）。也可以改用 Authorization: Bearer 或 x-api-key |
content-type |
application/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 格式透传。
响应
{
"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 |
示例
curl https://api.moyiapi.cn/v1beta/models/gemini-3.5-flash:generateContent \
-H "Authorization: Bearer sk-moyiapi-xxxxxx" \
-H "content-type: application/json" \
-d '{
"contents": [
{"role": "user", "parts": [{"text": "用一句话介绍你自己"}]}
]
}'
使用 Google 官方 SDK 时，将 Base URL 指向 https://api.moyiapi.cn、API Key 填写 模驿API API Key；常用环境变量：
export GOOGLE_GEMINI_BASE_URL="https://api.moyiapi.cn"
export GEMINI_API_KEY="sk-moyiapi-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 中的其他模型 |