供应商与模型字段说明
模型列表通常会包含供应商、模型类型、标签、可用令牌分组和计费类型等字段。这些字段用于筛选模型、控制用户可见范围、限制令牌权限，并帮助业务理解不同模型的费用结构。
供应商
供应商表示模型来源或上游渠道，例如：
| 供应商 | 常见模型 |
|---|---|
| OpenAI | GPT、o 系列、图像模型 |
| Anthropic Claude | Claude Opus、Sonnet、Haiku |
| Gemini | Gemini Pro、Flash、Flash-Lite |
| Grok | Grok 推理、搜索、视觉模型 |
| 阿里云百炼 | Qwen、通义千问、多模态模型 |
| DeepSeek | DeepSeek Chat、DeepSeek Reasoner |
| MiniMax | MiniMax 文本、长上下文、多模态模型 |
| ChatGLM | GLM、GLM-5、GLM-V 等 |
供应商字段适合用于：
- 快速筛选某个上游模型
- 给用户展示模型来源
- 做供应商级别的成本统计
- 配置主备模型和降级策略
新手要注意：供应商只是“模型来自哪里”，不等于接口地址。通过 Xikapi 调用时，绝大多数 OpenAI 兼容工具仍然填写 Xikapi 的 Base URL，例如 https://xikapi.com/v1，而不是原厂官网地址。
模型类型
模型类型用于表达模型主要能力，而不是供应商名称。
| 模型类型 | 说明 |
|---|---|
| 文本 | 普通聊天、写作、总结、分类、抽取 |
| 推理 | 复杂推理、多步骤分析、数学、代码难题 |
| 代码 | 代码生成、解释、重构、审查 |
| 图像理解 | 图片问答、截图分析、票据识别 |
| 图像生成 | 文生图、图生图、图片编辑 |
| 视频生成 | 文生视频、图生视频 |
| 嵌入 | 向量检索、语义搜索、RAG |
| 语音 | 语音识别、语音合成、实时语音 |
| 工具调用 | 函数调用、外部 API、代理工作流 |
一个模型可能同时具备多种能力。后台展示时可以选择主类型，再通过标签补充能力。
如果用户反馈“模型明明能聊天，但传图片失败”，通常不是聊天能力问题，而是模型类型或标签没有覆盖图像理解。先确认后台模型是否真的支持对应输入模态。
标签
标签用于补充模型能力、适用场景或运营信息。标签不应替代模型类型，而是用于更细粒度筛选。
常见标签：
推荐低成本高速度长上下文强推理代码视觉工具调用结构化输出中文优化多模态新模型限时优惠
标签建议保持短、稳定、可筛选。不要把长说明写进标签。
标签是展示和筛选辅助，不应作为唯一权限判断。是否允许调用某个模型，仍要以令牌分组、模型启用状态和后端权限为准。
可用令牌分组
可用令牌分组用于控制哪些令牌可以调用某些模型。它适合做权限隔离、成本控制和客户分层。
| 分组 | 适合用途 |
|---|---|
| 默认分组 | 普通用户可用模型 |
| 高级分组 | 高成本或高能力模型 |
| 测试分组 | 内部测试、灰度模型 |
| 企业分组 | 企业客户专属模型 |
| 低成本分组 | 批量任务、低价模型 |
当调用报 model not found 或无权限时，不要只检查模型是否存在，还要检查当前 API Key 所属令牌分组是否包含该模型。管理后台能看到模型，不代表每个用户令牌都能调用。
计费类型
计费类型用于说明模型费用计算方式。不同模型可能按输入输出 token、请求次数、图片张数、视频秒数或工具调用计费。
| 计费类型 | 说明 |
|---|---|
| 按 token | 文本模型常见，区分输入和输出 |
| 按请求 | 简单 API 或固定成本任务 |
| 按图片 | 图像生成、图像编辑、图像理解 |
| 按视频 | 视频生成，可能按秒或条数计费 |
| 按工具调用 | 搜索、文件检索、代码执行等工具 |
| 混合计费 | token + 工具调用，或输入 + 输出 + 附加服务 |
筛选栏设计建议
| 筛选项 | 展示方式 | 说明 |
|---|---|---|
| 供应商 | 下拉或多选 | OpenAI、Claude、Gemini、Grok、DeepSeek 等 |
| 模型类型 | 下拉或分段筛选 | 文本、推理、视觉、图像生成等 |
| 标签 | 多选标签 | 低成本、长上下文、强推理、推荐等 |
| 可用令牌分组 | 下拉或多选 | 默认、高级、企业、测试等 |
| 计费类型 | 下拉 | token、图片、视频、工具调用等 |
移动端建议默认收起高级筛选，只保留搜索框、供应商和模型类型，避免筛选栏遮挡模型列表。
运营建议
- 模型名称、供应商和模型类型保持稳定
- 标签可以随运营策略调整，但不要过多
- 计费类型必须和实际扣费逻辑一致
- 可用令牌分组要避免默认开放高成本模型
- 下架或异常模型应保留说明，避免用户误以为是接口故障
新手排错顺序
遇到模型调用失败时，建议按这个顺序排查，避免一开始就改代码：
| 顺序 | 检查项 | 说明 |
|---|---|---|
| 1 | API Key | 是否是 Xikapi Key，是否复制完整，是否过期或被禁用 |
| 2 | Base URL | OpenAI 兼容 SDK 通常填 https://xikapi.com/v1，不要填完整接口路径 |
| 3 | 模型 ID | 是否和 Xikapi 后台启用模型名完全一致，包括大小写、版本后缀 |
| 4 | 令牌分组 | 当前 Key 是否有该模型权限 |
| 5 | 模型类型 | 文本、视觉、工具调用、结构化输出是否真的被该模型支持 |
| 6 | 请求格式 | OpenAI、Anthropic、Gemini 的请求字段不同，不要混用 |
| 7 | 输出限制 | 推理、长上下文和图片任务可能需要更大超时和输出上限 |
常见误配示例
| 问题 | 错误写法 | 正确方向 |
|---|---|---|
| Base URL 过长 | https://xikapi.com/v1/chat/completions 填进 SDK Base URL | SDK Base URL 填 https://xikapi.com/v1 |
| Key 来源不一致 | 用原厂 Key 调 Xikapi 地址 | 使用 Xikapi 控制台生成的 Key |
| 模型名前缀混乱 | 在 Cline 里写 openai/YOUR_MODEL_ID | 大多数工具只填后台模型 ID，Aider 等少数工具才需要 provider 前缀 |
| 能力标签误判 | 给文本模型加了“视觉”标签就传图片 | 必须确认上游模型和兼容接口都支持图片输入 |
| 权限遗漏 | 只在后台添加模型，没有加入用户令牌分组 | 把模型加入对应可用令牌分组后再测试 |