三分钟上手

书童提供 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 URLhttps://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:在工具中使用

3调用没有成功?

状态码原因处理
401API Key 无效或已停用检查是否完整复制了 sk-gw-…,或在控制台新建一个
402账户余额不足联系我们充值
404模型 ID 写错用上面的模型列表接口核对 model
503该模型暂不可用换用其他模型,或稍后再试

完整列表见 错误码。

继续探索