▪ 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 和路径,按客户端自己的字段约定填写。
以具体模型为准的能力
- 上下文长度、工具调用、结构化输出和推理行为。
- 图像、音频、文件等多模态输入。
- 流式行为、限流规则和按次计费模式。
协议兼容不代表每个模型都支持所有参数。请从模型目录复制完整模型 ID,并在生产调用前确认端点支持。
不要默认依赖的能力
不要把服务商专属端点、未公开参数、静默替换模型或自动降级当成默认行为。如果某项能力对业务很重要,请用目标模型实际验证,并保留可控的回退方案。