从第一把密钥，
到第一次调用。
准备账户与额度，选好模型，把同频API接入你的工具。
这份教程从最常用的步骤开始，带你完成一次完整接入。
快速上手
先准备好账户、密钥和额度，再发起第一条请求。
- 01
注册并登录
使用本站账号进入控制台。先在模型广场了解要用的模型、可用分组和接口类型。
注册账号 已有账号，去登录 - 02
创建 API 密钥
在 API 密钥页点击“创建 API 密钥”，填写名称、分组和额度。余额不足时，在钱包充值与兑换。
创建密钥 - 03
完成一次调用
用 Playground 体验，或配置自己的客户端。先发一条简短消息，确认连接与模型选择正确。
打开 Playground
首次调用前检查：账户有可用额度，密钥已启用，所选模型属于该密钥的可用分组。密钥的“无限配额”仍受钱包余额或订阅额度约束。
充值与兑换
在店铺购买充值码，再回本站钱包兑换到账。
打开本站充值店铺，按需要选择商品。支付后，从店铺订单中领取充值码，再回到你要充值的同频API账号。
- 进入钱包，确认当前登录的是需要充值的账号。
- 找到“有兑换码吗？”区域，将充值码完整粘贴到“输入您的兑换码”中。
- 点击“兑换”，看到兑换成功提示后，核对页面上方的当前余额。
付款不会自动增加本站余额。需要完成钱包兑换。页面中的 $ 是站内记账单位；充值到账额度以商品与钱包说明为准，不代表人民币与美元的实际汇率。
密钥、模型与分组
模型名决定调用谁，分组决定可用范围与对应价格。
模型名称要完整复制
客户端里的模型名应与目录中的名称完全一致。云信不同档位使用不同前缀，填写时保留 yx-a/、yx-b/ 或 yx-s/，不要自行删去或替换。
模型名称相似，并不表示接口类型相同。图片、视频、语音、embedding 和 rerank 模型使用各自对应的接口。聊天客户端的模型栏应选择兼容的聊天模型。
密钥额度与账户余额是两回事
密钥额度用于限制这把密钥的用量；账户钱包或订阅提供实际可用额度。启用“无限配额”代表这把密钥不单独设额度上限，调用仍需要账户有可用额度。
只把密钥填写到你信任的应用中。排查问题时可以提供错误提示与请求时间，无需发送完整密钥或密码。
用 CC Switch 接入
从选中的密钥直接导入 Claude、Codex 或 Gemini 配置。
先在自己的设备上安装 CC Switch。登录同频API后，进入 API 密钥页，在要使用的密钥行打开更多菜单，选择 CC Switch。
- 在“填入 CC Switch”弹窗中选择应用，并填写便于识别的配置名称。
- 等待这把密钥的可用聊天模型加载完成，选择主模型。
- 点击“打开 CC Switch”，按浏览器提示打开应用，再在 CC Switch 中检查导入的配置。
Claude 配置
选择支持 Anthropic Messages 的模型
选择应用 Claude，主模型必选。Haiku、Sonnet、Opus 的模型映射可以按需设置，不需要全部填写。
https://tongpin-ai.com- 先在模型广场确认模型支持 Anthropic 接口。
- 可选映射也要选择这把密钥有权使用的模型。
- 切换应用会清空原模型选择，请重新核对。
Codex 配置
选择支持 Responses 的模型
选择应用 Codex，为配置命名，再选择主模型。导入时会为地址添加 /v1。
https://tongpin-ai.com/v1- 先确认模型支持客户端所用的 Responses 接口。
- 导入后保留完整模型名，包括已有的档位前缀。
- 地址中保留一个 /v1 即可，避免重复添加。
Gemini 配置
选择支持 Gemini 原生接口的模型
选择应用 Gemini，为配置命名并选择主模型。这里使用接口根地址，由客户端构建具体请求路径。
https://tongpin-ai.com- 在模型广场核对 Gemini GenerateContent 支持情况。
- 模型名包含“Gemini”不代表任意协议均可使用。
- 导入后先用简短请求确认配置。
按钮灰色时，先等待加载并选择主模型。出现“加载模型失败”或“未找到模型”时，检查密钥状态、分组与模型限制，再关闭弹窗重新打开。导入会把所选密钥交给本机 CC Switch，请在自己的设备确认。
手动配置接口地址
不使用 CC Switch 时，也可以直接填写客户端配置。
准备三项信息：Base URL、本站 API Key、完整模型名。API Key 从密钥页复制；模型名从模型广场或这把密钥的可用目录中选取。
Codex / OpenAI SDK
https://tongpin-ai.com/v1用于客户端 Base URL。具体使用 Chat Completions 或 Responses，取决于模型支持的接口。
Claude / Anthropic SDK
https://tongpin-ai.com填写根地址。客户端使用 Anthropic Messages 时，会请求对应的 /v1/messages 路径。
CC Switch 中的 Gemini
https://tongpin-ai.com使用 Gemini 原生接口时填写根地址。其他客户端请核对其自定义地址字段及路径补全方式。
Base URL 与完整请求地址不同。部分客户端会自动添加 /v1 或具体路径，请根据字段说明填写，避免出现 /v1/v1。不要把完整的 /v1/chat/completions 当作所有客户端的 Base URL。
| 接口类型 | 实际请求路径 | 先确认 |
|---|---|---|
| Chat Completions | /v1/chat/completions | 模型支持 OpenAI Chat 接口 |
| Responses | /v1/responses | 模型支持 Responses 接口 |
| Anthropic Messages | /v1/messages | 模型支持 Anthropic 接口 |
| Gemini GenerateContent | /v1beta/models/{完整模型名}:generateContent | 模型支持 Gemini 原生接口 |
第一次 API 调用
按支持的协议选择示例，替换密钥和模型两个占位符。
将 YOUR_API_KEY 换成你在本站复制的完整密钥，将 YOUR_MODEL 换成可用模型的完整名称。先在模型广场核对模型支持的接口；请求会产生对应的用量费用。
GPT-5.4 Pro 使用 Responses 接口。不要仅因为模型名称属于 GPT 系列，就改用 Chat Completions。下面的占位符不是可以直接调用的模型名或真实密钥。
Chat Completions 示例
OPENAI CHAT适用于支持 Chat Completions 的聊天模型。请求正文使用 messages。
curl 'https://tongpin-ai.com/v1/chat/completions' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "YOUR_MODEL",
"messages": [{"role": "user", "content": "用一句话打个招呼。"}],
"stream": false
}'Responses 示例
RESPONSES适用于支持 Responses 的模型，包括 GPT-5.4 Pro。请求正文使用 input。
curl 'https://tongpin-ai.com/v1/responses' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "YOUR_MODEL",
"input": "用一句话打个招呼。",
"stream": false
}'Anthropic Messages 示例
ANTHROPIC适用于支持 Anthropic Messages 的模型，使用 x-api-key 鉴权头。
curl 'https://tongpin-ai.com/v1/messages' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'anthropic-version: 2023-06-01' \
-H 'Content-Type: application/json' \
-d '{
"model": "YOUR_MODEL",
"max_tokens": 256,
"messages": [{"role": "user", "content": "用一句话打个招呼。"}],
"stream": false
}'以上 cURL 使用 Bash 的换行方式。Windows PowerShell 用户如改用 Python，需保持与所选模型一致的协议。下面仅演示 Responses，适用于支持 Responses 的模型。
Windows / macOS / Linux 通用：Python 标准库示例
此示例使用 Responses，无需安装第三方 Python 包。替换两个占位符后，保存为 first_request.py，在终端运行 python first_request.py（部分环境使用 python3 或 py）。
import json
import urllib.request
import urllib.error
api_key = "YOUR_API_KEY"
model = "YOUR_MODEL" # 填写支持 Responses 的完整模型名
payload = {
"model": model,
"input": "用一句话打个招呼。",
"stream": False,
}
request = urllib.request.Request(
"https://tongpin-ai.com/v1/responses",
data=json.dumps(payload).encode("utf-8"),
headers={
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json",
},
method="POST",
)
try:
with urllib.request.urlopen(request, timeout=120) as response:
print(response.read().decode("utf-8"))
except urllib.error.HTTPError as error:
print("HTTP", error.code)
print(error.read().decode("utf-8", errors="replace"))运行前确认账户额度和密钥权限。页面上的复制按钮只复制示例文字，不会替你发送请求。
查看使用日志
第一次请求后，回到控制台确认实际调用情况。
进入使用日志，按请求时间、模型等条件定位刚才的调用。日志可以帮助你了解请求、错误和计费信息；实际费用与所用模型、分组和用量有关。
- 先找到对应时间的请求核对模型名称与分组，确认客户端确实使用了你准备的配置。
- 再查看错误与用量信息失败时结合客户端的完整错误提示排查。需要客服协助时，保留请求时间与错误内容。
- 最后核对账户与密钥额度余额不足或密钥达到预算上限时，先处理额度，再重试请求。
常见问题
从报错内容出发，先检查最常见的配置项。
请求返回 401 / 403，应该怎么查？
先确认使用的是本站复制的完整密钥，前后没有空格，也没有把遮罩或示例占位符填进去；再检查密钥是否启用、是否过期、所选分组与模型是否匹配，以及是否设置了模型或 IP 限制。
401 / 403 的具体原因以返回的错误内容为准。仍无法解决时，向首页客服提供错误提示、请求时间与所用模型，无需提供完整密钥。
模型广场里有模型，CC Switch 中却找不到？
模型广场用于查看模型与分组信息；CC Switch 弹窗读取的是当前选中密钥的可用目录。检查密钥分组、模型限制和状态，修改后刷新页面并重新打开弹窗。
图片、视频、语音、embedding 和 rerank 等非聊天模型不会作为聊天模型导入。
CC Switch 的“打开”按钮是灰色的？
需要先成功加载模型目录，并选择主模型。如果出现“加载模型失败”或“未找到模型”，先检查密钥权限与分组，再关闭弹窗重新打开。切换应用或密钥后，需要重新选择模型。
点击“打开 CC Switch”后，没有启动应用？
确认本机已安装 CC Switch，并允许浏览器打开该应用的链接。如果浏览器拦截了打开应用的提示，可按浏览器界面允许；也可以参考本页手动配置地址部分，在客户端自行填写地址、密钥和兼容的模型。
密钥是“无限配额”，为什么还提示额度不足？
“无限配额”表示这把密钥没有单独的预算上限，不代表免费使用。请求仍需要钱包余额或订阅中有可用额度。有限额密钥还需要有足够的密钥剩余额度。
买了充值码，或者兑换后，余额没有变化怎么办？
支付后先到店铺订单中领取充值码，再到本站钱包点击“兑换”。完成购买本身不会自动入账。若已兑换，请确认兑换结果、当前登录账号和钱包余额。
兑换报错或订单中找不到充值码时，保留订单信息、兑换提示和操作时间，通过首页客服入口联系协助处理。
Base URL 到底要不要加 /v1？
本站导入配置中，Codex 使用 https://tongpin-ai.com/v1，Claude 与 Gemini 使用根地址 https://tongpin-ai.com。OpenAI SDK 的 Base URL 使用带 /v1 的地址，Anthropic SDK 使用根地址。
其他客户端可能自动补全路径，请核对客户端字段说明。出现 /v1/v1 或重复接口路径时，先修正地址。
模型能选中，但调用提示接口不支持？
先到模型广场核对该模型支持的端点。Chat Completions、Responses、Anthropic Messages 与 Gemini GenerateContent 的路径和请求正文不同，不能只改模型名称就混用。
例如 GPT-5.4 Pro 使用 Responses；CC Switch 三个应用共用聊天目录，仍需自行确认选中模型支持相应客户端的协议。
可以删除模型名中的 yx-a/、yx-b/、yx-s/ 吗？
请保留目录中的完整模型名。这些前缀区分不同档位，删掉或替换前缀可能导致模型不可用或与预期分组不匹配。模型名称与价格以当前模型广场及所选密钥可用目录为准。
常用入口与帮助
接入后，日常管理都可以从这里找到。
遇到问题，需要一起看一看？
首页提供当前客服联系方式。准备错误提示、请求时间与模型名，便于定位问题。
模型可用范围、分组和价格请以当前页面为准。模型已列出不代表它支持所有客户端、所有协议或全部功能；使用前查看对应的支持端点。