三分钟上手
书童提供 OpenAI 兼容的统一接口:一个 API Key、一个 Base URL,即可调用 DeepSeek、Qwen、Kimi、豆包、Claude、GPT、Gemini 等模型,按实际用量以人民币计费。
1获取 API Key
注册账号(赠送 ¥30 试用额度),然后在 控制台 → API Keys 创建密钥。密钥形如 sk-gw-…,只在创建时显示一次,请保存到密码管理器或环境变量,不要写进代码仓库。
export SHUTONG_API_KEY="sk-gw-你的密钥"
2选择接入方式
路径 A:在代码中调用
已有 OpenAI SDK 的项目,只需要改 Base URL 和 API Key:
| Base URL | https://shutong.ai/api/v1 |
| 鉴权 | Authorization: Bearer sk-gw-… |
| 协议 | OpenAI Chat Completions 兼容 |
| 推荐首个模型 | deepseek-chat(价格低、速度快);全部模型见 模型市场 |
先检查 Key 是否可用:能列出模型就说明 Key 和网络都没问题。
curl https://shutong.ai/api/v1/models \ -H "Authorization: Bearer $SHUTONG_API_KEY"
发出第一次请求:
curl https://shutong.ai/api/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $SHUTONG_API_KEY" \
-d '{
"model": "deepseek-chat",
"messages": [{"role": "user", "content": "你好,用一句话介绍你自己"}]
}'Python 需要 pip install openai;Node.js 需要 npm install openai,并把代码保存为 .mjs 文件运行。
路径 B:在工具中使用
Claude Code设置两个环境变量,让 Claude Code 的调用经书童鉴权与计费。Codex为 OpenAI Codex CLI 添加书童服务商,用 codex-st 启动。命令行 shutong在终端里选模型、对话,默认开启平台记忆。
3调用没有成功?
| 状态码 | 原因 | 处理 |
|---|---|---|
401 | API Key 无效或已停用 | 检查是否完整复制了 sk-gw-…,或在控制台新建一个 |
402 | 账户余额不足 | 联系我们充值 |
404 | 模型 ID 写错 | 用上面的模型列表接口核对 model |
503 | 该模型暂不可用 | 换用其他模型,或稍后再试 |
完整列表见 错误码。