Skip to main content
Rivus AI 支持使用标准 OpenAI 接口调用 Gemini 模型,只需将 model 参数设置为 Gemini 模型名称即可。这种方式便于在不同模型供应商之间快速切换,无需修改代码。

Chat Completions

使用 /v1/chat/completions 接口进行对话:

流式输出

设置 stream: true 启用流式响应:
响应格式与 OpenAI 完全一致,使用标准的 Server-Sent Events (SSE)。

多模态输入

支持文本、图像混合输入:

工具调用

支持 OpenAI 风格的函数调用:
Rivus AI 会自动将 OpenAI 的 tools 格式转换为 Gemini 的 functionDeclarations 格式。

JSON 模式

使用 response_format 强制输出 JSON:

Embeddings

使用 /v1/embeddings 接口生成向量:

图像生成

使用 /v1/images/generations 接口生成图片:

字段映射说明

Rivus AI 会自动完成以下格式转换:

Chat Completions

  • messagescontents(角色映射:user/assistant/system → user/model)
  • toolsfunctionDeclarations
  • response_formatgenerationConfig.responseMimeType
  • temperaturemax_tokens 等参数直接映射

Images

  • promptinstances[0].prompt
  • sizeaspectRatio(1024x1024 → 1:1,1792x1024 → 16:9)
  • nsampleCount

Embeddings

  • inputcontent.parts[0].text
  • 响应格式自动转换为 OpenAI 标准格式

优势

  • 统一接口:使用相同的代码调用不同供应商的模型
  • 快速切换:只需修改 model 参数即可切换模型
  • 生态兼容:兼容所有 OpenAI SDK 和工具
  • 自动转换:Rivus AI 自动处理格式差异,无需手动适配
推荐优先使用 OpenAI 兼容接口,除非需要使用 Gemini 特有的高级功能(如自定义安全阈值、特定的生成配置等)。