模型权限

模型分组：先选分组，再复制模型 ID

令牌能不能调用某个模型，不只取决于模型名，还取决于令牌绑定的分组。分组不匹配时，最常见的表现就是 403、模型列表为空或 model not found。

预计阅读 7 分钟适合不确定模型、分组和令牌权限关系的用户

所有工具共用规则模型广场 403 排查分组选择

开始前你需要准备

模型分组不是单独配置项，它会同时影响令牌、模型 ID、Base URL 和客户端验证。开始前先把下面四件事放到一起看。

准备项	要确认什么	为什么重要
目标工具	Claude Code、Codex CLI、Cherry Studio、n8n、API 程序等。	不同工具使用的协议不同，Base URL 和可用模型也不同。
目标任务	聊天、写代码、图片生成、图片编辑、视频生成、批量工作流。	同一个客户端也可能调用不同能力，分组要按任务选。
6星中转令牌	令牌名称、所属分组、是否启用、是否还有额度。	403 多数不是“工具坏了”，而是令牌没有目标模型权限。
模型 ID 来源	从模型广场或 `/v1/models` 复制。	不要用旧截图、聊天记录或记忆里的模型名。

如果你还没有令牌，先回到令牌创建流程。如果只是想接入一个客户端，先看工具选择表。

一句话结论

分组是一组模型的权限范围；令牌是一把钥匙。一把钥匙通常只能打开它绑定的那组模型。

名词	它是什么	你要怎么用
令牌	工具调用 6星中转时使用的认证字符串。	复制到客户端、环境变量或服务端 Secret 中。
分组	令牌可访问的模型集合。	创建令牌时按工具或任务选择，不确定时先看模型广场。
模型 ID	请求体里的 `model` 字段。	从 6星中转模型广场或 `/v1/models` 复制，不要手写。
倍率和能力	模型的计费和功能差异。	以模型广场、控制台和账单展示为准。

分组解决权限问题

它回答“这张令牌能不能用这个模型”。如果分组不匹配，即使地址、令牌格式和模型拼写都对，也可能 403。

状态页解决可用性问题

它回答“平台探测视角下这类模型是否稳定”。如果分组正确但大量请求 5xx，再看状态页。

等不及了，直接告诉我选哪个

你要用什么	优先选择哪类分组	为什么
Claude Code、Claude 原生 Messages	Claude 相关分组	Claude Code 使用根地址 `https://www.6xin.cc`，模型和令牌分组也要对应 Claude 能力。
Codex CLI、OpenAI SDK、OpenAI 兼容客户端	GPT / Codex / OpenAI 兼容相关分组	这些工具通常走 `https://www.6xin.cc/v1`，请求格式是 OpenAI 兼容协议。
Gemini CLI 或 Gemini 模式工具	Gemini 相关分组	模型 ID、长上下文和多模态能力都要和 Gemini 分组匹配。
Cherry Studio 聊天	和你选择的聊天模型对应的分组	同一个客户端可以填不同模型，但令牌必须能访问该模型。
文生图、图像编辑、图片理解	图像或视觉相关分组	图片任务不是普通聊天模型换 prompt，需要对应能力和接口。
视频生成、视频查询、短片工作流	视频相关分组	视频模型通常更依赖异步任务和额度控制，建议单独令牌。
找不到对应模型或需要兼容兜底	通用或兼容分组	适合临时验证，但长期业务建议换成更精确的分组。

具体分组名称和可用模型以 6星中转控制台实时展示为准。本页写的是选择逻辑，不替代控制台里的实时模型列表。

按步骤配置分组和模型

先确定工具协议

Claude Code 看 Claude 规则；Codex CLI、Cherry Studio、OpenAI SDK 看 OpenAI 兼容规则；图像视频看多媒体接口规则。

打开模型广场筛选分组

先点左侧分组，再看右侧模型列表。只复制当前分组里显示的模型 ID。

创建或选择同分组令牌

如果手里的令牌不是这个分组，重新创建一张用途明确的令牌，不要试图拿错误分组硬调。

在工具里填入地址和模型

OpenAI 兼容工具填 https://www.6xin.cc/v1；Claude Code 填 https://www.6xin.cc。模型 ID 直接粘贴复制结果。

做一次真实请求

不要只看模型列表。用短 prompt 跑一次生成，再到 6星中转用量日志按时间核对。

三步判断：到底是分组、模型还是地址

不要看到报错就马上换工具。按下面顺序排，能把大多数问题缩小到一个层级。

步骤	看什么	结论
1. 先看认证	`/v1/models` 返回 401，或工具提示 API Key 无效。	优先处理令牌复制、过期、禁用、空格和保存位置。
2. 再看可见模型	`/v1/models` 能返回，但没有你要的模型。	当前令牌分组看不到这个模型，换同分组模型或新建匹配令牌。
3. 最后看真实生成	模型列表有目标模型，但聊天、图片或视频请求失败。	检查接口路径、请求字段、模型能力、上下文大小和状态页。

三个例子

Claude Code 报 403

先确认 Base URL 是 https://www.6xin.cc，再确认令牌属于 Claude 相关分组。地址和分组都对，再检查模型 ID。

Codex CLI 模型不存在

Codex CLI 走 /v1。如果模型 ID 是从别的分组复制的，当前令牌可能看不到它。

生图接口返回错误

确认使用图像模型、图像分组令牌和 /v1/images/generations 或 /v1/images/edits。

模型 ID 不要手写

模型 ID 经常带版本号、能力后缀或供应商标识，少一个字符都可能失败。推荐只用两种来源：

来源	适合谁	怎么验证
6星中转模型广场	图形用户、新手、手动配置工具的人。	按分组筛选后复制模型 ID，再粘到工具配置里。
`GET /v1/models`	开发者、脚本、需要动态展示模型列表的后端。	用当前令牌请求，返回列表就是这张令牌可见的模型范围；继续看模型列表快速判断。

curl "https://www.6xin.cc/v1/models" \
  -H "Authorization: Bearer sk-你的令牌"

返回列表里只需要重点看三件事：模型 ID 是否存在、它属于哪个能力方向、是否和你当前工具协议匹配。

你看到的结果	代表什么	下一步
能看到目标模型	令牌至少有模型可见权限。	继续做真实生成验证。
只看到别的模型	令牌有效，但分组不含目标模型。	换模型或创建目标分组令牌。
返回 401	令牌无效、过期、被禁用或复制不完整。	回令牌验证重新确认。

两步验证：先看模型列表，再跑真实生成

模型列表只能证明“这张令牌能看见什么”。真正接入成功，还要用同一张令牌和同一个模型 ID 跑一次短请求。

确认当前令牌可见模型

用目标令牌请求模型列表，不要拿管理员账号页面里的模型名替代。

curl "https://www.6xin.cc/v1/models" \
  -H "Authorization: Bearer sk-你的令牌"

用同一个模型 ID 跑短请求

OpenAI 兼容工具用 /v1/chat/completions。把 模型广场复制的模型ID 换成第一步确认可见的模型。

curl "https://www.6xin.cc/v1/chat/completions" \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "模型广场复制的模型ID",
    "messages": [{"role": "user", "content": "回复 OK"}]
  }'

回控制台核对用量日志

用量日志里能看到同一时间、同一模型、同一令牌的记录，才算验证链路闭环。

Claude Code 手动配置时 Base URL 仍然填 https://www.6xin.cc，不要为了测试把工具里的地址改成 /v1。上面的 curl 只是用于验证令牌和模型可见性。

分组不匹配时怎么排查

现象	先查什么	下一步
`403 Forbidden`	令牌分组是否允许访问该模型。	换同分组模型，或创建匹配分组的新令牌。
`model not found`	模型 ID 是否从当前分组复制。	回模型广场按分组重新复制，或请求 `/v1/models` 对照。
客户端模型列表为空	Base URL、令牌、分组是否匹配。	先用 curl 请求 `/v1/models`，再排查客户端配置。
同一个模型有时成功有时失败	是否在多个工具中混用了不同令牌。	给每个工具单独命名令牌，并记录分组。
模型列表能看到，生成仍失败	接口路径、请求字段、上下文长度和模型能力。	用聊天接口验证或图像视频预检缩小范围。

什么时候应该换分组或新建令牌

情况	建议	原因
只是临时试一个同类模型	先在当前分组里换模型 ID。	同类模型通常使用同一套工具配置，排障成本低。
从聊天改成图像或视频	新建图像或视频分组令牌。	多媒体任务消耗、接口路径和权限都不同，单独管理更清楚。
从个人试用变成项目长期使用	新建项目专用令牌，并记录分组和模型 ID。	后续轮换、禁用、账单追踪和故障定位都更容易。
一个工具里要频繁切 Claude、Codex、Gemini	使用 CC Switch 管理多套配置。	减少手写地址、模型和令牌导致的交叉错误。

这些情况先停下来，不要继续换更多分组

模型分组排障要先固定令牌、模型 ID 和工具地址。一次同时换分组、换模型、换客户端，会让错误来源变得不可判断。

现象	先停止什么	下一步只做这一件事
401	不要先换分组。	回到令牌和认证检查，确认 API Key 生效。
403	不要继续换 Base URL。	只检查当前令牌所在分组是否允许该模型。
`model not found`	不要手写模型 ID。	从模型广场或 `/v1/models` 复制当前可见模型。
工具地址规则不确定	不要把 Claude、Codex、Gemini 写成同一个地址。	回到接口速查，按工具协议分别确认是否带 `/v1`。
一个令牌承担太多任务	不要继续把新工具接到同一枚令牌。	按工具、环境或能力新建专用令牌。

多令牌管理建议

按工具命名

例如 claude-code-local、codex-cli-work、cherry-image，看名字就知道用途。

按环境隔离

本地、测试、生产不要共用。测试脚本跑飞时，不应该影响生产服务。

按能力拆开

聊天、图像、视频消耗和排障方式不同。高消耗任务建议独立令牌。

离开项目就删除

旧电脑、临时脚本、离职成员、废弃项目的令牌要及时删除或禁用。

仍然不通，提交这些定位信息

不要提交完整密钥。只需要提供能复现和定位的信息，敏感内容用前后几位或截图打码。

信息	建议内容	不要提供什么
工具和版本	Claude Code、Codex CLI、Cherry Studio、n8n 或自写 SDK，以及大致版本。	不要只写“客户端不能用”。
Base URL	`https://www.6xin.cc` 或 `https://www.6xin.cc/v1`，说明填在哪个字段里。	不要把令牌拼在 URL 里。
模型 ID	从模型广场或 `/v1/models` 复制的完整模型名。	不要用截图里看不清的模型名，也不要写“那个 Claude 模型”。
令牌分组和片段	令牌用途、分组名称、脱敏片段，例如 `sk-前6位...后4位`。	不要提交完整 API Key。
错误码和时间	`403`、`model not found`、`401` 等，以及具体时间点。	不要只写“刚刚报错”。
已尝试步骤	重新复制模型 ID、换同分组令牌、跑过 `/v1/models` 或真实短请求。	不要把多个客户端的报错混在一起。

完成标准

检查项	通过标准	不通过时看哪里
分组选择	能说清楚当前令牌为什么属于这个分组。	分组选择表
模型 ID	模型 ID 来自模型广场或 `/v1/models`，不是手写。	模型 ID 不要手写
工具地址	OpenAI 兼容工具用 `/v1`，Claude Code 不手动加 `/v1`。	接口速查
真实请求	用当前令牌和当前模型跑过一次短请求。	两步验证
错误定位	能区分 401 是令牌问题，403 是分组权限，404 可能是模型或路径。	错误码速查