Gemini API 接入 — 谷歌 Gemini 3 Pro 与 Flash 一个 Key 搞定

谷歌 Gemini API 给你的是当下最强的多模态家族之一——文本与视觉都在行，为超长上下文而生，价格也有竞争力。在 ApiTopMix 上，Gemini API 接入只需一个 OpenAI 兼容 Key：调用 gemini-3-pro-preview（最新 Pro 旗舰）、gemini-3.1-pro-preview 与 gemini-2.5-pro，外加又快又便宜的 Flash 档——gemini-3-flash-preview、gemini-2.5-flash 与 gemini-3.1-flash-lite-preview——全都在 base URL https://apitopmix.com/v1 上。

下面所有示例都只用一个 sk- 开头的 Key。因为 ApiTopMix 是 OpenAI 兼容的，你现有的代码几乎零改动——改一下 base_url 和 model 字符串就行，其它照旧。计费为随用随付且低于谷歌官方标价，所以走便宜 Gemini API这条路是常态而非促销，Flash 档在大批量流量下尤其便宜。不用建 Google Cloud 项目，也不用单独开 Google AI Studio 账号：ApiTopMix 提供这套网关。

谷歌 Gemini 擅长什么

Gemini 是谷歌的旗舰模型家族，它的位置靠三项能与真实业务对得上号的强项撑起来。如果你的应用涉及图像、超大输入或高请求量，Gemini API 就很合适：

• 多模态（文本 + 视觉）——Gemini 把图像与文本一起处理得很好，所以 Gemini 多模态 API 很适合文档理解、截图、图表、商品图，以及图文混合的提示。
• 超长上下文——Gemini 为大上下文窗口而设计，这让 Gemini 长上下文 API 非常适合在一次请求里处理整份文档、长文字记录、大代码库与多文件分析。
• 价格有竞争力、大批量便宜——Gemini 定价有竞争力，Flash 档非常便宜，所以对话、分类、抽取、简单 Agent 这类大批量流量的成本只是顶级模型的一小部分。
• 通用推理也强——Pro 档在复杂推理、编码辅助和结构化输出上都拿得出手，所以你不用为了多模态与长上下文而牺牲能力。

实用套路是：把难的、高价值的步骤发给 Pro 模型，其它都交给 Flash——下一节展开这套分工。因为两档共用一个 Key 和一个 base URL，路由只是改一下 model 字符串。

Gemini Pro vs Flash——两档

谷歌把 Gemini 分成两档，ApiTopMix 把两档都放在同一个 sk- Key 和同一个 base URL 后面。你按请求里发哪个模型 ID 来选。

一句话：Pro 是应对难、高价值调用的能力档，Flash 是流量大时压低成本的走量档。很多团队默认用 Flash，只把最难的步骤升级到 gemini-3-pro-preview 这样的 Pro 模型。因为都是一个 Key，你可以按任务路由，甚至靠改 model 字符串来做 A/B 对比。

谷歌 Gemini 型号一览

ApiTopMix 保留了完整的 Gemini 线，你既可以跑最新 Pro 旗舰，也可以钉住某个具体版本，或降到 Flash 做便宜的大批量。下面是完整的谷歌 Gemini型号与准确的模型 ID：

表里刻意不写具体价格：单价会变，ApiTopMix 定价页始终是权威来源。稳定不变的是这条线的结构——gemini-3-pro-preview 是当前 Pro 旗舰，gemini-2.5-pro 保留供钉版，而 Flash 档（一直到 gemini-3.1-flash-lite-preview）正是 Gemini 价格在大批量下变得非常便宜的地方。

如何调用 Gemini API

ApiTopMix 提供 OpenAI 兼容端点，所以调用 Gemini API 就是你已经熟悉的那个请求——只是换成 ApiTopMix 的 base URL 和一个 Gemini 模型 ID。这一节就是最短的 Gemini API 上手。

一个端点，一个 Key

先拿 Key：

1. 注册账号：apitopmix.com/register。
2. 进入控制台，打开 Tokens，点击新建令牌。
3. 复制 Key——以 sk- 开头。这一个 Key 驱动全部 Gemini 模型，还能调平台上其它模型。

用 curl 调用（OpenAI 兼容）

验证 Gemini API key 是否可用最快的方式——向 Pro 旗舰发一条请求：

curl https://apitopmix.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的ApiTopMix密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-preview",
    "messages": [{"role": "user", "content": "你好，来自谷歌 Gemini 3 Pro"}]
  }'

把 "gemini-3-pro-preview" 换成 "gemini-3.1-pro-preview" 或 "gemini-2.5-pro" 钉住另一个 Pro 版本，或换成 "gemini-3-flash-preview" / "gemini-2.5-flash" / "gemini-3.1-flash-lite-preview" 跑便宜的 Flash 档——其它完全不变。

用 Python 调用（openai SDK）

因为端点是 OpenAI 兼容的，直接用官方 openai Python SDK 即可——把 base_url 指向 ApiTopMix，模型名填一个 Gemini ID。这就是 Gemini OpenAI 兼容 API 的全部诀窍：

from openai import OpenAI

client = OpenAI(
    base_url="https://apitopmix.com/v1",
    api_key="sk-你的ApiTopMix密钥",
)

resp = client.chat.completions.create(
    model="gemini-3-pro-preview",   # 或 gemini-2.5-pro / gemini-3-flash-preview
    messages=[{"role": "user", "content": "把这份长文档总结成五条要点"}],
)

print(resp.choices[0].message.content)

任何遵循 OpenAI 协议的框架——LangChain、LlamaIndex、你自己的封装——都同理：base URL 用 https://apitopmix.com/v1、填你的 sk- Key、model 用一个 Gemini 模型 ID。要传图像，用标准的 OpenAI 多模态消息格式（一个 image_url 内容片段），Gemini 的视觉能力会处理其余部分。

从 Google AI Studio 或 Vertex AI 迁移过来

如果你现在通过 Google AI Studio 或 Vertex AI 用 Gemini，迁到 ApiTopMix 只需改两行——而且彻底省掉 Google Cloud 的那套配置。代码、SDK、请求结构都不动；改的只是请求去哪、用哪个 Key：

• base_url → https://apitopmix.com/v1（OpenAI 兼容端点）。
• api_key → 你的 ApiTopMix sk- Key（不用 Google Cloud 服务账号，也不用 Vertex 凭证）。
• model → gemini-3-pro-preview（或任意 Pro / Flash ID）。

就这些——请求/响应处理、流式、工具调用逻辑都不用重写，因为 OpenAI 兼容接口本身就和你在用的一致。这也意味着你可以直接完成 Gemini API 购买，并在没有 Google Cloud 的情况下用 Gemini API：一个 ApiTopMix 账号和 Key 就够——不用建项目、不用计费账号、不用配 Vertex。ApiTopMix 提供这套网关，你保留原有代码。如果你原来在同时维护好几家的 SDK，注意同一个 Key 也能调 GPT 和 Claude，可以把它们收敛到同一套接口上。

Gemini vs GPT vs Claude——怎么选

Gemini vs GPT（以及 Claude）的问题，落到每个家族各自最擅长什么，而在 ApiTopMix 上你不必只选一个——三家都在同一个 Key 和同一个 OpenAI 兼容 base URL 后面：

• Gemini——强多模态理解、超长上下文、有竞争力的价格，其中 Flash 在大批量下尤其便宜。当你的负载图像多、上下文长，或在规模上对成本敏感时，是很好的默认。
• GPT——很强的全能之选，生态庞大。ApiTopMix 上的 OpenAI 线见 GPT-5 API 与 GPT-5.6 API 页。
• Claude——在编码和长文推理上很受欢迎。见 便宜的 Claude API 与 Claude Sonnet API 页，以及做 Agent 式编码的 Claude Code 接入指南。

因为你可以把每个任务路由给最合适的模型，只改 model 字符串就能对比，所以用你自己的提示词做 Gemini vs GPT 基准测试只要几分钟，不用开三个账号。定价页把三家的单价并排列出。

为什么用 ApiTopMix 接 Gemini API

ApiTopMix 是一个统一的 AI API 网关。对谷歌 Gemini 来说，这落成几个实在的好处：

常见问题

延伸阅读

• GPT-5 API——ApiTopMix 上的 OpenAI 旗舰；对比 Gemini vs GPT，按任务路由。
• GPT-5.6 API——较新的 GPT 版本，同一个 Key 和 base URL。
• 便宜的 Claude API——用同一个 Key 进入 Claude 家族最省钱的路。
• Claude Sonnet API——均衡的 Claude 档，适合高并发生产。
• 在 Claude Code 里使用——把 ApiTopMix 接进 Claude Code 做 Agent 式编码。
• ApiTopMix 定价——整条 Gemini 线及其它模型的各档实时单价。
• ApiTopMix API 文档——端点、请求头和完整示例。

结语

谷歌 Gemini API 是当你的负载偏多模态、长上下文，或在规模上对成本敏感时会上的家族。在 ApiTopMix 上，整条线都在一个 sk- Key 和一个 OpenAI 兼容 base URL——https://apitopmix.com/v1——后面：主打能力的最新 gemini-3-pro-preview 及其余 Pro 档，以及主打大批量的极便宜 Flash 档——gemini-3-flash-preview、gemini-2.5-flash、gemini-3.1-flash-lite-preview——而且无需 Google Cloud 项目。

配一次——一条 curl 或一次 base URL 切换——之后按任务改一个字符串来挑模型。拿一个 Key，先跑上面的 curl 验证，扩量之前到定价页确认各模型当前单价即可。