ZZHIMO 智模引擎
ZHIMO ENGINE

智模引擎 API 文档

这里整理智模引擎常用 API 接入信息,适合开发者、Dify 用户、n8n 自动化用户和 AI 工具站快速完成 OpenAI Compatible API 接入。

统一入口

一个 Base URL 调用多种模型,减少多平台接入和切换成本。

OpenAI 兼容

大多数支持 OpenAI Compatible 的 SDK 和工具都可以直接配置。

日志可查

控制台可查看请求状态、模型、消耗和错误信息。

Base URL

在 OpenAI SDK、Dify、n8n、Cherry Studio、LobeChat 等工具中,Base URL 一般填写:

https://bottoken.cc/v1

如果工具要求填写完整接口地址,Chat Completions 地址是:

https://bottoken.cc/v1/chat/completions

认证方式

所有请求都需要带上 API Key。请求头格式如下:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
不要把平台登录密码、Telegram 登录信息或上游平台 Key 当作智模引擎 API Key。

Chat Completions 示例

curl https://bottoken.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好,测试接口"}
    ],
    "stream": false
  }'

流式输出

如果你的客户端支持流式响应,可以在请求体里设置 stream: true。流式输出适合聊天、长文本生成和需要实时展示内容的场景。

{
  "model": "gpt-4o",
  "messages": [{"role":"user","content":"写一段介绍"}],
  "stream": true
}

常见错误码

状态码说明处理建议
400请求体格式错误或参数缺失检查 JSON、model、messages。
401API Key 无效或请求头错误检查 Authorization Bearer 格式。
402余额不足或预扣费失败充值或降低模型消耗。
404模型名或路径错误确认模型名和接口地址。
429限流或并发过高降低并发并增加重试间隔。
502/503/504上游异常或网关超时稍后重试或切换模型。

完整排查见 API 报错解决中心

Dify、n8n 与其他客户端

Dify 用户可参考 Dify 接入教程,n8n 用户可参考 n8n 接入教程。如果你使用的是 OpenAI SDK,通常只需要改 base_urlapi_keymodel

相关页面

常见问题