11book / docs

文档中心

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

文档目录 · API 集成

▪ api integration

API 集成

沿用熟悉的 OpenAI SDK,通过统一端点调用多家模型。支持 Chat Completions 与 Responses,具体参数和流式能力取决于所选模型。

认证

每个请求通过 Authorization 头携带 API Key(在控制台创建):

终端
export BOOK_API_KEY="sk-xxxx"  # console → API Keys

Chat 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 共享美元余额;账单逐条可在用量统计审计。
The Final Page

万万不可

wan wan bu ke · never, ever

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

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