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

# 文字系列概览

> 文字系列覆盖 OpenAI 兼容文本接口、Claude 原生消息接口、Gemini 原生接口、OpenAI Responses、多模态输入、模型列表与 Realtime。

# 文字系列

<CardGroup cols={2}>
  <Card title="模型支持矩阵" icon="table-cells" href="/zh/texts/model-matrix">
    按协议风格和能力类型查看文本系列支持范围、典型模型家族和推荐入口。
  </Card>

  <Card title="通用对话" icon="messages-square" href="/zh/texts/chat-completions-stream">
    `POST /v1/chat/completions`，适合聊天、Agent、长文本生成和多模态输入。
  </Card>

  <Card title="OpenAI Responses" icon="bot" href="/zh/texts/openai-responses">
    `POST /v1/responses`，适合工具调用、结构化输出和上下文续接。
  </Card>

  <Card title="Claude 原生" icon="file-text" href="/zh/texts/claude-messages">
    `POST /v1/messages`，保留 Anthropic Messages 协议。
  </Card>

  <Card title="Gemini 原生" icon="sparkles" href="/zh/texts/gemini-native">
    `POST /v1beta/models/{model}:{action}` 与 `GET /v1beta/models`。
  </Card>
</CardGroup>

## 认证方式

大多数文字 relay 接口使用 Bearer Token：

```http theme={null}
Authorization: Bearer YOUR_API_KEY
```

Claude 原生格式同时兼容：

```http theme={null}
x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
```

Gemini 原生格式同时兼容：

```http theme={null}
x-goog-api-key: YOUR_API_KEY
```

## 接口清单

| Method | Path                              | 页面                                             | 说明                                      |
| ------ | --------------------------------- | ---------------------------------------------- | --------------------------------------- |
| `POST` | `/v1/chat/completions`            | [通用对话接口（默认流式）](./chat-completions-stream)      | OpenAI Chat Completions 兼容格式，文档默认展示流式调用 |
| `POST` | `/v1/chat/completions`            | [通用对话接口（默认非流式）](./chat-completions-non-stream) | 同一路由的非流式写法                              |
| `POST` | `/v1/completions`                 | [文本补全接口](./completions)                        | Legacy Completions 兼容格式                 |
| `POST` | `/v1/messages`                    | [Claude 消息接口](./claude-messages)               | Anthropic Messages 原生协议                 |
| `POST` | `/v1/responses`                   | [OpenAI 多模态响应接口](./openai-responses)           | Responses API                           |
| `POST` | `/v1/responses/compact`           | [OpenAI 多模态响应接口](./openai-responses#上下文压缩)     | 上下文压缩                                   |
| `GET`  | `/v1/realtime`                    | [Realtime 接口](./realtime)                      | OpenAI Realtime 兼容 WebSocket            |
| `GET`  | `/v1/models`                      | [模型列表](./models)                               | OpenAI/Claude/Gemini 兼容模型列表             |
| `GET`  | `/v1/models/{model}`              | [模型列表](./models)                               | 单模型查询                                   |
| `GET`  | `/v1beta/models`                  | [Gemini 原生格式](./gemini-native)                 | Gemini 原生模型列表                           |
| `POST` | `/v1beta/models/{model}:{action}` | [Gemini 原生格式](./gemini-native)                 | Gemini 原生推理与图像/视频相关动作                   |
| `GET`  | `/v1beta/openai/models`           | [模型列表](./models)                               | Gemini 兼容模型列表                           |
| `POST` | `/pg/chat/completions`            | [通用对话接口（默认非流式）](./chat-completions-non-stream) | Playground 调试路由，使用登录态而非 API Key         |

## 通用错误码

| 状态码   | 说明                             |
| ----- | ------------------------------ |
| `400` | 请求参数错误，例如模型名不存在、消息结构无效、工具定义不合法 |
| `401` | API Key 缺失、无效或过期               |
| `402` | 额度不足                           |
| `413` | 请求体过大                          |
| `429` | 请求频率超限                         |
| `500` | 服务端内部错误                        |
| `503` | 上游不可用或系统临时过载                   |

<Tip>
  如果接口页里标记了“可选”参数，不代表所有模型都支持该字段。最终是否透传、是否生效，仍取决于实际分发到的渠道能力。
</Tip>

## 推荐阅读顺序

1. [文本模型支持矩阵](./model-matrix)
2. [通用对话接口（默认流式）](./chat-completions-stream)
3. [OpenAI 多模态响应接口](./openai-responses)
4. [Claude 消息接口](./claude-messages)
5. [Gemini 原生格式](./gemini-native)
6. [模型列表](./models)
7. [Realtime 接口](./realtime)