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 | 稳定版 |
Google 官方基准价中，gemini-3.1-pro-preview 每 100 万 tokens 输入 $2 / 输出 $12。HopBase 的实际价格依当前密钥所属分组计算，请以登录后「模型广场」为准。
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 API）
gemini-omni-flash-preview 支持文字、图片与视频输入，并可直接输出视频。文字生视频只需传 model 和 input；视频编辑可在输入内容中传远程 uri，或传 base64 data 并指定 mime_type。完整视频输出必须使用 POST https://api.hop-base.com/v1/interactions，不要按 Chat Completions 的文字格式响应解析。
curl https://api.hop-base.com/v1/interactions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-omni-flash-preview",
"input": "生成一段 3 秒视频：彩色小球在白色背景上慢慢滚动"
}'成功响应（视频位于 steps[].content[]）
{
"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}]
}
}Omni 限制：输入视频最长 10 秒，可用于视频编辑；输出视频为 3–10 秒、720p、24 FPS。输出是 base64 MP4，请解码 steps[].content[].data 后保存。
✅ 请使用 Gemini 分组密钥，并只调用当前密钥 GET /v1/models 返回的模型 ID。