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

# Gemini 概览

> 通过平台调用 Gemini 系列模型

## 环境配置

```bash theme={null}
export BASE_URL="https://models.hingnet.com.cn"
export TOKEN="your-api-token"
```

## 快速体验

```bash theme={null}
curl -X POST "$BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'
```

## 支持的功能

<CardGroup cols={2}>
  <Card title="文本生成" icon="message" href="/gemini/generate-content">
    对话、多模态、思考模式、工具调用
  </Card>

  <Card title="Chat 图像能力" icon="image" href="/gemini/chat-image">
    通过 Chat 接口进行文生图与改图
  </Card>

  <Card title="向量嵌入" icon="vector-square" href="/gemini/embeddings">
    文本语义向量生成
  </Card>

  <Card title="图像生成" icon="image" href="/gemini/images">
    Imagen 系列文生图
  </Card>

  <Card title="视频生成" icon="video" href="/gemini/video">
    Veo 系列文生视频、图生视频
  </Card>
</CardGroup>

## 可用模型

### 文本生成

| 模型                               | 特点                       |
| -------------------------------- | ------------------------ |
| `gemini-3-pro-preview`           | 更强推理与多模态能力（预览）           |
| `gemini-3-pro-preview-file`      | file\_uri 兼容任意文件 URL（预览） |
| `gemini-2.5-flash`               | 快速响应，性价比高                |
| `gemini-2.5-pro`                 | 更强推理能力                   |
| `gemini-2.5-flash-image-preview` | Chat 文生图/改图（1K）          |
| `gemini-2.0-flash`               | 上一代快速模型                  |
| `gemini-1.5-pro`                 | 长上下文支持                   |

### 图像生成

| 模型                             | 说明           |
| ------------------------------ | ------------ |
| `imagen-3.0-generate-001`      | Imagen 3 标准版 |
| `imagen-3.0-fast-generate-001` | Imagen 3 快速版 |

### 视频生成

| 模型                              | 说明          |
| ------------------------------- | ----------- |
| `veo-3.1-generate-preview`      | Veo 3.1 标准版 |
| `veo-3.1-fast-generate-preview` | Veo 3.1 快速版 |

## 认证方式

所有接口统一使用 Bearer Token 认证：

```
Authorization: Bearer <your-token>
```

## 接口风格

平台提供 OpenAI 兼容接口，可直接使用 OpenAI SDK 调用 Gemini 模型：

| 功能 | 接口                            |
| -- | ----------------------------- |
| 对话 | `POST /v1/chat/completions`   |
| 嵌入 | `POST /v1/embeddings`         |
| 图像 | `POST /v1/images/generations` |
| 视频 | `POST /v1/videos`             |

<Tip>
  推荐使用 OpenAI 兼容接口，便于在不同模型供应商间切换。
</Tip>