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

# Gemini 概览

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

## 环境配置

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

## 快速体验

```bash theme={null}
curl -X POST "https://xuwuai.com/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>

## 可用模型

实际可用模型由 Token 权限决定，请以模型列表接口的实时返回为准：

```bash theme={null}
curl "https://xuwuai.com/v1beta/models" \
  -H "x-goog-api-key: $TOKEN"
```

### 文本生成

| 模型                       | 支持的方法             |
| ------------------------ | ----------------- |
| `gemini-3.6-flash`       | `generateContent` |
| `gemini-3.5-flash`       | `generateContent` |
| `gemini-3.5-flash-lite`  | `generateContent` |
| `gemini-3.1-pro-preview` | `generateContent` |
| `gemini-3-flash`         | `generateContent` |
| `gemini-3-flash-preview` | `generateContent` |
| `gemini-2.5-pro`         | `generateContent` |
| `gemini-2.5-flash`       | `generateContent` |

### 图像生成

| 模型                               | 支持的方法             |
| -------------------------------- | ----------------- |
| `gemini-3.1-flash-image`         | `generateContent` |
| `gemini-3.1-flash-image-preview` | `generateContent` |
| `gemini-3.1-flash-lite-image`    | `generateContent` |
| `gemini-3-pro-image`             | `generateContent` |
| `gemini-3-pro-image-preview`     | `generateContent` |
| `gemini-2.5-flash-image`         | `generateContent` |
| `gemini-2.5-flash-image-preview` | `generateContent` |

### 视频与 Omni

| 模型                              | 支持的方法                |
| ------------------------------- | -------------------- |
| `omni-fast`                     | `generateContent`    |
| `veo-3.1-generate-preview`      | `predictLongRunning` |
| `veo-3.1-fast-generate-preview` | `predictLongRunning` |

## 认证方式

所有接口均支持 Bearer Token 认证：

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

Gemini 原生接口和 Vertex AI Express 兼容入口也支持：

```
x-goog-api-key: <your-token>
```

这里填写的是 Xuwu Token，不是 Google Cloud API Key。

## 接口风格

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

| 功能                       | 接口                                                          |
| ------------------------ | ----------------------------------------------------------- |
| 对话                       | `POST /v1/chat/completions`                                 |
| 嵌入                       | `POST /v1/embeddings`                                       |
| 图像                       | `POST /v1/images/generations`                               |
| 视频                       | `POST /v1/videos`                                           |
| Gemini 原生文本生成            | `POST /v1beta/models/{model}:generateContent`               |
| Vertex AI Express 兼容文本生成 | `POST /v1/publishers/google/models/{model}:generateContent` |

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

<Note>
  Vertex AI Express 兼容入口只兼容请求路径和 Gemini 请求体；实际使用的上游渠道由平台路由决定。
</Note>