接入指南

给工程师的 runbook:六步,从零到把大模型接进你的系统。只想动嘴不想动手?去「体验」

1

注册账号并创建密钥

注册页用邮箱或手机号注册(送 $5 试用额度), 然后到 控制台 → API Keys 创建密钥。 密钥形如 sk-gw-...,只显示一次,请立即保存到安全位置(如密码管理器或环境变量),不要提交到代码仓库。

# 推荐:把密钥放进环境变量,避免硬编码
export SHUTONG_API_KEY="sk-gw-你的密钥"
2

用 curl 跑通第一次调用

验证密钥与网络连通性。任何能发 HTTP 请求的环境都可以:

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": "你好"}]}'
3

接入你的代码(OpenAI SDK 兼容)

本平台完全兼容 OpenAI Chat Completions 格式——已有项目只需改 base_url 一行。Python:

pip install openai

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://shutong.ai/api/v1",
    api_key=os.environ["SHUTONG_API_KEY"],
)
resp = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "总结这段文字…"}],
)
print(resp.choices[0].message.content)
4

Node.js 接入

同理,官方 openai 包直接可用:

npm install openai

import OpenAI from "openai";
const client = new OpenAI({
  baseURL: "https://shutong.ai/api/v1",
  apiKey: process.env.SHUTONG_API_KEY,
});
const resp = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
5

开启流式输出(推荐)

stream: true,首字节 1 秒内返回,用户体验大幅提升;用量信息在最后一个数据块中返回:

stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "写一段产品介绍"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="", flush=True)
6

处理错误与用量

关键错误码:401 密钥无效、402 余额不足、429 达到每日限额、502 上游异常(建议重试一次)。 完整列表见文档。 每次调用的 token 消耗与费用在控制台实时可查——按部门核算成本就靠它。