接入软件
OpenAI / Anthropic SDK
用官方 SDK 写代码调用:只改地址和 Key。
约 8 分钟适合:要在自己的代码里调用模型的开发者
开始之前
- Python 3 或 Node.js 环境
- 一把 Key,放进环境变量,不要写进代码
步骤 1 · STEP 0x01
安装并设置 Key
terminal
$ pip install openai anthropic$ npm install openai @anthropic-ai/sdk$ export API_KEY=<你的 Key>
完整 Key 只在创建时显示一次,关闭页面就看不到了。没来得及保存?吊销它,再创建一把新的。
步骤 2 · STEP 0x02
OpenAI SDK:Python
python
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.suanlimao.shop/v1", api_key=os.environ["API_KEY"])
resp = client.chat.completions.create(
model="<模型名>",
messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)terminal
$ python demo.pyHello! How can I help you today?
接入地址写
https://api.suanlimao.shop/v1(带 /v1)。如果软件提示 404,先检查有没有多写或少写 /v1,再看下面的常见问题。模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。
步骤 3 · STEP 0x03
OpenAI SDK:Node.js(流式)
javascript
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.suanlimao.shop/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "<模型名>",
messages: [{ role: "user", content: "Hello" }],
stream: true,
});
for await (const chunk of stream) process.stdout.write(chunk.choices[0]?.delta?.content ?? "");terminal
$ node demo.mjsHello! How can I help you today?
流式输出时最后一个数据块带 usage,随后是 data: [DONE]。长时间没有输出时服务端会发 : ping 注释行保持连接,SDK 会自动忽略。
步骤 4 · STEP 0x04
Anthropic SDK(Claude 模型)
python
import os
import anthropic
client = anthropic.Anthropic(base_url="https://api.suanlimao.shop", api_key=os.environ["API_KEY"])
msg = client.messages.create(
model="<模型名>",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content[0].text)terminal
$ python claude_demo.pyHello! …
Anthropic SDK 的
base_url 填不带 /v1 的根地址 https://api.suanlimao.shop,SDK 会自己加路径。OpenAI SDK 才带 /v1。步骤 5 · STEP 0x05
不改代码:用环境变量
terminal
$ export OPENAI_BASE_URL=https://api.suanlimao.shop/v1$ export OPENAI_API_KEY=<你的 Key>$ python your_existing_script.py
OpenAI 官方 SDK 会读取
OPENAI_BASE_URL 和 OPENAI_API_KEY,已有的脚本不用改代码就能走我们的地址。把模型名改成模型广场里的名字即可。✓ 怎么确认成功了
- 脚本能打印出回答;控制台「用量」页出现请求。
常见问题
返回 404?
OpenAI SDK 的地址要带 /v1,Anthropic SDK 不带。其次检查模型名。
返回 429?
触发了限速或 Key 预算。按响应头里的 Retry-After 等待,并做指数退避重试。
超时怎么办?
长文本和推理模型耗时更长,把 SDK 的超时调大(例如几分钟),流式输出能更早看到内容。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。