API 密钥
创建和吊销密钥,让您自己的工具读取泰拉智能的数据。
您的密钥在哪里
密钥让您自己的工具或 AI 助手(见连接您的 AI 助手)无需有人登录即可读取泰拉智能的数据,读取的数据计入贵公司的套餐。每个套餐都包含 API 和 MCP,您的密钥位于 API 与 MCP 页面:
- 单人账户:您的账户页面中的 API 与 MCP 标签页。
- 团队管理员:组织管理中的 API 与 MCP,列出工作区的所有密钥及其创建者(进入方式见谁可以邀请)。
- 团队成员:您的账户页面中的 API 与 MCP 标签页,列出您自己的密钥。管理员可以查看和撤销这些密钥;您离开工作区时,它们即停止使用。
- 仅开通 API 的公司账户登录后进入 API 控制台,其中是同样的页面。
各处的密钥表格用法相同。密钥可以发出的全部请求,见我们网站上的 API 参考文档。
开通 API 访问
在免费版、专业版和团队版中,第一次打开 API 与 MCP 页面时,管理员需代表公司接受 API 使用条款:勾选我代表本公司接受 API 使用条款,再点击开通 API 访问。想先看条款,可点阅读 API 使用条款。开通后,页面显示额度余额、剩余免费额度(每月更新)、本月已读取行数和最近 24 小时的请求数,您的密钥列在 API 密钥下。在此之前,团队成员会看到管理员尚未开启 API 访问。许可已包含 API 访问,因此页面直接显示密钥。如果页面显示API 访问尚未开放。,则在开放之前无需操作。
创建密钥
- 打开 API 与 MCP 页面,点击创建密钥。
- 填写密钥名称,例如将使用它的系统名称。名称仅供您自己记录,便于区分不同的密钥。
- 在有效期中选择:30 天、90 天、1 年(默认)或永不过期。
- 若您的套餐包含工作邮箱(专业版、团队版,或包含联系方式的许可),可勾选可查看电子邮箱地址,让此密钥在团队的查看额度内查询联系人的工作邮箱。
- 在确认您的密码中输入密码。密钥无需密码或双重验证码即可使用,因此创建前需确认是您本人操作。如果您通过公司的身份提供商登录、没有密码,可留空。
- 点击创建。
新密钥只会在您的新密钥中显示一次。点击复制,把它存放在您的工具能读取的地方,再点击完成。我们只保存密钥的指纹,因此无法再次显示。若遗失,请吊销并另行创建。
保管好密钥
- 把密钥当作密码对待:持有者可以以贵工作区的身份读取泰拉智能的数据,使用时不会再要求密码或双重验证码。
- 不要放在共享文档、聊天消息、网页,或他人能看到的代码里;请存放在工具的保密设置中。
- 每个系统各建一个密钥并以其命名,这样吊销其中一个不会影响其他系统。
- 按用途选择尽可能短的有效期。
- 密钥一旦可能泄露,请立即吊销。
查看密钥的使用情况
表格列出每个密钥的名称、密钥的公开前段、权限、创建时间、最近使用(未使用过显示从未使用)和状态:有效、已过期或已吊销。表格上方可按名称或密钥搜索。
API 与 MCP 页面上方显示有效密钥、本计费周期的已用额度,以及最近 24 小时的请求数和返回记录数。要看某个密钥,打开它的操作菜单,选择查看用量:先是请求数、返回记录数和额度的汇总,然后逐条列出每次调用的接口、状态、记录数、额度和时间。尚未使用的密钥显示该密钥尚未被使用。
吊销密钥
打开该密钥的操作菜单,选择吊销,并在确定吊销此密钥?中确认。使用该密钥的一切将立即停止工作,且无法撤销。已吊销的密钥会保留在表格中,状态为已吊销;要继续使用,请创建新密钥并交给您的工具。