模型广场
Gemini 文本

Gemini 3.1 Pro API

通过 Gemini 原生 接入,支持推理模式、文本输入。

  • 推理模式
  • 图片输入
  • 视频输入
gemini-3.1-pro

接入方式

基础域名 https://api.icodeeasy.cc

  • Gemini 原生POST/v1beta/models/{model}:generateContent
  • Gemini 原生流式POST/v1beta/models/{model}:streamGenerateContent

API 示例

POST/v1beta/models/gemini-3.1-pro:generateContent
curl -X POST "https://api.icodeeasy.cc/v1beta/models/gemini-3.1-pro:generateContent" \
  -H "x-goog-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'JSON'
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "用一句话解释什么是向量数据库。"
        }
      ]
    }
  ]
}
JSON

先在本地设置 ICODEEASY_API_KEY。示例中的参考素材链接或任务 ID 请替换为你自己的值。

人民币计费

正在读取人民币价格…

核心功能

文本输入

把问题、原始材料或对话上下文一起交给模型,按指定目标处理。

支持
图片输入

可提交截图、图表或照片,让模型回答关于图中内容的问题。

使用本站 gemini-3.1-pro 请求名,转发至 Gemini 3.1 Pro Preview。图片使用 Gemini 原生输入

支持
视频输入

提交视频和分析目标,让模型根据画面变化整理动作、步骤和关键信息。

使用 Gemini 原生视频输入格式

支持
工具调用

让模型从应用提供的工具中选择调用并生成参数,客户端执行后再把结果交回模型。

使用 Gemini 原生 functionDeclarations 与 functionResponse

支持
结构化输出

指定结果的字段或类型,方便应用解析、检查和写入业务流程。

使用 Gemini 原生 JSON Schema 输出格式

支持
推理模式

支持多步推理,适合需要逐步分析约束、检查反例或验证结论的请求。

支持
流式输出

边生成边返回内容,客户端可以逐段显示回复。

通过 streamGenerateContent 返回流式响应

支持

模型亮点

需要准确选用工具的多步任务

面向需要在多步之间准确使用工具的工作。可声明 Gemini 原生函数,让应用执行后回传结果供模型接着推理。

规格与限制

官方 API 单次输入上限
1,048,576 Token
核对来源 · 2026-11-15

使用场景

  • 知识库问答

    附上与问题相关的文档片段,按来源归纳答案,并标出原文里找不到的细节。

  • 会议行动项

    把会议记录整理为待办、负责人、期限和待决策事项,供团队核对。

  • 解读截图或图表

    提供截图和关注的问题,提取可见数值或界面状态,整理为可核对的记录。

  • 整理视频操作步骤

    提交演示录像,按出现顺序归纳操作、页面切换和需要复核的异常画面。

  • 业务单据字段提取

    给出字段定义和文本材料,整理出可校验的数据,再由应用核对缺失字段。

  • 调用业务查询工具

    在应用中注册库存或工单查询工具,由模型构造参数,应用检查后执行并返回结果。

相关文章

常见问题

Gemini CLI 的 Base URL 要加 /v1beta 吗?

Gemini CLI 的 GOOGLE_GEMINI_BASE_URL 填站点域名,例如 https://api.icodeeasy.cc。直接调用原生 API 时,才使用接入方式里带 /v1beta 的完整请求路径。

查看接入方式
Google 文档末尾有 Preview,本站该填哪个?

先复制本页显示的模型 ID。本站接受 gemini-3.1-pro,并转到 Gemini 3.1 Pro Preview。不要把 Google 示例里的完整域名照搬到本站客户端。

查看接入方式
第一条请求就报 401,从哪里查?

先确认客户端使用的是本站 API Key,并检查 Base URL 是否被插件里的旧配置覆盖。更新后重新打开客户端或终端,让新配置生效。

查看接入方式
接口提示模型不存在,应该改哪里?

从页首复制本站模型 ID,填入客户端的模型配置或请求字段。再检查请求是否发到了本站,并核对下方示例使用的协议和路由。

查看接入方式
想让模型看截图,怎样发才对?

使用本站 gemini-3.1-pro 请求名,转发至 Gemini 3.1 Pro Preview。图片使用 Gemini 原生输入。先用一张小图和一个具体问题跑通,再发完整材料。

查看核心功能和规格
分析一段视频时,提示词怎么写?

先截取和问题直接相关的一小段,再说明要找的动作、时间顺序或变化。使用支持视频输入的协议字段,并在发送前核对客户端是否上传了视频。

查看核心功能和规格
让模型输出 JSON,只在提示词里写一句够吗?

使用 Gemini 原生 JSON Schema 输出格式。收到完整回复后先解析和校验字段,再写入业务系统。

查看核心功能和规格
模型返回工具调用,为什么工具没有执行?

使用 Gemini 原生 functionDeclarations 与 functionResponse。收到工具调用后,由客户端检查参数、执行工具,再把结果回传给模型。首次试用时可以先注册一个只读查询工具。

查看核心功能和规格
回复为什么一次性出来,怎么打开流式?

直接调 Gemini 原生 API 时使用 streamGenerateContent。客户端还需要逐段读取响应,避免被 SDK 或代理缓冲成整段。

查看接入方式
为什么同一句问题,两次费用不一样?

查看输入和输出的实际 Token。历史消息越多,输入通常越长。计费区有缓存或分时费率时,也要和对应的用量类别一起看。

查看本站计费