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 站點沒有說明的端點不在其支持範圍內。