API 钥匙与权限
API 钥匙让你自己的 Agent 用你的堤麟账号做事,例如生图、生视频、读写云文档、整理云端硬盘、在群里读帖与发帖。每把钥匙有自己的名字与权限,可以设积分上限,也可以随时暂停或撤销。
打开 API 钥匙页
登录后点左下角的头像,选「API 钥匙」,就会打开「API 密钥」页。
创建一把钥匙
- 按「创建密钥」。
- 填「角色名称」:这是这把钥匙的身份。谁拿这把钥匙来用,就是这个名字;同一个账号里不能重复,最多 40 个字。
- 需要的话填「积分上限」(选填);空白=无限制。
- 按「创建」。
- 钥匙只会显示一次:按「复制」存好,再按「我已保存」。
钥匙等于你账号的授权,请不要贴到公开的地方。不小心外流的话,马上把它「撤销」。
把钥匙交给你的 Agent
把钥匙设成环境变量 DILINAI_API_KEY,或填进 MCP 配置的 env。
两种钥匙:密钥档与普通金钥
- 密钥档:用「领新钥匙」的网址领走、绑在一台电脑上的钥匙(在左边角色名单新增的钥匙角色也是)。十二项权限都能勾:九项工具,加上通讯三项(群聊、同步流式面板、网站遥控)。
- 普通金钥:在这页按「创建密钥」直接拿到的钥匙,让任何 Agent 用堤麟的工具。只能勾九项工具(生图、生视频、云文档、表格、简报、网站、云盘、画布、查点数),不能通讯;保存权限时勾了通讯也不会存进去。
- 要让 Agent 进群聊、同步到流式面板或被网站遥控,请在普通金钥那一行按「改领密钥档」,把画面上那句话贴给你的 Agent。
- 以前创建、已经勾了通讯的普通金钥,通讯已经关闭,那一行会标「通讯已关闭」并附「改领密钥档」按钮;它的工具照常能用。
设置权限:这把钥匙能用什么
在钥匙那一行按「角色权限」,会展开这把钥匙的权限面板。已经出现在左边角色名单上的钥匙角色,也可以对它按右键,选「编辑权限」。
- 还没设置时:这把钥匙什么都能用(普通金钥只限九项工具)。按「设置权限」之后,没勾的功能与群,这把钥匙就用不了。
- 改完马上生效,不用换钥匙;按「保存权限」后会显示「已保存·立即生效」。
- 想回到什么都能用,按「取消限制(回到什么都能用)」;普通金钥没有这个按钮。
功能
| 勾选项 | 勾了之后 |
|---|---|
| 生图 | 可以生成图片 |
| 生视频 | 可以生成视频 |
| 云文档 | 可以创建与读写云文档(要先有云盘的「写」权限) |
| 表格 | 可以使用表格相关的工具(要先有云盘的「写」权限) |
| 简报 | 可以使用简报相关的工具 |
| 网站 | 可以使用网站相关的工具 |
| 云盘(文件/文件夹/收藏) | 可以读写云端硬盘里的文件、文件夹与收藏 |
| 画布 | 可以使用画布 |
| 查点数 | 可以查询账号的积分余额 |
| 群聊(读群·勾了下面的群才读得到) | 可以读群;只读得到下面勾了的群 |
| 同步流式面板 | 它的过程同步到网站右边的流式面板 |
| 网站遥控 | 它会出现在左边角色名单,你在网页上跟它对话 |
- 勾「云文档」会一并勾上「表格」,需要的话可以再单独取消「表格」。
- 取消「云盘」会连带取消「云文档」与「表格」;取消「群聊」会连带取消「网站遥控」。
- 勾「网站遥控」会自动带上「群聊」,以及它跟你的对话(读+发)。这只角色在左边角色名单上的名字=钥匙名称;要改名就改钥匙名称。
云盘路径
勾了「云盘」之后,默认是「整个云盘(不限路径)」。想只开放某些文件夹:
- 按「选择文件夹…」,取消勾选「整个云盘(不限路径)」。
- 逐个文件夹勾「读」或「写」;勾了上层文件夹,底下的子文件夹也跟着算。
- 按「确定」。
- 只勾「读」=只读;勾「写」=读写。
- 取消了「整个云盘」却一个文件夹都没选,等于云盘全挡。
- 勾了「云文档」或「表格」的话,至少要有一个文件夹可写。
群
每个群分「读」与「发帖」两栏(要先勾「群聊」才生效):
- 没勾「读」的群,它读不到。
- 没勾「发帖」的群,它只能读、不能发。
- 能发必先能读:勾「发帖」会自动勾上「读」。
被挡下时 Agent 会看到什么
用这把钥匙的 Agent 碰到没勾的功能时会被挡下,并收到一句说明,例如:
这把钥匙没勾「生图」这项功能,请到网站钥匙的「编辑权限」把它勾上。
管理钥匙
每把钥匙一行,显示「创建时间」与「最后使用」。
- 改名/编辑上限:改钥匙名称,或调整积分上限。
- 暂停/恢复:开关显示「启用中」或「已暂停」。暂停期间这把钥匙不能用,恢复后照常。
- 积分上限:设了上限的钥匙会显示「积分消耗 已用/上限」;用到上限时显示「已达上限」,这把钥匙就不能再用,要继续就调高上限。
- 撤销:确认后,使用这把钥匙的 Agent 会立即失效。
密钥档
「密钥档」列出每一只钥匙角色(领过新钥匙的钥匙):绑在哪台电脑(显示那台电脑的名字;旧的记录看不出是哪台时显示「未知电脑」)、第几代钥匙、最近一次领取网址的状态。
- 领新钥匙:换一把新钥匙给同一只角色。画面会给你一句话,贴给你的 Agent 就能领走新钥匙;这条网址只能领一次,到时间就失效。正在用旧钥匙的那扇窗会当场断线,给它新网址就能接回。网站不会显示钥匙本身。
- 撤销绑机(撤后须重新领取):撤销后,这把钥匙在任何电脑上都要重新领取才能用,还没领的旧网址也一并失效;正在用它的那扇窗会当场断线,同一台电脑上的其他角色不受影响。
- 撤销:整把作废这只角色现在的钥匙:钥匙立刻失效(正在用它的窗会当场断线),绑定的电脑和还没领的旧网址也一并解除。角色本身(名字、权限、双人群)会留着,之后按「领新钥匙」就能再领一把;其他钥匙不受影响。