Skip to main content
Rivus AI 为 Gemini 生态提供完整的接口支持：
  • 双重接口风格：既支持 Gemini 官方原生接口，也提供 OpenAI 兼容路径，便于统一管理与快速切换。
  • 统一认证：使用 Rivus AI 控制台签发的 Token 即可访问，支持细粒度的密钥权限与监控。
  • 多模态能力：支持文本、图像、音频、视频等多种输入输出，覆盖对话、生图、视频生成等场景。
官方路径使用 x-goog-api-key: <Rivus AI Token> 认证；OpenAI 兼容路径使用 Authorization: Bearer <Rivus AI Token>。
export BASE_URL="https://models.rivus.cn"
export TOKEN="oh-xxxxxxxxxxxxxxxx"
配置好环境变量后，可直接用 cURL 调试： 
# 官方路径示例
curl "$BASE_URL/gemini/v1beta/models/gemini-1.5-pro:generateContent" \
  -H "x-goog-api-key: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"你好"}]}]}'

# OpenAI 兼容路径示例
curl "$BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-1.5-pro","messages":[{"role":"user","content":"你好"}]}'

​
快速入口

内容生成

使用 GenerateContent 接口进行对话与多模态交互。

向量嵌入

text-embedding 系列模型生成语义向量。

图像生成

Imagen 系列模型的文生图能力。

视频（OpenAI 风格）

使用统一的 OpenAI 接口 /v1/videos 创建与查询视频任务。

视频（Gemini 风格）

使用 /gemini//models/:predictLongRunning 提交任务。

OpenAI 兼容

使用 OpenAI 风格接口调用 Gemini 模型。

故障排查

常见问题与解决方案。

查询视频

GET /v1/videos/，查看状态与元数据。

下载视频

GET /v1/videos//content，下载成片。

查询（Gemini 风格）

GET /gemini//operations/，轮询长任务。

​
接口风格说明

​
官方原生路径

  • 路径格式：/gemini/{version}/models/{model}:<action>
  • 版本默认 v1beta，可在路径中显式指定（如 v1）
  • 支持的 action：generateContent、streamGenerateContent、predict、predictLongRunning、embedContent
  • 长任务查询：/gemini/{version}/operations/{operation_id}

​
OpenAI 兼容路径

  • 使用标准 OpenAI 接口路径（如 /v1/chat/completions）
  • 只需将 model 参数设置为 Gemini 模型名称
  • Rivus AI 会自动完成请求格式转换与响应映射
推荐优先使用 OpenAI 兼容路径，便于在不同模型供应商之间无缝切换。官方原生路径适用于需要使用 Gemini 特有功能的场景。
官方原生路径仅支持品牌归属为 Gemini 的模型。如需调用其他供应商的模型，请使用 OpenAI 兼容路径。