OpenAI 兼容接口接入教程
核对 Base URL、API Key 和模型 ID，再完成一次请求。
阅读文章正在打开页面…
正在加载内容，请稍候。
Gemini API：型号选择、图片输入与接入
Gemini API 可按目录选择 OpenAI 兼容或原生接口。先跑通文字请求，再逐项验证图片、文件和工具支持；Pro Preview 的回归与 Flash-Lite 的字段验收分别准备。
全球顶尖大模型 · 一站式接入
比较型号与参考价格先选适合任务的型号
Flash、Pro Preview 与 Flash-Lite 的思考参数和版本状态不同。官方多模态能力还需要当前通道支持相应的素材格式。
Gemini 3.8 Flash
gemini-3.8-flash检查异步业务逻辑
Gemini 3.8 Flash API 可以按本页 OpenAI SDK 或 Gemini 原生示例检查订单幂等与验收计划。先验证文字结果，再核对图片、文件和工具透传；此文字型号不生成图片。
当前最低参考价
- 输入
- $0.110295
- 输出
- $0.551475
美元 / 百万 Tokens
Gemini 3.1 Pro Preview
gemini-3.1-pro-preview分析复杂代码的失败路径
Gemini 3.1 Pro Preview API 以库存预留或任务队列方案为输入，明确并发、补偿与验收条件后提交分析。预览型号上线前保留回归样本，变化时重跑并准备替代方案。
当前最低参考价
- 输入
- $0.70588
- 输出
- $4.23528
美元 / 百万 Tokens
Gemini 3.1 Flash-Lite
gemini-3.1-flash-lite翻译商品与客服短文本
Gemini 3.1 Flash-Lite API 从三条短消息翻译或订单字段提取开始，让缺失信息留空。检查数字、遗漏和错误补全后再增加并发，minimal 档也不能保证完全没有思考。
当前最低参考价
- 输入
- $0.036765
- 输出
- $0.22059
美元 / 百万 Tokens
价格读取自公开模型目录，使用 5 分钟缓存。页面读取于 2026-11-06 15:45:34 UTC。最低参考价不代表当前令牌已获得相应权限；实际扣费以请求时价格和控制台记录为准。
选定型号后，按这条路径接入
本站绘制的内容说明图：本家族列出的准确 ID 与任务入口；按共同任务验收，不把排序当作性能排名。
本站绘制的内容说明图：区分 SDK Base URL 与完整请求路径；只展示本页实际配置，不推定客户端和所有工具功能已经可用。
选对协议，再接入
以下示例使用 Gemini 3.8 Flash。其他型号的专属参数与示例，请进入相应详情。
- OpenAI 兼容 Chat Completions
https://api.apizt.com/v1OpenAI SDK 将 /v1 作为 Base URL，再调用 chat.completions。完整 HTTP 请求路径为 /v1/chat/completions；模型 ID、工具与思考参数按所选型号核对。
- Gemini 原生格式
POST /v1beta/models/{model}:generateContent使用 contents / parts 提交内容，读取 candidates 和 usageMetadata。原生与 Chat 的参数不同；Google 文件引用、内置搜索和工具能力按当前通道分别验证。
用 Python OpenAI SDK 检查订单幂等问题
安装 openai 后运行。先使用文本与最小参数集，避免直接照搬 Google 原生 thinkingConfig 到 Chat 请求。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["tokenba_API_KEY"],
base_url="https://api.apizt.com/v1",
)
result = client.chat.completions.create(
model="gemini-3.8-flash",
max_tokens=4096,
messages=[{"role": "user", "content": "审查订单回调流程：收到 event_id 后先读取 processed 表；若不存在则扣库存并创建订单，最后插入 processed。两个相同回调可能同时到达。指出会重复执行的时间窗口，给出基于数据库唯一约束与事务的修复伪代码，以及三个并发验收用例。不要假设消息队列只投递一次。"}],
)
print(result.choices[0].message.content)
print(result.usage)用 Gemini 原生格式生成多步骤验收计划
此网关地址来自 apizt 目录。使用 contents / parts 格式提交文字任务；先验收响应中的 candidates 与 usageMetadata，再增加素材或思考配置。
curl --fail-with-body --max-time 120 \
https://api.apizt.com/v1beta/models/gemini-3.8-flash:generateContent \
-H "Authorization: Bearer $tokenba_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"role": "user", "parts": [{"text": "为工单自动处理助手设计验收计划。它可以检索帮助文档、查询订单，只能起草回复，不能自动退款。请列出工具权限、每一步成功判定、无结果与超时处理，以及五条测试工单的预期处理路径。"}]}],
"generationConfig": {"maxOutputTokens": 8192}
}'用途与使用边界
从这些任务开始验证
检查异步业务逻辑
把订单处理或任务队列代码与业务约束一起提交，要求模型定位并发、重复执行等边界问题，再用自己的测试证明修改是否有效。
理解图片、视频和文档
官方支持多类输入，可用来提取画面信息或分析文档。在网关内先验收一种素材格式，并要求回答附上页码、时间段或画面依据。
搭建多步骤工作流
将资料查询、数据整理与结果解释拆成可记录的步骤。工具由应用实际执行，给模型回传结果后继续处理，保留每一步的错误与费用。
Gemini 3.8 Flash 使用须知
不能使用 minimal 思考档
Google 对 Gemini 3.8 Flash 明确列出 low、medium、high；minimal 会报错。OpenAI 兼容层的 reasoning_effort 与原生 thinkingConfig 使用不同格式，应先核对通道映射，不同时混用。
模型能理解素材，网关也要支持传入
文字、图片、视频、音频和 PDF 是官方输入能力。Google File API 文件引用、URL 读取或素材上传方式未必可直接跨到 apizt；先用当前协议支持的形式做小样本验证。此型号输出文字，不提供图像或音频生成。
内置工具与应用工具分开验证
Google 搜索、代码执行等原生能力不能只凭型号名称认定在所有通道开放。先验证普通文字，再分别验收函数调用、流式与所需内置工具；长任务记录所有回合和控制台实扣。
官方型号资料核对于 2026-10-06；网关通道的参数、长度与工具支持另行验证。
常见问题
Gemini API 的 Flash、Pro Preview 和 Flash-Lite 怎么选？
Gemini 3.8 Flash 可用于代码检查和资料分析；3.1 Pro Preview 可用于需要多步分析的方案评审，但应准备预览版本的回归测试与替代型号；3.1 Flash-Lite 可从翻译、分类和字段提取等重复任务开始。
Gemini API 可以直接复用 Google File API 的文件引用吗？
不能只凭官方模型能力推定网关支持。文件引用、URL 读取、上传格式与内置工具需按所选协议和通道单独验证，先用小样本确认有效输出。
这三个 Gemini 型号怎么选？
Gemini 3.8 Flash 可用于代码检查和资料分析；3.1 Pro Preview 可用于需要多步分析的方案评审，但应准备预览版本的回归测试与替代型号；3.1 Flash-Lite 可从翻译、分类和字段提取等重复任务开始。
能直接使用 Google File API 的文件引用吗？
不能只凭官方模型能力推定网关支持。文件引用、URL 读取、上传格式与内置工具需按所选协议和通道单独验证，先用小样本确认有效输出。
Gemini 文字型号会生成图片吗？
本页列出的三个型号输出文字。需要生成或编辑图片时，应在模型目录选择独立的图像型号，并核对图像接口和计费方式。
这里的最低参考价就是我的实际费用吗？
页面读取公开模型目录，展示当前可读的最低基础参考价，使用 5 分钟缓存。实际令牌的可用型号、计费档位、缓存、阶梯与重试费用以请求时的价格和控制台消费记录为准。
