▪ api integration
API 集成
沿用熟悉的 OpenAI SDK,通过统一端点调用多家模型。支持 Chat Completions 与 Responses,具体参数和流式能力取决于所选模型。
认证
每个请求通过 Authorization 头携带 API Key(在控制台创建):
终端
export BOOK_API_KEY="sk-xxxx" # console → API KeysChat Completions
端点:https://api.11book.ai/v1/chat/completions,参数与兼容协议保持一致(model / messages / temperature / tools 等):
终端
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"}]
}'Responses API
端点:https://api.11book.ai/v1/responses,Codex CLI 与新一代 Agent 默认协议:
终端
curl https://api.11book.ai/v1/responses \
-H "Authorization: Bearer $BOOK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_ID",
"input": "Write a one-line poem about autumn"
}'JavaScript / Node.js
官方 Node SDK 同样只需要替换 baseURL。请把密钥放在环境变量中,不要提交到代码仓库:
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);流式输出
对支持流式输出的模型,传 "stream": true 可接收 SSE 事件流:
终端
curl https://api.11book.ai/v1/chat/completions \
-H "Authorization: Bearer $BOOK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_ID",
"stream": true,
"messages": [{"role": "user", "content": "Hello"}]
}'Python SDK 中以 stream 迭代:
main.py
stream = client.chat.completions.create(
model="YOUR_MODEL_ID",
stream=True,
messages=[{"role": "user", "content": "Hello"}],
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")错误处理
HTTP 状态码遵循兼容协议的常见语义,message 字段给出可直接展示的原因:
| 状态 | 含义 | 处理建议 |
|---|---|---|
| 401 | 无效或停用的 API Key | 检查 Key 与环境变量;控制台重新生成 |
| 429 | 限流 | 指数退避重试;避免突发并发 |
| insufficient_quota | 余额不足 | 前往 余额充值充值或使用兑换码 |
| 5xx | 上游链路异常 | 对可恢复错误做有限次退避重试;持续失败请联系支持 |
计费与账单
- 按 USD / 1M Tokens 计量,输入与输出分开计价。
- 价格表展示实付单价,无需自行换算折扣或倍率。 缓存读取、长上下文、多模态及按次计费请查看对应规则。
- 同一账户下所有 Key 共享美元余额;账单逐条可在用量统计审计。
兼容 OpenAI 协议的第三方客户端(Cursor、Cline、Cherry Studio、ChatBox 等)同样只需替换 Base URL 与 API Key。