Dinox AI笔记API
Dinox 开放接口说明，包含语音创建笔记、文本创建笔记、笔记列表三个常用接口。
API 接口说明
Dinox 提供开放接口，方便你在自己的脚本或第三方应用里创建和读取笔记。本页介绍最常用的三个接口：语音创建笔记、文本创建笔记、笔记列表。
基础信息
- 基础域名：
https://aisdk.chatgo.pro - 路径前缀：
/api/openapi - 限流：每个 Token 每小时 200 次
认证方式
所有接口都需要在请求头中携带 Token：
Authorization: <你的Token>Token 获取方式：在 Dinox App → 设置 → 同步设置 → API Token 中获取。
请妥善保管 Token
Token 等同于你的账号凭证，请勿泄露或提交到公开仓库。
1. 语音创建笔记
上传一段音频，自动转录文字并创建为一条笔记。
接口地址
POST /api/openapi/voice/input请求参数（multipart/form-data）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| audio | File | 是 | 音频文件（支持 MP3、WAV、M4A、AAC 等） |
| duration | number | 否 | 音频时长（秒） |
请求示例
curl -X POST https://aisdk.chatgo.pro/api/openapi/voice/input \
-H "Authorization: <你的Token>" \
-F "audio=@recording.mp3"响应示例
{
"code": "000000",
"msg": "success",
"data": {
"noteId": "01HQXXX..."
}
}2. 文本创建笔记
用 Markdown 文本快速创建一条笔记，可指定标题、标签和卡片盒。
接口地址
POST /api/openapi/text/input请求参数（application/json）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 是 | 笔记内容（Markdown 格式） |
| title | string | 否 | 笔记标题 |
| type | string | 否 | 笔记类型：note（默认）或 crawl（素材） |
| tags | string[] | 否 | 标签数组 |
| zettelBoxNames | string[] | 否 | 卡片盒名称数组（自动匹配已有卡片盒） |
| createdAt | string | 否 | 自定义创建时间（ISO 8601），用于导入历史笔记 |
请求示例
{
"content": "# 会议纪要\n\n今天讨论了项目进度",
"title": "项目会议",
"tags": ["工作", "会议"],
"zettelBoxNames": ["工作笔记"]
}响应示例
{
"code": "000000",
"msg": "success",
"data": {
"noteId": "01HQXXX...",
"updatedAt": "2026-03-04T12:00:00.000Z"
}
}导入历史笔记
传入 createdAt 可以指定笔记的创建时间，适合从其他笔记应用迁移历史数据。
3. 笔记列表
获取笔记列表，按日期分组返回；支持增量同步。
接口地址
POST /api/openapi/listNotes请求参数（application/json）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| lastSyncTime | string | 否 | 上次同步时间（ISO 8601），只返回该时间之后更新的笔记 |
请求示例
{
"lastSyncTime": "2026-03-01T00:00:00.000Z"
}响应示例
{
"code": "000000",
"msg": "ok",
"data": [
{
"date": "2026-03-04",
"notes": [
{
"noteId": "01HQXXX...",
"title": "TypeScript 学习笔记",
"content": "# 今日学习\n\n学习了 TypeScript",
"tags": ["编程"],
"zettelBoxes": ["技术笔记"],
"createTime": "2026-03-04T12:00:00.000Z",
"updateTime": "2026-03-04T12:00:00.000Z",
"type": "note",
"isAudio": false,
"audioUrl": "",
"isDel": false
}
]
}
]
}增量同步
首次调用不传 lastSyncTime，获取全部笔记；之后传入上次的时间戳，只拉取有更新的笔记，提高效率。
错误码
| 错误码 | 说明 |
|---|---|
| 000000 | 成功 |
| 000001 | 参数错误 |
| 000005 | 服务器内部错误 |
| 000006 | 资源不存在 |
| 000008 | 认证失败 |