11book / docs

文档中心

从第一次调用到生产排错,按场景找到可直接复制的配置。

文档目录 · 从 OpenAI 迁移

▪ 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"}]
  }'

回滚方式

  1. 暂停发布或关闭新的服务商配置。
  2. 从密钥管理服务恢复之前的 Base URL 和服务商 Key。
  3. 对照应用日志、11book 使用记录和失败请求后,再决定是否重试。
The Final Page

万万不可

wan wan bu ke · never, ever

用户怕什么,我们万万不可什么。这是我们的承诺,也是名字里「万万」的意思。

01万万不可静默降级
02万万不可泄漏密钥
03万万不可糊涂收费
04万万不可暗改价格
05万万不可让额度过期
06万万不可跑路失联
BASE URLhttps://api.11book.ai/v1