model 参数设置为 Gemini 模型名称即可。这种方式便于在不同模型供应商之间快速切换,无需修改代码。
Chat Completions
使用/v1/chat/completions 接口进行对话:
流式输出
设置stream: true 启用流式响应:
多模态输入
支持文本、图像混合输入:工具调用
支持 OpenAI 风格的函数调用:tools 格式转换为 Gemini 的 functionDeclarations 格式。
JSON 模式
使用response_format 强制输出 JSON:
Embeddings
使用/v1/embeddings 接口生成向量:
图像生成
使用/v1/images/generations 接口生成图片:
字段映射说明
Rivus AI 会自动完成以下格式转换:Chat Completions
messages→contents(角色映射:user/assistant/system → user/model)tools→functionDeclarationsresponse_format→generationConfig.responseMimeTypetemperature、max_tokens等参数直接映射
Images
prompt→instances[0].promptsize→aspectRatio(1024x1024 → 1:1,1792x1024 → 16:9)n→sampleCount
Embeddings
input→content.parts[0].text- 响应格式自动转换为 OpenAI 标准格式
优势
- 统一接口:使用相同的代码调用不同供应商的模型
- 快速切换:只需修改
model参数即可切换模型 - 生态兼容:兼容所有 OpenAI SDK 和工具
- 自动转换:Rivus AI 自动处理格式差异,无需手动适配
推荐优先使用 OpenAI 兼容接口,除非需要使用 Gemini 特有的高级功能(如自定义安全阈值、特定的生成配置等)。
