Run7 AI联系获取 Key ↗
RUN7 / 知识与工具

Gemini API 接入指南:原生与 OpenAI 兼容方式

作者:Run7 AI · 更新:2026-11-17

Gemini 可通过原生或兼容格式接入。先按服务实际支持的协议完成短文本测试,再分别验证流式和图片等能力,不能用一次文本成功推断所有多模态功能。

按接口实际能力选择协议

OpenAI 兼容是一种请求格式,不代表完整覆盖原生功能。Gemini CLI 与通用聊天客户端的协议要求可能不同,应使用交付地址及对应说明,不要直接复制其他账户的原生接口配置。

先完成短文本,再开流式

在兼容客户端填写 Base URL、Key 与完整模型 ID,先关闭工具、图片和可选生成参数。最小请求成功后核对响应,再开启流式。接入指南提供可在本地使用的 curl 模板。

多模态能力单独测试

文字请求无法证明 PDF、音频、视频或图片可用。文件大小、内容格式和上传方式都与具体接口有关。先用一张公开的小图片验证,再处理较大文档。未确认数据处理条款前,不应上传未公开科研资料或个人敏感信息。

用自己的任务比较模型

基础检测工具验证文本连通性,不评估多模态质量或模型身份。

继续阅读

全部知识文章 · API 基础检测

资料来源与适用范围

依据公开协议资料整理;具体模型、费率和功能以交付信息为准。本文不是对所有客户端版本的兼容保证。