Skip to main content
POST
/
v1beta
/
models
/
{model}
:
{action}
curl -X POST https://www.geeknow.top/v1beta/models/gemini-2.0-flash:generateContent \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "用三句话介绍 Gemini 原生接口。" }
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 300
    }
  }'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Gemini 原生接口使用 contents 和 parts 表达输入内容。它支持文本、图片、文件和函数调用等能力。通过统一网关可以继续使用相同 API Key 与计费体系。"
          }
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {
          "category": "HARM_CATEGORY_HARASSMENT",
          "probability": "NEGLIGIBLE"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 18,
    "candidatesTokenCount": 58,
    "totalTokenCount": 76
  }
}

Documentation Index

Fetch the complete documentation index at: https://mercury-eab3b728.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Gemini 原生格式

Gemini 原生格式保留 Google Gemini API 的路径和请求体。适合已有 Gemini SDK、contents/parts 结构或安全设置配置的业务接入。

​
认证

Authorization: Bearer YOUR_API_KEY
也支持 Google API Key 风格： 
x-goog-api-key: YOUR_API_KEY
或查询参数： 
/v1beta/models/gemini-2.0-flash:generateContent?key=YOUR_API_KEY

​
路径

MethodPath说明
GET/v1beta/modelsGemini 模型列表
POST/v1beta/models/{model}:generateContent非流式内容生成
POST/v1beta/models/{model}:streamGenerateContent流式内容生成
POST/v1beta/models/{model}:embedContent单条向量
POST/v1beta/models/{model}:batchEmbedContents批量向量

​
请求体

​
contents
array<object>
required
对话内容列表。每个内容项包含 role 和 parts。
​
contents[].parts
array<object>
required
内容片段。支持 text、inlineData、fileData、functionCall、functionResponse 等。
​
systemInstruction
object
系统指令。代码同时兼容 system_instruction 写法。
​
generationConfig
object
生成配置，包含 temperature、topP、topK、maxOutputTokens、stopSequences、responseMimeType、responseSchema、thinkingConfig 等字段。
​
safetySettings
array<object>
安全设置。每项包含 category 和 threshold。
​
tools
array<object> | object
工具声明。支持 functionDeclarations、googleSearch、codeExecution、urlContext 等 Gemini 工具。
​
toolConfig
object
工具调用配置，例如 functionCallingConfig。
​
cachedContent
string
Gemini cached content 标识。

​
请求示例

curl -X POST https://www.geeknow.top/v1beta/models/gemini-2.0-flash:generateContent \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "用三句话介绍 Gemini 原生接口。" }
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 300
    }
  }'

​
多模态输入

curl -X POST https://www.geeknow.top/v1beta/models/gemini-2.0-flash:generateContent \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "识别这张图片里的核心信息。" },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "BASE64_IMAGE_DATA"
            }
          }
        ]
      }
    ]
  }'

​
流式生成

curl -N -X POST https://www.geeknow.top/v1beta/models/gemini-2.0-flash:streamGenerateContent \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "写一个 5 行以内的发布公告。" }
        ]
      }
    ]
  }'

​
响应示例

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Gemini 原生接口使用 contents 和 parts 表达输入内容。它支持文本、图片、文件和函数调用等能力。通过统一网关可以继续使用相同 API Key 与计费体系。"
          }
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {
          "category": "HARM_CATEGORY_HARASSMENT",
          "probability": "NEGLIGIBLE"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 18,
    "candidatesTokenCount": 58,
    "totalTokenCount": 76
  }
}

​
常见安全设置

category说明
HARM_CATEGORY_HARASSMENT骚扰内容
HARM_CATEGORY_HATE_SPEECH仇恨言论
HARM_CATEGORY_SEXUALLY_EXPLICIT色情内容
HARM_CATEGORY_DANGEROUS_CONTENT危险内容
threshold说明
BLOCK_NONE不屏蔽
BLOCK_ONLY_HIGH仅屏蔽高风险
BLOCK_MEDIUM_AND_ABOVE屏蔽中等及以上风险
BLOCK_LOW_AND_ABOVE屏蔽低等及以上风险

​
相关接口