从注册到 API 调用,把常用工具一次接好
这里不是只放一个接口地址的“说明页”,而是把新用户最容易卡住的路径拆成教程: 如何创建令牌、选分组、接入命令行工具、配置图形客户端、验证接口、排查错误码。
开始前你需要准备什么
如果你是第一次打开教程中心,先确认下面几件事。准备不完整时也能阅读,但不要急着把令牌填进复杂工具或线上服务。
| 准备项 | 为什么需要 | 不确定时先看 |
|---|---|---|
| 能登录 6星中转 控制台 | 创建令牌、查看余额、复制模型 ID、核对用量都需要登录。 | 5 分钟快速开始 |
| 有一条用途清楚的测试令牌 | 先用测试令牌跑通基础链路,避免把正式服务令牌拿来排障。 | 创建前确认 |
| 知道目标模型属于哪个分组 | 分组不匹配会导致 403 或模型不可见,和工具是否安装成功无关。 | 模型分组 |
| 知道自己要接入的场景 | 命令行、图形客户端、n8n、图像视频和自写 API 的路径不同。 | 按目标选择路径 |
先回答 3 个问题
如果你不知道该从哪一页开始,不用先把整站读完。按下面三问定位自己的路径。
教程地图
5 分钟快速开始
注册、登录、准备额度、创建令牌、用一条 curl 验证是否能调用模型。
令牌与安全
从创建入口、命名规范、分组选择、复制后验证、安全保存到泄露轮换,完整管理每一条令牌。
模型分组
按 Claude、Codex、Gemini、图像、视频等场景选择分组,并从模型广场复制模型 ID。
图像与视频
按文生图、图像编辑、图片理解、视频生成拆开选模型、选入口和做验收。
工具接入总览
把 Claude Code、Codex CLI、Gemini CLI、Cherry Studio、Chatbox、NextChat、n8n、CC Switch 等入口放到同一张表里。
环境检查
手动配置命令行工具前,先确认终端、网络、Node、Homebrew、代理和环境变量。
CC Switch 使用教程
从一键导入到 Claude、Codex、Gemini 分页切换,再到 ccs 命令行管理。
开发者 API
从 API 总览进入,再按认证与令牌、聊天与 Messages、模型列表与可见性逐步接入。
进阶玩法
把服务端代理、多工具配置、令牌拆分、限流重试、日志用量和上线清单放到一张图里。
状态页与可用性
按状态颜色、真实请求和用量日志判断该查配置、降并发、换模型还是等待恢复。
更新与变更说明
模型、工具或接口变化时,先按影响级别判断,再做最小请求、用量日志和回退检查。
FAQ 与排障
先看最常见的地址、分组、模型 ID 三个误区,再按工具现象、错误码和余额账单逐项定位。
控制台入口速查
教程里反复提到“控制台、令牌、模型广场、用量日志”。如果你不确定该打开哪里,先按这张表走;被要求登录时,先完成登录再继续当前动作。
| 你要做什么 | 打开哪里 | 在页面里确认什么 | 继续看哪篇 |
|---|---|---|---|
| 注册或登录 | 注册页 或 登录页 | 右上角能看到自己的账号,能进入登录后的控制台页面。 | 5 分钟快速开始 |
| 充值、查看余额 | 充值与余额页 | 账号有可用余额;如果刚付款,保留订单号并等待到账。 | 完整步骤、余额账单 |
| 创建或管理 API 令牌 | 令牌管理 | 令牌名称、分组、状态都清楚;完整令牌只保存到安全位置。 | 令牌与安全 |
| 查模型 ID、价格和分组 | 模型广场 | 模型 ID 来自当前页面,不凭记忆手写;模型能力和令牌分组匹配。 | 模型分组 |
| 核对请求有没有进 6星中转 | 用量日志 | 能按时间点看到模型、状态、耗时或消耗记录。 | 状态页与最小验证、工单信息 |
| 仍然需要人工协助 | 工单系统 | 只提交时间、模型、错误码、脱敏令牌片段和截图,不提交完整密钥。 | 工单模板 |
CC Switch 专题路径
如果你主要是接 Claude Code、Codex CLI 或 Gemini CLI,建议按下面顺序看。先理解通用字段,再进入具体工具页,最后按完成标准验收。
1. 通用概念与配置
安装、Provider 字段、Base URL、令牌来源、切换原理和验证流程。
2. 切换 Claude Code
Claude 使用根地址 https://www.6xin.cc,重点是不要加 /v1。
3. 切换 Codex CLI
Codex 走 OpenAI 兼容协议,Base URL 使用 https://www.6xin.cc/v1。
4. 切换 Gemini CLI
优先使用 6星中转 一键导入结果,手动核对时保留根地址末尾斜杠。
5. ccs CLI 命令行版
服务器、脚本、备份迁移和无桌面环境里的 Provider 管理。
专题总览
回到总览页查看一键导入、手动 Provider 对照和三分钟排障流程。
按你的目标选择路径
| 你想做什么 | 建议阅读顺序 | 验收标准 |
|---|---|---|
| 我第一次使用 6星中转 | 快速开始 → 令牌与安全 → 模型分组 → FAQ | 能在控制台看到令牌,知道它属于哪个分组,并用 curl 收到模型回复。 |
| 我要出图、改图或生成视频 | 模型分组 → 图像与视频 → Cherry Studio / Chatbox / API 总览 | 能用对应模型返回图片、视频任务 ID,或查询到视频最终状态。 |
| 我要搭一个图形聊天入口 | 工具总览 → Cherry Studio / Chatbox / NextChat → FAQ | 能按字段填好地址、令牌、模型和部署变量;短对话进入 6星中转 用量日志,密钥没有暴露到截图或前端代码。 |
| 我要做自动化工作流 | 快速开始 → n8n 工作流 → API 认证 → 聊天与 Messages → 进阶玩法 | HTTP Request 节点能跑通,Webhook、专用令牌、凭据、错误分支、限流和日志都有检查点。 |
| 我要接 Claude Code / Codex CLI / Gemini CLI | 工具总览 → 环境检查 → CC Switch 总览 → 通用配置 → 对应工具页 | 终端工具能发起一次真实对话,请求地址没有多写或少写 /v1。 |
| 我要给自己的程序接 API | 令牌与安全 → API 认证与令牌 → 聊天与 Messages → 模型列表与可见性 → 进阶玩法 | 服务端使用正确 Header 调用,不在前端暴露完整密钥,并用真实生成验证模型可用。 |
| 我已经跑通基础调用,想接入项目或团队流程 | API 总览 → API 认证 → 模型列表与可见性 → 进阶玩法 → 状态页与可用性 | 令牌按环境或项目隔离,失败处理、用量核对和上线前检查都有记录。 |
| 我遇到报错 | FAQ → API 认证与令牌 → 模型列表与可见性 → 状态页与可用性 | 能判断是令牌、分组、模型名、限流、余额还是上游临时异常。 |
| 我感觉模型变慢、5xx 变多或同类任务连续失败 | 状态页与可用性 → FAQ → 模型分组 | 能判断是平台波动、模型分组问题、本地网络问题还是请求参数问题。 |
接口地址速查
/v1,Codex CLI 在 6星中转 的一键导入里也会使用 /v1。
| 场景 | 填写地址 | 说明 |
|---|---|---|
| OpenAI 兼容 SDK / Cherry Studio | https://www.6xin.cc/v1 |
聊天补全、模型列表、图像等通用接口。 |
| 图像 / 视频 API | https://www.6xin.cc/v1 |
文生图、图像编辑和视频任务都用 /v1,但要换成对应能力的模型。 |
| Claude Code / Anthropic Messages | https://www.6xin.cc |
不要手动加 /v1,客户端会拼接 /v1/messages。 |
| Gemini CLI | https://www.6xin.cc/ |
优先使用 CC Switch 导入;手动配置时先确认当前版本支持自定义端点,并保留末尾斜杠。 |
| OpenAI 兼容备用域名 | 控制台展示的备用域名,保留 /v1 |
主域名网络不稳定时,OpenAI 兼容工具仍然保留 /v1。 |
| Claude Code 备用域名 | 控制台展示的备用根地址,不加 /v1 |
只替换域名,不要因为换备用域名就补上 /v1。 |
只想先测一下?用这条最小请求
如果你已经有 6星中转 令牌和一个聊天模型 ID,可以先用下面的请求确认基础链路。第一次完整配置仍建议看 5 分钟快速开始,服务端接入继续看 开发者 API 总览。
export COMEU_API_KEY="sk-你的令牌"
curl "https://www.6xin.cc/v1/chat/completions" \
-H "Authorization: Bearer $COMEU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "从模型广场复制的模型ID",
"messages": [
{"role": "user", "content": "回复 OK"}
],
"max_tokens": 16
}'
本教程会覆盖什么
步骤级说明
不是只告诉你“填 Base URL”,而是说明从哪个页面进入、点哪里、选什么、如何确认成功。
错误码和排障
把工具连不上、配置没生效、401、403、404、429、5xx、余额不足、模型分组不匹配这些常见情况放到速查表里。
工具差异
Claude Code、Codex CLI、Gemini CLI、Cherry Studio、Chatbox、NextChat、n8n、CC Switch 对地址和认证字段的要求不同,会分开写。
安全边界
所有示例只使用占位令牌,不展示真实密钥;前端应用也不应直接暴露用户完整 API Key。
找不到想要的?
| 你现在卡在哪里 | 先看这里 | 准备哪些信息 |
|---|---|---|
| 不知道令牌、模型分组、模型 ID 分别是什么 | 令牌与安全、模型分组 | 你要使用的工具、目标模型、当前令牌用途。 |
| 工具报错,但不知道是地址还是模型问题 | FAQ 与排障、工具接入总览 | 工具名称、Base URL、模型 ID、错误码或截图。 |
| 某个模型突然变慢或连续失败 | 状态页与可用性 | 发生时间、模型 ID、分组、错误码、是否能复现。 |
| 看到公告或模型变化,不确定要不要改配置 | 更新与变更说明 | 变更类型、影响工具、旧模型 ID、新模型 ID、最小请求结果。 |
| 准备把 6星中转 接入自己的服务 | 开发者 API、进阶玩法 | 服务端语言、调用接口、并发量、超时和重试策略。 |
| 需要提交工单或让客服协助 | 提交工单信息 | 不要提供完整令牌;只给时间、模型、错误码、脱敏令牌片段。 |
读完入门路径后,应该达到什么状态
教程中心不是要求你一次读完所有页面。只要完成和自己场景相关的路径,就应该能留下可验证的结果。
| 完成状态 | 你应该能证明什么 | 证明方式 |
|---|---|---|
| 基础链路已通 | 账号、余额、令牌、分组和至少一个模型可用。 | 短请求返回模型回复,并能在用量日志按时间点看到记录。 |
| 工具配置已生效 | 目标工具正在读取 6星中转 地址、令牌和模型,而不是旧配置。 | 重开工具后完成一次短问答、图像任务或工作流执行。 |
| 密钥边界清楚 | 完整令牌没有出现在截图、前端代码、Git、公开日志或工单里。 | 只在工具配置、环境变量、Secret 或密码管理器里保存完整令牌。 |
| 遇到错误知道先查哪里 | 能按地址、令牌、分组、模型 ID、余额、状态页的顺序定位。 | 使用 FAQ 1 分钟分流,再进入对应工具页。 |