Gemini 原生协议

POST https://ai-api.mandao.com/v1beta/models/{model}:{action}

Gemini 原生 API 格式，支持 generateContent、streamGenerateContent 等操作。

请求参数

路径参数

参数名 类型 必需 说明
model string 是 模型 ID，如 gemini-2.5-flash
action string 是 操作类型，如 generateContent、streamGenerateContent

Body 参数 (application/json)

参数名 类型 必需 说明
contents array[object] 是 对话内容列表
contents[].role string 否 角色：user、model
contents[].parts array[object] 否 内容部分，每项包含 text 字段
generationConfig object 否 生成配置
generationConfig.temperature number 否 采样温度
generationConfig.maxOutputTokens integer 否 最大输出 token 数
generationConfig.topP number 否 核采样参数
generationConfig.topK integer 否 Top-K 采样
safetySettings array[object] 否 安全设置

请求示例

curl --location 'https://ai-api.mandao.com/v1beta/models/gemini-2.5-flash:generateContent' \
--header 'Authorization: Bearer <your-api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "请提供一份收入报表分析。"
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 1,
        "maxOutputTokens": 65535,
        "topP": 0.95
    }
}'

返回响应

200 成功

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "text": "以下是收入报表分析..."
                    }
                ]
            },
            "finishReason": "STOP"
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 15,
        "candidatesTokenCount": 200,
        "totalTokenCount": 215
    }
}

注意事项

  • Gemini 原生协议使用 /v1beta/models/* 路径。
  • 支持 x-goog-api-key Header 认证（自动转换为 Bearer Token）。
  • 支持 URL query ?key= 参数传递 API Key。
  • Gemini Embedding 接口可通过 /v1beta/models/{model}:embed 或 /v1/engines/{model}/embeddings 访问。