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

# 模型

> 通过统一 API 发现并使用 x6.ai 当前支持的各厂商及路由渠道的模型目录。

# 模型

x6.ai 从实时注册表中暴露当前模型目录。随着模型和路由渠道的新增、更新或下线，目录数量会动态变化，请使用 `GET /api/v1/models` 返回的 `total` 字段作为准确数量的来源，而非硬编码某个模型数量。

完整目录请访问 [**https://x6.ai/models**](https://x6.ai/models)。

***

## API 参考

### 获取模型列表

返回抽象模型的分页列表，包含元数据、能力标签、路由渠道别名以及上下文/输出长度限制。

```http theme={null}
GET /api/v1/models
```

#### 参数

| 参数 | 类型 | 默认值 | 说明 |
| - | - | - | - |
| `page` | `int` | `1` | 页码 |
| `page_size` | `int` | `20` | 每页条数（最大 `100`） |
| `model_name` | `string` | - | 对模型显示名称进行大小写不敏感的模糊搜索 |
| `provider` | `string` | - | 按单个路由渠道别名过滤（向后兼容） |
| `providers` | `string[]` | - | 多选路由渠道过滤（最多 20 个值） |
| `vendor` | `string` | - | 按单个厂商/模型所有者过滤（向后兼容） |
| `vendors` | `string[]` | - | 多选厂商过滤（最多 20 个值） |
| `label` | `string` | - | 按标签过滤：`Recommended`、`Flagship`、`Free for Now` 或 `Deprecated` |
| `tags` | `string[]` | - | 能力标签或模态过滤（最多 10 个值），如 `Text`、`Image`、`File`、`Audio`、`Video` |
| `show_deprecated` | `bool` | `true` | 是否在结果中包含已下线模型 |
| `context_min` | `int` | - | 最小上下文窗口长度（token 数） |
| `context_max` | `int` | - | 最大上下文窗口长度（token 数） |
| `output_min` | `int` | - | 最小最大输出长度（token 数） |
| `output_max` | `int` | - | 最大输出长度（token 数） |

数组参数请使用重复的查询键传递，例如 `vendors=OpenAI&vendors=Google`。

#### 示例

```bash theme={null}
curl "https://api.x6.ai/v1/models?page=1&page_size=20"
```

#### 响应

```json theme={null}
{
  "total": 66,
  "page": 1,
  "page_size": 1,
  "items": [
    {
      "id": 58,
      "model_name": "Gemini 3.1 Pro Preview",
      "vendor": "Google",
      "providers": "Default",
      "description": "Gemini 3.1 Pro Preview is Google's frontier reasoning model...",
      "label": "Recommended",
      "tags": "Text, Image, File, Audio, Video",
      "total_context": 1050000,
      "max_output": 65500,
      "is_free": false,
      "created_at": "2026-03-31T15:18:37",
      "updated_at": "2026-03-31T15:18:37"
    }
  ]
}
```

以上为示例响应结构，实时目录可能有所变化。

***

### 模型分组

返回指定模型在不同路由渠道下的实现，按 x6.ai API 兼容格式和路由渠道别名分组。该接口用于模型详情页，方便查看哪些渠道可以提供该模型。

```http theme={null}
GET /api/v1/models/group?model_name=Gemini%203.1%20Pro%20Preview
```

#### 响应结构

```json theme={null}
{
  "Gemini 3.1 Pro Preview": {
    "OpenAI": {
      "Default": [
        {
          "model_id": 1097,
          "model_name": "gemini-3.1-pro-preview",
          "display_name": "Gemini 3.1 Pro Preview",
          "model_standard": "OpenAI",
          "provider": "Default",
          "endpoint": "https://api.x6.ai",
          "vendor": "Google",
          "total_context": 1050000,
          "max_output": 65500,
          "pricing": {
            "input": [
              {
                "token_min": 0,
                "token_max": 200000,
                "price_usd": "2.20000000000000",
                "price_wai_credit": 2200
              }
            ],
            "output": [
              {
                "token_min": 0,
                "token_max": 200000,
                "price_usd": "13.20000000000000",
                "price_wai_credit": 13200
              }
            ]
          }
        }
      ]
    }
  }
}
```

目前，公开的 `GET /api/v1/{model_standard}/models` 路由支持 `OpenAI`、`Anthropic` 等 x6.ai API 兼容格式。当您需要查看某个抽象模型的分组视图时，请使用 `/api/v1/models/group`。

***

### 提供商列表

返回所有可用的路由渠道别名，按字母顺序排序。路由渠道别名是路由渠道，不一定是模型厂商。

```http theme={null}
GET /api/v1/models/providers
```

```bash theme={null}
curl "https://api.x6.ai/v1/models/providers"
```

示例值包括 `OpenAI Channel`、`Anthropic Channel`、`GCP Vertex`、`Default` 和 `Default`。

***

### 厂商列表

返回所有唯一厂商名称，按字母顺序排序。厂商是模型的所有者或模型系列，如 `OpenAI`、`Anthropic`、`Google`、`DeepSeek`、`Qwen` 等。

```http theme={null}
GET /api/v1/models/vendors
```

```bash theme={null}
curl "https://api.x6.ai/v1/models/vendors"
```

***

## 模型标签

**x6.ai/models** 上的模型带有标签，帮助您选择合适的模型：

| 标签 | 含义 |
| - | - |
| `Recommended` | 适用于大多数场景的推荐选择 |
| `Flagship` | 某厂商或模型系列中的顶级能力模型 |
| `Free for Now` | 当前可免费使用（价格可能随时调整） |
| `Deprecated` | 已停止维护，但仍保留兼容支持的模型 |

***

## 定价

x6.ai 在 `model_pricing` 表中以每模型、每路由渠道、每 token 类型的分级方式存储定价。定价信息可通过返回模型实现信息的接口获取，例如 `GET /api/v1/models/group` 和 `GET /api/v1/{model_standard}/models?with_price=true`。

每条定价记录包含：

| 字段 | 说明 |
| - | - |
| `token_min` | 该计费档位的 token 数下限（含） |
| `token_max` | 该计费档位的 token 数上限（含）；`null` 表示不限上限 |
| `price_usd` | 该档位每 1,000,000 token 的美元单价 |
| `price_wai_credit` | 该档位每 1,000,000 token 的 x6.ai 积分单价 |

注册表支持的 token 类型目前包括：

| Token 类型 | 说明 |
| - | - |
| `input` | 输入文本 token |
| `output` | 输出文本 token |
| `cache_read` | 已缓存输入 token 的读取 |
| `cache_write` | 已缓存输入 token 的写入 |
| `input_audio` / `output_audio` | 音频输入或输出 token |
| `input_image` / `output_image` | 图像输入或输出单位/token |
| `input_video` / `output_video` | 视频输入或输出单位/token |
| `input_audio_cache` / `input_image_cache` / `input_video_cache` | 已缓存的模态专属输入 |
| `output_per_audio` / `output_per_image` / `output_per_video` | 按输出媒体单位计费 |

价格为 `0` 表示该档位免费。

***

## 聊天补全请求参数

调用 `POST /api/v1/chat/completions` 时，支持的参数取决于目标模型和路由渠道。常用的 OpenAI 兼容参数包括：

| 参数 | 说明 |
| - | - |
| `model` | 目标 x6.ai 模型标识符 |
| `messages` | 对话数组 |
| `temperature` | 输出随机性 |
| `top_p` | 核采样 |
| `n` | 生成的补全数量 |
| `max_tokens` / `max_completion_tokens` | 最大补全长度 |
| `stop` | 自定义停止序列 |
| `stream` / `stream_options` | 流式输出控制 |
| `presence_penalty` | 鼓励话题多样性 |
| `frequency_penalty` | 减少重复内容 |
| `logit_bias` | 调整 token 概率 |
| `logprobs` / `top_logprobs` | token 对数概率控制 |
| `tools` | 函数/工具定义 |
| `tool_choice` | 控制工具选择行为 |
| `parallel_tool_calls` | 允许或禁用并行工具调用 |
| `response_format` | 响应格式控制，支持模型的 JSON/schema 格式输出 |
| `modalities` / `audio` | 支持模型的多模态输出控制 |
| `reasoning_effort` | 支持模型的推理力度 |
| `web_search_options` | 支持模型的网络搜索选项 |
| `metadata` | 调用方提供的元数据 |
| `service_tier` | 提供商专属服务等级 |
| `store` | 支持时的提供商侧存储偏好 |
| `verbosity` | 支持时的详细程度控制 |

部分渠道可能接受提供商特有的额外字段，但可移植的行为应基于上述参数以及目标模型的能力。

***

## 数据模型

x6.ai 在三个核心表中维护统一的 MySQL 注册表：

| 表名 | 用途 |
| - | - |
| `model` | 路由渠道实现行：模型标识符、路由渠道、API 兼容格式、端点、上下文窗口、输出长度限制及激活状态 |
| `model_pricing` | 每路由渠道、每 token 类型的定价分级 |
| `model_metadata` | 抽象模型元数据：厂商、提供商列表、标签、标识、描述及显示名称 |

第四张表 **`model_fallback_chains`** 定义提供商故障转移行为。当主提供商耗尽时，网关可按 `priority` 排序的下一个启用的故障转移条目重试。

***

## 提供商与厂商

x6.ai 将“路由渠道”和“模型厂商”作为两个独立概念：

| 概念 | 含义 | 示例 |
| - | - | - |
| 路由渠道 | 处理请求的路由渠道 | `Default`、`GCP Vertex`、`OpenAI Channel` |
| 厂商 | 模型所有者或模型系列 | `OpenAI`、`Anthropic`、`Google`、`DeepSeek`、`Qwen` |
| API 兼容格式 | 模型实现使用的 API 兼容格式 | `OpenAI`、`Anthropic` |

使用 `GET /api/v1/models/providers` 和 `GET /api/v1/models/vendors` 获取当前实时列表。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.