创建新账户
用户注册
响应结果
注意：API Key 只在注册时返回一次完整内容，请立即复制保存！
等待请求...
用户登录
账户登录
响应结果
等待请求...
修改密码
修改密码
等待...
API Key 管理
我的 API Keys
点击刷新加载...
创建新 Key
注意：完整 Key 只在此处显示一次，请立即复制！
等待...
MQTT 接入与订阅测试
申请 MQTT 接入
提交申请后等待管理员审核。审核通过后会为您分配 MQTT Client ID。
等待提交...
我的申请
点击刷新加载...
仅订阅测试
审核通过后可使用分配的 Client ID 连接并订阅主题；此页面不提供发布消息功能。
未连接
奔阳智能 AI · API 接入指南
0. 一句话极速接入 (推荐)
本平台的核心特色是提供了开箱即用的悬浮 AI 助手插件。任何第三方网站，只需在网页的 <body> 结束前引入以下一行 JavaScript 代码，便可立刻在页面右下角启用功能完备的智能客服与语音助手：
<!-- 复制并粘贴到您的网页中即可 -->
<script src="http://localhost/assistant.js" data-key="YOUR_API_KEY"></script>
提示：请将上面的 YOUR_API_KEY 替换为您在此控制台“API Key 管理”中创建的真实 Key。
1. 悬浮助手功能特性
- 一键引入：无需编写任何 HTML 结构和 CSS 样式，插件自动完成初始化和视觉元素注入。
- 跨设备适配：完美支持 PC 端和移动端，可自由拖拽、边缘自动贴边隐藏。
- 微信式语音对话：支持按住说话、录音波形图、滑动手势取消录音，并内置高精度语音转文字服务。
- 无缝会话存储：自动在后端为您存储历史对话列表和消息详情，跨页面切换也能无缝接续对话。
- 丰富文本渲染：内置 Markdown 引擎，支持代码高亮、列表、表格和卡片等高级排版。
2. 高级接口集成（自定义前端）
如果您不希望使用预置的悬浮助手，而是想要完全自行开发聊天界面，可以直接调用我们标准的 OpenAI 兼容业务接口：
| 接口路径 | 请求方法 | 鉴权请求头 | 功能说明 |
|---|---|---|---|
| /api/v1/chat/completions | POST | X-API-Key: YOUR_KEY |
智能对话（支持流式 SSE / 非流式） |
| /api/v1/chat/audio/transcriptions | POST | X-API-Key: YOUR_KEY |
语音转文字（STT，接收录音文件） |
| /api/v1/chat/sessions | GET / POST | X-API-Key: YOUR_KEY |
会话管理（查询列表、创建、删除等） |
非流式 (JSON)
流式 (SSE)
curl -X POST http://localhost/api/v1/chat/completions \
-H 'Content-Type: application/json' \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "user", "content": "你好，请问你是谁？"}
],
"stream": false
}'
3. 频控与错误处理
- 请求频率限制 (Rate Limits)：每个 API Key 的调用频率受您在创建 Key 时配置的“每分钟限制”和“每日限制”约束。
- 超限响应：如果请求超限，接口会返回 HTTP 429 状态码及
Rate Limit Exceeded错误。 - 未授权错误：如果 Header 中的
X-API-Key缺失或无效，接口将返回 HTTP 401 状态码。