身份验证

创建密钥

打开 Settings，然后进入 API keys。给密钥起一个能说明用途的名称，然后创建。

密钥只会显示一次。请立即复制，并保存在安全的地方，例如服务器的环境变量中。Setherion 只保存它的指纹，所以没有人能再次把它显示给你，我们也不能。如果你弄丢了，请撤销它，再创建一个新的。

密钥以 sth_ 开头，后面是 43 个随机的字母、数字、- 和 _，一共 47 个字符。名称最长 60 个字符，更长的会被截断。

每个请求都要带上它

把密钥放进 Authorization 请求头：

curl https://www.setherion.com/api/v1/projects \
  -H "Authorization: Bearer $SETHERION_API_KEY"

const res = await fetch('https://www.setherion.com/api/v1/projects', {
  headers: { Authorization: `Bearer ${process.env.SETHERION_API_KEY}` },
})
const data = await res.json()

只会读取 Bearer 方案。没有有效密钥的请求会得到 401：

{
  "ok": false,
  "error": "A valid API key is required. Make one on your Setherion account page and send it as \"Authorization: Bearer sth_...\"."
}

缺少请求头、密钥拼写错误、密钥不存在以及密钥已被撤销，得到的都是同一个回答，所以它永远不会告诉你是哪一种情况。

密钥能做什么

密钥以你的身份行事。你在 Setherion 里能做的事，它都能做：

• 查看你仪表盘上的应用，包括你自己的和与你共享的；
• 读取你能打开的任何应用的上架准备指南和隐私问卷回答；
• 修改你可以编辑的应用，并像在编辑器里修改一样消耗积分；
• 发布你可以编辑的应用，并撰写它们的商店页面。

其余由你在每个应用上的角色决定。读取类调用需要 viewer 或更高角色；修改应用或消耗积分的调用需要 editor 或更高角色。哪个调用需要哪个角色，请见简介。

密钥不能修改你的账户、套餐或账单，也不能创建或撤销密钥：只有你自己登录 Setherion 时才能做这些，所以一个泄露的密钥永远无法再生成其他密钥。

撤销密钥

在 API keys 中，点击密钥旁边的 Revoke。它会立即失效。已撤销的密钥会留在列表中，方便你查看它们最后一次使用的时间。

你最多可以同时拥有 10 个有效密钥。申请第 11 个会被拒绝，并提示 You have 10 active keys. Revoke one you no longer use to make another. 列表会显示每个密钥最后一次使用的时间，每分钟最多更新一次。

不用密钥登录

AI 助手通过登录页面和 Allow 按钮连接，而不是使用密钥。请见MCP：连接 AI 助手。

这种登录产生的令牌只在助手地址（/api/mcp）上有效。本参考中的端点只接受 API 密钥，不接受其他方式。