HopBase 文檔Gemini 對話
通過 OpenAI 兼容協議和 Interactions API 調用 Gemini 模型。
Gemini 全系對話模型走 OpenAI Chat Completions 兼容協議：POST https://api.hop-base.com/v1/chat/completions，Authorization: Bearer sk-你的密鑰。現有 OpenAI SDK / 第三方客戶端只需把模型 ID 換成 Gemini，代碼不用改。
可用模型
| 系列 | 模型 ID | 定位 |
|---|---|---|
| Gemini Omni | gemini-omni-flash-preview | 文字 / 圖片 / 視頻輸入 · 視頻輸出 |
| Gemini 3.6 | gemini-3.6-flash | 最新 Flash · 新上線觀察中 |
| Gemini 3.5 | gemini-3.5-flash / gemini-3.5-flash-lite | 默認推薦 / 低成本 |
| Gemini 3.1 Pro | gemini-3.1-pro-preview / gemini-3.1-pro-preview-customtools | 高階推理預覽 / 工具調用預覽 |
| Gemini 3.1 | gemini-3.1-flash-lite / gemini-3.1-flash-lite-preview | 輕量版 / 輕量預覽 |
| Gemini 3 | gemini-3-flash-preview | 3 代 Flash 預覽 |
| Gemini 2.5 | gemini-2.5-pro / gemini-2.5-flash / gemini-2.5-flash-lite | 穩定版 |
推薦順序：日常默認使用 gemini-3.5-flash；需要成熟備選可選 Gemini 2.5 正式版；gemini-3.6-flash 為新上線型號，仍在持續觀察。所有 ID 含 preview 的型號均按預覽版使用，不作穩定性承諾。
不同套餐分組的價格不同,以當前密鑰所屬分組及登入後的「模型廣場」為準。
curl 示例
curl https://api.hop-base.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密鑰" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.5-flash",
"messages": [{"role": "user", "content": "你好"}]
}'流式輸出（SSE，加 "stream": true）
curl https://api.hop-base.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密鑰" \
-H "Content-Type: application/json" \
-d '{"model": "gemini-3.1-pro-preview", "stream": true,
"messages": [{"role": "user", "content": "你好"}]}'Gemini 原生格式透傳
從 Gemini SDK 遷移的存量請求體不用改：同一端點也接受 Gemini 原生 contents 字段，服務端自動識別並按原生格式轉發。
curl https://api.hop-base.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密鑰" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.5-flash",
"contents": [{"role": "user", "parts": [{"text": "你好"}]}]
}'Gemini Omni 視頻生成（原生 Interactions）
gemini-omni-flash-preview 支持文字、圖片與視頻輸入，也能直接輸出視頻。文字生成視頻只需傳 model 和 input；請使用 POST https://api.hop-base.com/v1beta/interactions 取得完整原生視頻資料。Chat Completions 兼容入口仍可用於文字對話，但不應用來接收完整視頻響應；原 POST /v1/interactions 保留為兼容別名。
curl https://api.hop-base.com/v1beta/interactions \
-H "Authorization: Bearer sk-你的密鑰" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-omni-flash-preview",
"input": "生成一段 3 秒視頻：紅球在白色背景上緩慢滾動"
}'視頻位於 steps[].content[]，data 是 base64 編碼的 MP4。usage.output_tokens_by_modality 把輸出 token 按模態拆開供參考，其中的數字已經包含在 total_output_tokens 裡，計費用的是後者。完整契約與價格見 Gemini Omni 視頻：
{
"status": "completed",
"model": "gemini-omni-flash-preview",
"steps": [{
"type": "model_output",
"content": [{
"type": "video",
"mime_type": "video/mp4",
"data": "<base64-mp4>"
}]
}],
"usage": {
"total_input_tokens": 20,
"total_output_tokens": 17819,
"output_tokens_by_modality": [{"modality": "video", "tokens": 17376}]
}
}視頻輸入最長 10 秒，可用於視頻編輯；輸出時長為 3–10 秒，固定 720p、24 FPS。需要指定時長時直接在 input 提示詞中寫明。模型上下文為 1,048,576 tokens，預覽版能力與可用性可能調整。
✅ 不同套餐分組可用的 Gemini 型號可能不同。請先用當前密鑰調用 GET /v1/models，只使用實際返回的完整 ID。