curl -X POST https://www.geeknow.top/v1beta/models/gemini-3.5-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
  }
}

{
  "error": {
    "message": "field contents is required",
    "type": "invalid_request_error",
    "param": "",
    "code": "invalid_request"
  }
}

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "param": "",
    "code": "invalid_api_key"
  }
}

{
  "error": {
    "message": "用户额度不足",
    "type": "new_api_error",
    "param": "",
    "code": "insufficient_user_quota"
  }
}

{
  "error": {
    "message": "当前请求频率过高，请稍后再试",
    "type": "new_api_error",
    "param": "",
    "code": "too_many_requests"
  }
}

{
  "error": {
    "message": "bad response body",
    "type": "new_api_error",
    "param": "",
    "code": "bad_response_body"
  }
}

POST

https://www.geeknow.top

v1beta

models

{model}

{action}

curl -X POST https://www.geeknow.top/v1beta/models/gemini-3.5-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
  }
}

{
  "error": {
    "message": "field contents is required",
    "type": "invalid_request_error",
    "param": "",
    "code": "invalid_request"
  }
}

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "param": "",
    "code": "invalid_api_key"
  }
}

{
  "error": {
    "message": "用户额度不足",
    "type": "new_api_error",
    "param": "",
    "code": "insufficient_user_quota"
  }
}

{
  "error": {
    "message": "当前请求频率过高，请稍后再试",
    "type": "new_api_error",
    "param": "",
    "code": "too_many_requests"
  }
}

{
  "error": {
    "message": "bad response body",
    "type": "new_api_error",
    "param": "",
    "code": "bad_response_body"
  }
}

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-3.5-flash:generateContent?key=YOUR_API_KEY

路径

Method	Path	说明
`GET`	`/v1beta/models`	Gemini 模型列表
`POST`	`/v1beta/models/{model}:generateContent`	非流式内容生成
`POST`	`/v1beta/models/{model}:streamGenerateContent`	流式内容生成

请求体

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-3.5-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
    }
  }'

多模态输入

Gemini 原生格式推荐用 inlineData 传 base64。URL 图片可使用 fileData.fileUri，但是否可用取决于模型和通道能否下载该 URL。

curl -X POST https://www.geeknow.top/v1beta/models/gemini-3.5-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"
            }
          }
        ]
      }
    ]
  }'

URL 图片写法：

{
  "fileData": {
    "mimeType": "image/png",
    "fileUri": "https://YOUR_IMAGE_HOST/path/image.png"
  }
}

流式生成

curl -N -X POST https://www.geeknow.top/v1beta/models/gemini-3.5-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
  }
}

{
  "error": {
    "message": "field contents is required",
    "type": "invalid_request_error",
    "param": "",
    "code": "invalid_request"
  }
}

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "param": "",
    "code": "invalid_api_key"
  }
}

{
  "error": {
    "message": "用户额度不足",
    "type": "new_api_error",
    "param": "",
    "code": "insufficient_user_quota"
  }
}

{
  "error": {
    "message": "当前请求频率过高，请稍后再试",
    "type": "new_api_error",
    "param": "",
    "code": "too_many_requests"
  }
}

{
  "error": {
    "message": "bad response body",
    "type": "new_api_error",
    "param": "",
    "code": "bad_response_body"
  }
}

常见安全设置

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`	屏蔽低等及以上风险

概览

文本系列

图像系列

视频系列

上传管理

任务管理

账户管理

Gemini 原生格式

Gemini 原生格式

认证

路径

请求体

请求示例

多模态输入

流式生成

响应示例

常见安全设置

相关接口

​Gemini 原生格式

​认证

​路径

​请求体

​请求示例

​多模态输入

​流式生成

​响应示例

​常见安全设置

​相关接口

Gemini 原生格式

认证

路径

请求体

请求示例

多模态输入

流式生成

响应示例

常见安全设置

相关接口