> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rivus.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini · 概览

> 了解如何通过 Rivus AI 使用 Gemini 系列模型，支持官方原生接口与 OpenAI 兼容调用。

Rivus AI 为 Gemini 生态提供完整的接口支持：

* **双重接口风格**：既支持 Gemini 官方原生接口，也提供 OpenAI 兼容路径，便于统一管理与快速切换。
* **统一认证**：使用 Rivus AI 控制台签发的 Token 即可访问，支持细粒度的密钥权限与监控。
* **多模态能力**：支持文本、图像、音频、视频等多种输入输出，覆盖对话、生图、视频生成等场景。

<Note>
  官方路径使用 `x-goog-api-key: <Rivus AI Token>` 认证；OpenAI 兼容路径使用 `Authorization: Bearer <Rivus AI Token>`。
</Note>

```bash theme={null}
export BASE_URL="https://models.rivus.cn"
export TOKEN="oh-xxxxxxxxxxxxxxxx"
```

配置好环境变量后，可直接用 cURL 调试：

```bash theme={null}
# 官方路径示例
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":"你好"}]}'
```

## 快速入口

<CardGroup cols={2}>
  <Card title="内容生成" icon="sparkles" href="/gemini/generate-content">
    使用 GenerateContent 接口进行对话与多模态交互。
  </Card>

  <Card title="向量嵌入" icon="vector-square" href="/gemini/embeddings">
    text-embedding 系列模型生成语义向量。
  </Card>

  <Card title="图像生成" icon="image" href="/gemini/images">
    Imagen 系列模型的文生图能力。
  </Card>

  <Card title="视频（OpenAI 风格）" icon="video" href="/gemini/video">
    使用统一的 OpenAI 接口 /v1/videos 创建与查询视频任务。
  </Card>

  <Card title="视频（Gemini 风格）" icon="film" href="/gemini/video-gemini">
    使用 /gemini/{version}/models/{model}:predictLongRunning 提交任务。
  </Card>

  <Card title="OpenAI 兼容" icon="code" href="/gemini/openai-compat">
    使用 OpenAI 风格接口调用 Gemini 模型。
  </Card>

  <Card title="故障排查" icon="wrench" href="/gemini/troubleshooting">
    常见问题与解决方案。
  </Card>

  <Card title="查询视频" icon="magnifying-glass" href="/gemini/video-get">
    GET /v1/videos/{id}，查看状态与元数据。
  </Card>

  <Card title="下载视频" icon="download" href="/gemini/video-content">
    GET /v1/videos/{id}/content，下载成片。
  </Card>

  <Card title="查询（Gemini 风格）" icon="magnifying-glass" href="/gemini/video-gemini-ops">
    GET /gemini/{version}/operations/{id}，轮询长任务。
  </Card>
</CardGroup>

## 接口风格说明

### 官方原生路径

* 路径格式：`/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 会自动完成请求格式转换与响应映射

<Callout type="info">
  推荐优先使用 OpenAI 兼容路径，便于在不同模型供应商之间无缝切换。官方原生路径适用于需要使用 Gemini 特有功能的场景。
</Callout>

<Callout type="warning">
  官方原生路径仅支持品牌归属为 Gemini 的模型。如需调用其他供应商的模型，请使用 OpenAI 兼容路径。
</Callout>