11book / docs

文档中心

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

文档目录 · 兼容性与边界

▪ compatibility

兼容性与使用边界

沿用 OpenAI 兼容请求格式接入多家模型。具体端点、参数和能力请结合所选模型确认。

支持的接入方式

接入方式状态说明
Chat Completions支持/v1/chat/completions,流式能力以所选模型支持情况为准。
Responses API支持/v1/responses;切换协议前确认模型和客户端支持情况。
官方 SDK支持替换 Base URL 和 API Key,先保持 SDK 请求体不变。
OpenAI 兼容客户端通常支持Cursor、Cline、Cherry Studio 等需要兼容端点和完整模型 ID。
Codex CLI支持按Codex 配置文档填写,不要自行猜 TOML 字段。

Base URL 规则

严格使用示例中的 Base URL:https://api.11book.ai/v1。

  • Base URL 已经包含 /v1 时,不要再拼接一次。
  • 不要把 API Key 写进 Base URL、查询参数或前端构建产物。
  • 客户端如果分别要求 Base URL 和路径,按客户端自己的字段约定填写。

以具体模型为准的能力

  • 上下文长度、工具调用、结构化输出和推理行为。
  • 图像、音频、文件等多模态输入。
  • 流式行为、限流规则和按次计费模式。

不要默认依赖的能力

不要把服务商专属端点、未公开参数、静默替换模型或自动降级当成默认行为。如果某项能力对业务很重要,请用目标模型实际验证,并保留可控的回退方案。

The Final Page

万万不可

wan wan bu ke · never, ever

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

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