▪ migration
从 OpenAI 迁移
保留现有 SDK 和业务流程。多数情况下只需要替换 Base URL、API Key,并从模型目录选择型号。
需要改什么
- 将 Base URL 改为
https://api.11book.ai/v1。 - 在 11book 创建新的 API Key,不要复用其他服务商的密钥。
- 从模型目录复制完整模型 ID。
- 在最小验证通过前,尽量保持请求体不变。
Python SDK
main.py
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["BOOK_API_KEY"],
base_url="https://api.11book.ai/v1",
)
resp = client.chat.completions.create(
model="YOUR_MODEL_ID",
messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)Node.js SDK
index.mjs
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.BOOK_API_KEY,
baseURL: "https://api.11book.ai/v1",
});
const response = await client.responses.create({
model: "YOUR_MODEL_ID",
input: "Introduce 11book in one sentence",
});
console.log(response.output_text);执行最小验证
先发起一个短请求,再到控制台核对响应、余额和使用记录。
终端
curl https://api.11book.ai/v1/chat/completions \
-H "Authorization: Bearer $BOOK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_ID",
"messages": [{"role": "user", "content": "Hello"}]
}'在 11book 请求验证通过前,请保留原服务商的配置。请求失败时不要让程序自动切换模型或服务商,以免排查和计费结果变得不可控。
回滚方式
- 暂停发布或关闭新的服务商配置。
- 从密钥管理服务恢复之前的 Base URL 和服务商 Key。
- 对照应用日志、11book 使用记录和失败请求后,再决定是否重试。