开放 API
开放 API 让你把智能客服能力嵌入自己的 App、网站或内网系统，灵活度最高。
适用场景
- 在自研产品里接入智能问答。
- 把 AI 回答能力编排进已有业务流程。
- 需要完全自定义前端交互的场景。
创建并管理密钥
进入 外部拓展 → API 设置，新建密钥时配置：
- 密钥名称：如「生产环境 H5 接入」。
- 速率限制（QPM，次/分钟）：可在套餐上限内设置。
- 有效期：留空表示永久有效。
- 密钥状态：可启用 / 停用。
密钥（
sk-开头）等同账号凭据，泄露会被盗用消耗额度。切勿写进前端代码或公开仓库，应放在你自己的后端代为调用。
套餐限制
| 套餐 | 密钥数量 | 速率上限 |
|---|---|---|
| 基础版 | 1 | 30 次/分钟 |
| 专业版 | 10 | 200 次/分钟 |
| 旗舰版 | 100 | 1000 次/分钟 |
关键词转人工（专业版及以上）
每个密钥可单独开启「关键词转人工」：用户消息命中触发词时，创建 / 续接人工会话并推送到指定群 Webhook，不再调用大模型。触发词与群 Webhook 与「企业微信接入的人工客服转接」一致；不选具体配置则匹配全部已开启转人工的配置。
调用方式
平台采用与 OpenAI 兼容的调用风格：请求中携带密钥、指定智能体并发送用户问题即可获得回答。智能体若已绑定技能，对话会按需调用汇率、HS 编码等工具（收费技能按 N 技能点/次 出站扣点）。
接口文档地址：https://agent.likelic.com/doc/v1/
文档中包含完整的请求路径、参数说明、鉴权方式与示例（含 AI 对话、人工轮询、知识库写入、服务绩效议题同步 等），请以线上文档为准。
细粒度权限（系统设置）
可在 系统设置 → 开放 API 权限 按能力类（AI 会话 / 知识库写入 / 服务绩效议题 / 合作客商写入 / 推送通知 / MCP 接入）分别启用，并多选允许调用的 API Key。该配置约束 /api/v1/* 开放 API 与 /mcp MCP 服务的调用。
- MCP 接入：允许该 Key 经 MCP 服务调用工具；各工具的开关在 MCP管理 中按 Key 设置。
- 删除 API Key：系统自动把该 Key 从全部能力类（含 MCP 接入）的授权列表中移出，并清除它在 MCP管理 中的工具开关；之后新建的 Key 不继承这些授权。
- 停用 API Key：该 Key 已开启的写入类工具（「新增知识」「推送通知」）会被自动关闭，重新启用后不自动恢复，需到 MCP管理 重新开启。
网页组件走 widget_token 独立通道，不在上述白名单管控范围内；组件关联的 Key 无需加入白名单即可供访客正常使用。