---
title: "创建服务器 API 密钥"
description: "在控制台中创建用于服务器间调用 ThunderPhone API 的 sk_live_ 密钥，妥善保管，并在需要时轮换或撤销该密钥。"
---

服务器 API 密钥（`sk_live_...`）用于验证对 ThunderPhone API 的服务器到服务器调用。密钥位于**组织 → 密钥**下。

<Warning>
  服务器密钥属于机密信息。切勿将其置于客户端代码中——对于
  浏览器，请改用受域名限制的
  [可发布密钥](/api-reference/publishable-keys) (`pk_live_...`)。
</Warning>

<Steps>
  <Step title="打开“密钥”选项卡">
    前往**组织 → 密钥**，然后点击**创建密钥**。
  </Step>
  <Step title="为其命名">
    选择一个能说明密钥使用位置的名称——例如“生产后端”。名称仅为标签，不影响访问权限。
  </Step>
  <Step title="创建密钥">
    在对话框中点击**创建密钥**。这将生成机密。
  </Step>
  <Step title="立即复制">
    完整机密**仅显示一次**。请将其复制到您的密钥管理器中——离开后，仅前缀仍可见。
  </Step>
</Steps>

## 使用

该密钥绑定到此组织，因此请求无需组织 ID——只需 Bearer 标头：

```bash
curl https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

接下来，[API 快速入门](/zh/quickstart)将通过另外三次请求带您完成首次通话。

## 轮换和撤销

创建新密钥，将您的服务迁移到新密钥，然后从同一标签页删除旧密钥——列表会显示每个密钥的前缀和名称，方便您区分。要通过脚本轮换密钥，请使用已登录的会话令牌调用[开发者 API 密钥端点](/api-reference/developer-api-keys)。`sk_live_` 密钥无法创建、列出或撤销密钥，因此泄露的密钥无法生成自己的替代密钥。成员、邀请、付款设置和其他[账户控制](/api-reference/introduction#what-api-keys-cant-do)也是如此。

<Note>
  服务器 API 密钥是机器凭据，不受您组织的[**要求使用通行密钥**](/zh/guides/sso)
  策略约束——该设置检查的是人工登录，而非 `sk_live_...` 密钥。
  因此，及时在此处轮换和撤销密钥，是您控制持续 API 访问的主要手段；如果要求使用通行密钥，
  安全策略面板会显示当前获得豁免的活跃密钥数量。
</Note>

<Tip>
  请让应用内副驾驶创建一个 API 密钥，它会引导您完成此流程，并实时突出显示每个控件。
</Tip>

---

## 后续步骤

<CardGroup cols={2}>
  <Card title="API 快速入门" icon="terminal" href="/zh/quickstart">
    智能体、号码、Webhook、首次通话——四次 REST 调用。
  </Card>
  <Card title="身份验证参考" icon="lock" href="/api-reference/introduction">
    Bearer 身份验证和组织绑定的工作方式。
  </Card>
</CardGroup>