Skip to content

Gemini兼容接口

协议选择

CloseAI平台的Gemini模型支持原生的Gemini SDK协议,也支持OpenAI SDK的兼容协议,模型名相同,但是调用方式不一样,推荐无特殊需求优先使用原生协议,更加稳定,功能更加丰富,OpenAI兼容格式仅建议使用在比如Cursor等只支持自定义OpenAI接口时使用。

TIP

OpenAI协议兼容Gemini官方提供,属于官方的Beta功能,不排除未来官方废弃这种用法的可能,CloseAI不保证这种用法的稳定性,建议尽量使用原生Gemini协议,Dify、Chatbox等大部分开源软件均支持原生协议。

协议类型域名备注
Gemini协议https://api.openai-proxy.org/google添加/google后缀
OpenAI协议https://api.openai-proxy.org/v1一般需要加/v1

聊天模型相关接口

TIP

仅支持Gemini 1.5系列聊天接口,不支持file上传、缓存等忌口,不支持其他非聊天模型

请求样例

TIP

必须明确指定rest协议调用,不支持默认的grpc调用

python
import google.generativeai as genai

if __name__ == '__main__':
    # 注意gemini的sdk必须制定rest协议调用,否则会默认走grpc造成报错
    genai.configure(
        api_key='sk-xxxx',
        transport="rest",
        client_options={"api_endpoint": "https://api.openai-proxy.org/google"},
    )
    model = genai.GenerativeModel('gemini-1.5-flash')
    response = model.generate_content("Say Hello")
    print(response.text)

兼容协议调用

OpenAI兼容协议(不推荐)

shell
curl https://api.openai-proxy.org/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxxx" \
-d '{
"model": "gemini-1.5-flash",
"messages": [{"role": "user", "content": "Hello!"}]
}'