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。