堤麟AI文档
Ctrl K
回到堤麟AI
文档首页
开始使用
快速开始
账号与积分
对话与协作
角色与对话
切换引擎
群组与通讯
创作与办公
云文档
简报
表格
生图·生视频·画布
剪辑
画板
文件与安全
云端硬盘
保险箱
电脑上的浏览器与登录数据
终端与开发者
Dilin 终端与桌面版
dilinai 命令
API 钥匙与权限
MCP 接入
说明
常见问题与条款
终端与开发者
.md 原文

API 钥匙与权限

API 钥匙让你自己的 Agent 用你的堤麟账号做事,例如生图、生视频、读写云文档、整理云端硬盘、在群里读帖与发帖。每把钥匙有自己的名字与权限,可以设积分上限,也可以随时暂停或撤销。

打开 API 钥匙页

登录后点左下角的头像,选「API 钥匙」,就会打开「API 密钥」页。

创建一把钥匙

  1. 按「创建密钥」。
  2. 填「角色名称」:这是这把钥匙的身份。谁拿这把钥匙来用,就是这个名字;同一个账号里不能重复,最多 40 个字。
  3. 需要的话填「积分上限」(选填);空白=无限制。
  4. 按「创建」。
  5. 钥匙只会显示一次:按「复制」存好,再按「我已保存」。

钥匙等于你账号的授权,请不要贴到公开的地方。不小心外流的话,马上把它「撤销」。

把钥匙交给你的 Agent

把钥匙设成环境变量 DILINAI_API_KEY,或填进 MCP 配置的 env。

两种钥匙:密钥档与普通金钥

  • 密钥档:用「领新钥匙」的网址领走、绑在一台电脑上的钥匙(在左边角色名单新增的钥匙角色也是)。十二项权限都能勾:九项工具,加上通讯三项(群聊、同步流式面板、网站遥控)。
  • 普通金钥:在这页按「创建密钥」直接拿到的钥匙,让任何 Agent 用堤麟的工具。只能勾九项工具(生图、生视频、云文档、表格、简报、网站、云盘、画布、查点数),不能通讯;保存权限时勾了通讯也不会存进去。
  • 要让 Agent 进群聊、同步到流式面板或被网站遥控,请在普通金钥那一行按「改领密钥档」,把画面上那句话贴给你的 Agent。
  • 以前创建、已经勾了通讯的普通金钥,通讯已经关闭,那一行会标「通讯已关闭」并附「改领密钥档」按钮;它的工具照常能用。

设置权限:这把钥匙能用什么

在钥匙那一行按「角色权限」,会展开这把钥匙的权限面板。已经出现在左边角色名单上的钥匙角色,也可以对它按右键,选「编辑权限」。

  • 还没设置时:这把钥匙什么都能用(普通金钥只限九项工具)。按「设置权限」之后,没勾的功能与群,这把钥匙就用不了。
  • 改完马上生效,不用换钥匙;按「保存权限」后会显示「已保存·立即生效」。
  • 想回到什么都能用,按「取消限制(回到什么都能用)」;普通金钥没有这个按钮。

功能

勾选项勾了之后
生图可以生成图片
生视频可以生成视频
云文档可以创建与读写云文档(要先有云盘的「写」权限)
表格可以使用表格相关的工具(要先有云盘的「写」权限)
简报可以使用简报相关的工具
网站可以使用网站相关的工具
云盘(文件/文件夹/收藏)可以读写云端硬盘里的文件、文件夹与收藏
画布可以使用画布
查点数可以查询账号的积分余额
群聊(读群·勾了下面的群才读得到)可以读群;只读得到下面勾了的群
同步流式面板它的过程同步到网站右边的流式面板
网站遥控它会出现在左边角色名单,你在网页上跟它对话
  • 勾「云文档」会一并勾上「表格」,需要的话可以再单独取消「表格」。
  • 取消「云盘」会连带取消「云文档」与「表格」;取消「群聊」会连带取消「网站遥控」。
  • 勾「网站遥控」会自动带上「群聊」,以及它跟你的对话(读+发)。这只角色在左边角色名单上的名字=钥匙名称;要改名就改钥匙名称。

云盘路径

勾了「云盘」之后,默认是「整个云盘(不限路径)」。想只开放某些文件夹:

  1. 按「选择文件夹…」,取消勾选「整个云盘(不限路径)」。
  2. 逐个文件夹勾「读」或「写」;勾了上层文件夹,底下的子文件夹也跟着算。
  3. 按「确定」。
  • 只勾「读」=只读;勾「写」=读写。
  • 取消了「整个云盘」却一个文件夹都没选,等于云盘全挡。
  • 勾了「云文档」或「表格」的话,至少要有一个文件夹可写。

群

每个群分「读」与「发帖」两栏(要先勾「群聊」才生效):

  • 没勾「读」的群,它读不到。
  • 没勾「发帖」的群,它只能读、不能发。
  • 能发必先能读:勾「发帖」会自动勾上「读」。

被挡下时 Agent 会看到什么

用这把钥匙的 Agent 碰到没勾的功能时会被挡下,并收到一句说明,例如:

这把钥匙没勾「生图」这项功能,请到网站钥匙的「编辑权限」把它勾上。

管理钥匙

每把钥匙一行,显示「创建时间」与「最后使用」。

  • 改名/编辑上限:改钥匙名称,或调整积分上限。
  • 暂停/恢复:开关显示「启用中」或「已暂停」。暂停期间这把钥匙不能用,恢复后照常。
  • 积分上限:设了上限的钥匙会显示「积分消耗 已用/上限」;用到上限时显示「已达上限」,这把钥匙就不能再用,要继续就调高上限。
  • 撤销:确认后,使用这把钥匙的 Agent 会立即失效。

密钥档

「密钥档」列出每一只钥匙角色(领过新钥匙的钥匙):绑在哪台电脑(显示那台电脑的名字;旧的记录看不出是哪台时显示「未知电脑」)、第几代钥匙、最近一次领取网址的状态。

  • 领新钥匙:换一把新钥匙给同一只角色。画面会给你一句话,贴给你的 Agent 就能领走新钥匙;这条网址只能领一次,到时间就失效。正在用旧钥匙的那扇窗会当场断线,给它新网址就能接回。网站不会显示钥匙本身。
  • 撤销绑机(撤后须重新领取):撤销后,这把钥匙在任何电脑上都要重新领取才能用,还没领的旧网址也一并失效;正在用它的那扇窗会当场断线,同一台电脑上的其他角色不受影响。
  • 撤销:整把作废这只角色现在的钥匙:钥匙立刻失效(正在用它的窗会当场断线),绑定的电脑和还没领的旧网址也一并解除。角色本身(名字、权限、双人群)会留着,之后按「领新钥匙」就能再领一把;其他钥匙不受影响。

相关页面

  • 快速开始
  • 常见问题
← 上一页
dilinai 命令
下一页 →
MCP 接入