给工程师的 runbook:六步,从零到把大模型接进你的系统。只想动嘴不想动手?去「体验」
在注册页用邮箱或手机号注册(送 $5 试用额度), 然后到 控制台 → API Keys 创建密钥。 密钥形如 sk-gw-...,只显示一次,请立即保存到安全位置(如密码管理器或环境变量),不要提交到代码仓库。
# 推荐:把密钥放进环境变量,避免硬编码 export SHUTONG_API_KEY="sk-gw-你的密钥"
验证密钥与网络连通性。任何能发 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": "你好"}]}'本平台完全兼容 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)同理,官方 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);加 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)