Skip to content

开放 API

不墨 AI 助手提供兼容 OpenAI 接口规范的 API 服务,您可以轻松将其接入到各种支持 OpenAI 接口的工具和应用中。

基础信息

  • Base URL: https://chat.bumo.cc/v1
  • API Key: 在 API 密钥管理 页面获取
  • 默认模型: z-ai/glm-4.6

核心机制:模型选择

本平台采用独特的模型路由机制:通过 API Key 后缀来指定使用的模型

提示

在调用 API 时,请求体(Body)中的 model 参数将被忽略,系统仅根据 API Key 的后缀来决定调用哪个模型。

配置方式

  1. 使用默认模型: 直接使用原始 API Key,例如 sk-v7rtps7mqhv4srk

    系统将自动路由到默认模型 z-ai/glm-4.6

  2. 切换特定模型: 在 API Key 末尾添加 -模型名称

    格式:原始Key-模型名称

    示例:若您的 Key 为 sk-v7rtps7mqhv4srk,想使用 moonshot/kimi-k2,则填入的 Key 应为: sk-v7rtps7mqhv4srk-moonshot/kimi-k2

查看支持的模型

有关所有支持的模型列表及其价格,请参阅 API 产品页

代码接入示例

您可以使用任何标准的 OpenAI SDK 进行接入。

bash
curl -X POST "https://chat.bumo.cc/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "default",
    "messages": [
      {
        "role": "user",
        "content": "Hello!"
      }
    ],
    "stream": true
  }'

注意:将 YOUR_API_KEY 替换为您配置好后缀的 Key。

常用工具接入指南

1. Kilo Code 接入

  1. 打开 VSCode,进入 Kilo Code 插件设置。
  2. 点击 Use custom base URL
  3. 填写配置:
    • API Provider: 选择 OpenAI Compatible
    • Base URL: 输入 https://chat.bumo.cc/v1
    • API Key: 输入您的 Key(如需指定模型,请加上后缀)
    • Model ID: 任意填写(例如 default

2. Cline / Roo Code 接入

Cline 和 Roo Code 的配置方式与 Kilo Code 类似:

  1. 在配置界面选择 API ProviderOpenAI Compatible
  2. Base URL 填入 https://chat.bumo.cc/v1
  3. API Key 填入包含模型后缀的 Key。
  4. Model ID 任意填写(建议填入实际模型名作为备注)。

消耗控制与最佳实践

在使用 AI 辅助编程(特别是涉及大型代码库)时,Token 消耗可能会非常快。

预警

极端情况下,一个复杂问题可能会消耗数百万 Token。请务必关注 豆子钱包 的余额变动。

省钱建议

  1. 控制上下文:定期清除历史记录,避免每次对话都携带大量无关的历史代码。
  2. 精准提问:避免模糊的指令(如“帮我优化代码”),尽量指向具体的文件或函数。
  3. 使用折扣模型:不同模型的定价差异巨大,在非核心任务上使用高性价比模型。

常见问题

  • 401 Unauthorized 错误 请检查 API Key 是否正确,以及 Base URL 是否完整(必须包含 /v1)。

  • 模型未生效 请确认您是直接修改了 API Key 的后缀,而不是在客户端的 Model 字段中填写模型名称。

  • 插件显示的费用不准 Cline 等插件通常按 OpenAI 官方定价估算费用,无法识别本平台的折扣价格。实际消费请以本平台后台为准。

如遇其他问题,请联系我们