注册账号，获取 API Key
注册胜算云账号后，在控制台创建你的专属 API Key。这是所有调用的唯一凭证，拿到 Key 就能往下走。
访问 胜算云控制台，手机号或微信扫码即可完成注册。
进入控制台「API 密钥」模块，创建并复制你的专属 Key。请妥善保管，避免泄露。
在控制台完成充值，即可开始调用 API。
新用户福利：滑到底部加入开发者飞书交流群，查看置顶公告可领取 10 元模力福利卷。
一键接入编程工具
拿到 Key 后最快的上手方式：用 CC-Switch 一键配置，无需手动编辑配置文件，30 秒接入 Claude Code / Codex / OpenCode 等编程工具。
https://github.com/farion1231/cc-switch/releases CC-Switch GitHub 仓库 →
CC-Switch 选 Anthropic Messages 原生格式，勾选"写入通用配置"。配置文档 →
CC-Switch 选 OpenAI 兼容格式，绝对不要手动切换模型！配置文档 →
CC-Switch 一键配置，勾选"写入通用配置"。配置文档 →
胜算云联合开发的 VS Code 编码代理，全流程中文交互。VS Code 插件指南 →
先验证 Key，再调 API
开发者接入应用前，先验证 Key 是否可用。复制这条请求，替换 API Key，确认账号和入口正常。
curl https://router.shengsuanyun.com/api/v1/models \ -H "Authorization: Bearer YOUR_API_KEY"
返回模型列表 JSON，说明 Key 和入口都正常。接下来可以直接发第一条请求。
发送第一条请求
不用先选一堆参数，先用默认模型拿到第一个成功响应。
curl https://router.shengsuanyun.com/api/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek/deepseek-v4-flash",
"messages": [
{ "role": "user", "content": "请用一句话介绍你自己。" }
]
}'
返回 choices.message.content，说明第一次调用已经成功。
响应示例
第一次调用的目标是先看到结构正确、可继续接入的响应。
{
"id": "chatcmpl-xxx",
"object": "chat.completion",
"model": "deepseek/deepseek-v4-flash",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好，我是一个可以帮助你完成开发与问答任务的 AI 助手。"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 18,
"total_tokens": 30
}
}
OpenAI SDK，只改两行
如果你已经在用 OpenAI SDK，保留原来的调用方式，改 API Key 和 base_url 就能迁移。
api_key 改成你的胜算云 Key；base_url 改成 https://router.shengsuanyun.com/api/v1。其他代码不动。
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://router.shengsuanyun.com/api/v1"
)
resp = client.chat.completions.create(
model="deepseek/deepseek-v4-flash",
messages=[
{"role": "user", "content": "请用一句话介绍你自己。"}
]
)
print(resp.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "YOUR_API_KEY",
baseURL: "https://router.shengsuanyun.com/api/v1"
});
const resp = await client.chat.completions.create({
model: "deepseek/deepseek-v4-flash",
messages: [{ role: "user", content: "请用一句话介绍你自己。" }]
});
console.log(resp.choices[0].message.content);
第一次调用失败，先看这里
大部分首调失败都不是代码问题，而是 Key、URL、模型名或请求格式问题。
| 返回状态 | 最常见原因 | 优先检查 |
|---|---|---|
| 401 | API Key 无效 | Authorization: Bearer YOUR_API_KEY 是否正确 |
| 404 | 路径或 Base URL 错误 | 是否使用了正确的 /api/v1 入口 |
| 400 | 请求体格式错误 | model、messages、JSON 格式是否正确 |
| 429 | 频率或额度限制 | 账户额度、并发限制、短时间重试频率 |
| 5xx | 服务端暂时异常 | 稍后重试，并记录请求 ID 联系支持 |
如果你能成功访问 /models，但 chat/completions 失败，优先检查模型名和请求体格式。