Gemini 对话
通过 OpenAI 兼容接口调用当前 Essevin 密钥可用的 Gemini 对话模型。
Essevin 通过 OpenAI Chat Completions 提供已开放的 Gemini 对话模型。SDK 和请求结构与 GPT 相同，只需改用当前密钥实际返回的 Gemini 模型 ID。
| 项目 | 填写值 |
|---|---|
| Base URL | https://api.essevin.com/v1 |
| 端点 | POST /v1/chat/completions |
| 鉴权 | Authorization: Bearer <Gemini 分组密钥> |
| 模型 ID | 从 GET /v1/models 精确复制 |
To C 模型范围更精简
其他 Essevin 产品或公开价格页出现的模型，不代表当前密钥已经开放。配置客户端前，必须先用所选 Gemini 分组密钥查询模型。
先查询可用模型
curl https://api.essevin.com/v1/models \
-H "Authorization: Bearer $ESSEVIN_GEMINI_API_KEY"从返回结果中选择以 gemini- 开头的完整 ID。常见示例包括 gemini-3.5-flash 和 gemini-2.5-flash，最终以当前密钥的响应为准。
发送最小请求
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.essevin.com/v1",
api_key=os.environ["ESSEVIN_GEMINI_API_KEY"],
)
response = client.chat.completions.create(
model="gemini-3.5-flash",
messages=[{"role": "user", "content": "只回复 ok"}],
)
print(response.choices[0].message.content)使用 SSE 流式输出
只有应用确实消费 SSE 时才加入 stream: true。请端到端透传事件流，不要先缓冲成单个响应。
curl https://api.essevin.com/v1/chat/completions \
-H "Authorization: Bearer $ESSEVIN_GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.5-flash",
"stream": true,
"messages": [{"role": "user", "content": "只回复 ok"}]
}'保留 Gemini 原生请求体
已有 Gemini 接入可以继续使用原生 contents 字段。同一个 Chat Completions 端点会识别请求结构，并按 Gemini 格式透传。
curl https://api.essevin.com/v1/chat/completions \
-H "Authorization: Bearer $ESSEVIN_GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.5-flash",
"contents": [{"role": "user", "parts": [{"text": "只回复 ok"}]}]
}'使用 Gemini 图片模型时，请改走图片生成 API，不要发送对话请求。当前 To C 站点没有说明的端点不在其支持范围内。