Cherry Studio 接入 6星中转：选择 OpenAI 兼容提供商
Cherry Studio 适合不想写代码、不想改终端配置的用户。按本页填写 Base URL、API Key 和模型 ID 后，就能在图形界面里使用 6星中转 模型。
等不及了，先照这张表填
Cherry Studio 走 OpenAI 兼容接口。先按下面字段填好，再去验证模型列表和短消息。
| 字段 | 填写值 | 最容易错的点 |
|---|---|---|
| 提供商类型 | OpenAI / OpenAI Compatible / 自定义 OpenAI | 不要选成 Claude、Gemini 或本地模型提供商。 |
| 名称 | 6星中转 或 6星中转-Chat |
只影响本地显示，建议带用途。 |
| API 地址 / Base URL | https://www.6xin.cc/v1 |
必须带 /v1；不要填 Claude Code 的根地址。 |
| API Key | sk-你的6星中转令牌 |
只填令牌本身，不要加 Bearer。 |
| 模型 | 模型广场复制的模型 ID | 模型要和令牌分组匹配；403 多数卡在这里。 |
Cherry Studio 字段填写示意
先把软件设置页里会遇到的输入项列清楚，再去处理模型刷新和功能验证。Cherry Studio 只要确认提供商类型、Base URL、API Key 和模型即可。
模型服务 / 自定义 OpenAI 提供商
先按最小配置跑通聊天6星中转-Chathttps://www.6xin.cc/v1/v1。sk-你的6星中转令牌Bearer，不要在截图里露出完整内容。开始前准备
Cherry Studio 的配置项不多，但最容易错在令牌、模型分组和 Base URL。先把下面四项准备好，再去软件里添加提供商。
| 准备项 | 你要拿到什么 | 不确定时看哪里 |
|---|---|---|
| Cherry Studio 客户端 | 能打开设置页和模型服务页的桌面客户端。 | 优先从 Cherry Studio 官方渠道下载安装，不要使用来路不明的安装包。 |
| 6星中转 令牌 | 一条用途明确的令牌，例如 cherry-chat 或 cherry-image。 |
令牌与安全 |
| 模型 ID | 从 6星中转 模型广场复制的模型 ID。 | 模型分组 |
| 目标用途 | 先决定是聊天、写作、图像理解，还是图像生成。 | 图像与视频 |
打开软件前，先用 curl 预检一次
如果这一步失败，先不要在 Cherry Studio 里反复改配置。先确认 6星中转 令牌、Base URL 和模型分组本身可用。
curl "https://www.6xin.cc/v1/models" \
-H "Authorization: Bearer sk-你的令牌"| 返回结果 | 说明 | 下一步 |
|---|---|---|
| 返回模型列表 | 令牌有效，且能看到当前分组模型。 | 继续在 Cherry Studio 里添加提供商。 |
401 |
令牌无效、过期、复制不完整或被禁用。 | 回 令牌验证 重新创建或复制。 |
| 能返回但没有目标模型 | 当前令牌分组看不到目标模型。 | 按 模型分组选择表 换令牌或模型。 |
配置步骤
打开设置里的模型服务
进入 Cherry Studio 设置，找到模型服务或提供商管理页面。不同版本菜单名字可能略有差异。
新增 OpenAI 兼容提供商
提供商类型选择 OpenAI、OpenAI Compatible 或自定义 OpenAI。名称建议写 6星中转。
填写 Base URL 和 API Key
| 字段 | 填写内容 |
|---|---|
| Base URL | https://www.6xin.cc/v1 |
| API Key | sk-你的令牌 |
| 模型 | 从 6星中转 模型广场复制模型 ID。 |
API Key 输入框只填令牌本身，不要手动加 Bearer。Base URL 必须带 /v1，这是 Cherry Studio 走 OpenAI 兼容接口时最关键的字段。
启用提供商并检查 API Key
如果列表里有启用开关，先打开；如果有 Check、Test 或验证按钮，点一次。失败时先看错误码，不要急着换模型。
添加或刷新模型
如果 Cherry Studio 能拉取模型列表，先刷新；如果不能自动拉取，就手动添加从 6星中转 模型广场复制的模型 ID。
测试一次对话
新建聊天，选择刚添加的 6星中转 提供商和模型，发送“回复 OK”。能看到回复并在 6星中转 用量日志里对上时间，才算配置成功。
模型管理：能自动拉取就拉取，不能就手动添加
不同 Cherry Studio 版本对自定义提供商的模型管理方式可能不同。你只需要保证最终能在聊天界面选到 6星中转 模型。
| 客户端表现 | 怎么做 | 注意 |
|---|---|---|
| 有刷新或管理模型按钮 | 先点击刷新，让客户端请求 /v1/models。 |
刷新失败时先看令牌和 Base URL，不要直接判断模型下线。 |
| 需要手动添加模型 | 从 6星中转 模型广场复制模型 ID，逐个添加。 | 不要用截图或旧文档里的模型名。 |
| 模型能添加但聊天失败 | 确认模型 ID 属于当前令牌分组。 | 模型出现在本地列表，不代表 6星中转 允许这张令牌调用。 |
| 要聊天和生图都用 | 建议分别建 6星中转-Chat 和 6星中转-Image。 |
分开后用量和排障都更清楚。 |
验证流程
不要一开始就上传图片或跑长上下文。先用最短路径确认三个层级：
保存提供商
保存后回到模型服务列表，确认 6星中转 提供商仍然存在且处于启用状态。
刷新模型列表
如果客户端支持从接口拉取模型，先刷新一次；失败时看 401/403/404。
发送短消息
新建聊天，只发送“回复 OK”。能返回内容后再尝试长文本、图片或工具功能。
聊天和图像要分开验证
Cherry Studio 里不同功能区可能走不同接口。聊天成功不代表生图成功，模型列表能刷新也不代表真实生成一定能跑通。
| 你要验证什么 | 怎么测 | 成功表现 | 失败时先查 |
|---|---|---|---|
| 普通聊天 | 新建聊天，选择 6星中转 提供商和文本模型，发送“回复 OK”。 | 能收到文本回复，6星中转 用量日志能对上时间。 | Base URL、API Key、模型分组。 |
| 图像理解 | 使用支持视觉输入的模型，上传一张不含隐私的测试图片，让模型描述画面。 | 模型能读到图片内容，而不是只回复“无法查看图片”。 | 客户端版本、模型是否支持视觉、文件大小。 |
| 图像生成 | 进入 Cherry Studio 的图片或绘图入口，选择图像生成模型，输入短提示词。 | 能返回图片结果，或显示可追踪的生成状态。 | 是否在图片入口、是否选择图像模型、令牌分组是否匹配。 |
| 长文本或文件 | 先用短文本成功后，再逐步增加上下文或文件。 | 客户端没有提前超时，模型回复完整。 | 超时时间、上下文长度、文件大小。 |
模型选择建议
| 用途 | 建议模型类型 | 提示 |
|---|---|---|
| 日常聊天 / 写作 | 轻量或通用聊天模型 | 优先低延迟、低成本。 |
| 代码理解 / 长文档 | 更强能力或更大上下文模型 | 注意上下文越长，成本可能越高。 |
| 图像理解 | 支持视觉输入的模型 | 确认客户端版本支持上传图片。 |
| 图像生成 | 图像生成模型 | 可能需要在 Cherry Studio 对应功能区选择，而不是普通聊天模型。 |
用量日志怎么对
Cherry Studio 里看到回复，只能说明客户端拿到了结果。再对一次 6星中转 用量日志，可以确认请求确实走的是 6星中转，而不是还在用旧提供商。
| 日志字段 | 应该看到什么 | 异常时说明什么 |
|---|---|---|
| 时间 | 和你发送“回复 OK”的时间接近。 | 没有对应记录时，可能仍在使用旧提供商。 |
| 模型 | 和 Cherry Studio 选中的模型 ID 一致。 | 不一致时，检查默认模型或会话模型是否选错。 |
| 状态码 | 成功请求通常是 200。 | 401 看令牌，403 看分组，404 看模型 ID 或路径。 |
| 消耗 | 聊天、图像、视频按各自模型计费。 | 高消耗任务建议单独令牌，避免误用。 |
进阶设置建议
| 设置项 | 建议 | 原因 |
|---|---|---|
| 超时时间 | 长文本或图像任务适当调高。 | 避免模型仍在生成时客户端提前断开。 |
| 流式输出 | 聊天模型建议开启，图像/视频按客户端功能要求选择。 | 不同任务类型的返回方式不同。 |
| 温度 / Top P | 新手先使用默认值。 | 先确认链路稳定，再调整生成风格。 |
| 默认模型 | 选一个便宜且响应快的模型。 | 日常误触或测试时成本更可控。 |
完成标准
| 检查项 | 应该看到什么 | 不满足时先看 |
|---|---|---|
| 提供商已保存 | 模型服务列表里能看到 6星中转，且类型是 OpenAI 兼容。 | 配置步骤 |
| Base URL 正确 | 填写 https://www.6xin.cc/v1，不要漏掉 /v1。 |
提供商设置页。 |
| 模型可选 | 能刷新模型列表，或手动添加模型 ID 后能选中。 | 令牌分组和模型广场。 |
| 短消息成功 | 新聊天发送“回复 OK”后能收到回复。 | 常见问题 |
| 6星中转 日志可对上 | 控制台用量日志出现刚才那次请求。 | 是否仍在使用旧提供商或旧模型。 |
配置异常后，先回到最小可用配置
Cherry Studio 里连续改提供商、模型、令牌和功能入口，很容易越改越乱。遇到问题时先退回下面这组最小配置，确认聊天链路稳定后再加图像、长文本或多个模型。
| 刚才改了什么 | 先退回到什么状态 | 回退后怎么确认 |
|---|---|---|
| 提供商类型 | 只保留一个 6星中转 提供商，类型选择 OpenAI / OpenAI Compatible / 自定义 OpenAI。 | 提供商列表里只启用这一条 6星中转 配置，避免会话走到旧提供商。 |
| Base URL | 退回 https://www.6xin.cc/v1，不要填 Claude Code 的根地址。 |
点 Check 或刷新模型列表，如果仍失败，再用本页 curl 预检对照。 |
| API Key | 换回刚刚通过 /v1/models 验证的 6星中转 令牌。 |
401 消失，模型列表能返回；截图时只保留脱敏片段。 |
| 模型列表 | 先只手动添加一个当前令牌可见的聊天模型。 | 新聊天选择该模型，发送“回复 OK”能返回文本。 |
| 图像或长文本功能 | 先关闭复杂功能，只做普通短聊天。 | 短聊天和 6星中转 用量日志都对上后，再分别测试图像理解、图像生成或长文本。 |
常见问题
测试模型时报 401
重新复制 6星中转 令牌，确认没有空格、换行，也没有把 Bearer 一起粘进 API Key 输入框。
模型列表为空
先用 /v1/models 测试令牌是否可用；如果接口能返回，检查 Cherry Studio 的提供商类型是否选择 OpenAI 兼容。仍然为空时，手动添加模型 ID。
聊天时报 403
令牌分组无法访问当前模型。换一个同分组可用模型，或创建匹配分组的新令牌。
图像或视频功能不可用
先确认所选模型本身支持对应能力，再确认客户端使用的是图像/视频入口，不是普通聊天入口。
为什么同一个模型在 API 里能用，Cherry Studio 里不能用？
客户端可能把请求发送到聊天接口、图像接口或其他入口。确认你选择的功能区和模型能力一致，并检查客户端请求日志里的路径。
截图给客服前要遮哪些信息？
遮住完整 API Key、令牌名称里包含的客户名或项目名，以及任何私人图片内容。可以保留 Base URL、模型 ID、错误码和发生时间。
怎么换备用域名？
在 Base URL 中把域名替换成控制台展示的备用域名，但保留 /v1 规则。
点 Check 通过，但聊天仍失败
Check 通常只证明 API Key 或模型列表可用。聊天失败还要看当前会话选择的模型、令牌分组、上下文长度和功能入口。
Cherry Studio 仍然不通时，提交这些定位信息
Cherry Studio 的问题要分清“提供商保存成功”“模型列表能拉取”和“当前聊天/图像功能真的走到 6星中转”。提交问题前，先把下面信息整理好。
| 信息 | 建议内容 | 不要提供什么 |
|---|---|---|
| 提供商配置 | 提供商名称、类型是否为 OpenAI 兼容、Base URL 是否为 https://www.6xin.cc/v1。 |
不要截图完整 API Key。 |
| 模型列表结果 | 能否刷新模型列表，目标模型 ID 是否来自 6星中转 模型广场或 /v1/models。 |
不要只说“模型没有”。 |
| 功能入口 | 失败的是聊天、图像生成、图像编辑还是视频任务。 | 不要把不同功能的报错混在一起。 |
| 错误和日志 | 错误码、报错摘要、发生时间，以及 6星中转 用量日志是否有对应记录。 | 不要提交私人图片、完整 prompt 或客户数据。 |
| 令牌片段 | 令牌用途、分组名称和脱敏片段，例如 sk-前6位...后4位。 |
不要贴完整令牌。 |
如果聊天可用但图像或视频失败，继续看 图像与视频教程；如果是 401、403、404、429 或 5xx，按 FAQ 错误码速查 分流。