---
title: "建立伺服器 API 金鑰"
description: "從控制台建立 sk_live_ 私密金鑰，以供伺服器對伺服器呼叫 ThunderPhone API；請妥善保管，並在需要時輪替或撤銷。"
---

伺服器 API 金鑰（`sk_live_...`）可驗證伺服器對伺服器的 ThunderPhone API 呼叫。金鑰位於 **Organization → Keys**。

<Warning>
  伺服器金鑰屬於機密資訊。絕不可將其放入用戶端程式碼中——針對
  瀏覽器，請改用設有網域限制的
  [可公開金鑰](/api-reference/publishable-keys)（`pk_live_...`）。
</Warning>

<Steps>
  <Step title="開啟 Keys 分頁">
    前往 **Organization → Keys**，然後按一下 **Create key**。
  </Step>
  <Step title="命名">
    選擇能說明金鑰用途位置的名稱——例如「正式環境後端」。名稱僅為標籤；不會影響存取權限。
  </Step>
  <Step title="建立金鑰">
    在對話方塊中按一下 **Create key**。這會產生機密金鑰。
  </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-Hant/quickstart)只需再進行三個請求，即可帶你完成第一通電話。

## 輪替與撤銷

建立新的金鑰，將服務切換過去，再從同一個分頁刪除舊金鑰——清單會顯示每個金鑰的前綴與名稱，方便你加以區分。若要以指令碼輪替金鑰，請使用已登入的工作階段權杖呼叫[開發人員 API 金鑰端點](/api-reference/developer-api-keys)。`sk_live_` 金鑰無法建立、列出或撤銷金鑰，因此外洩的金鑰無法建立自己的替代金鑰。成員、邀請、付款設定及其他[帳戶控制項](/api-reference/introduction#what-api-keys-cant-do)也是如此。

<Note>
  伺服器 API 金鑰是機器憑證，不受你的組織[**Require passkeys**](/zh-Hant/guides/sso)
  政策限制——該設定會檢查人員登入，而非 `sk_live_...` 金鑰。
  因此，在此及時輪替與撤銷金鑰，是你控管持續 API 存取權的主要方式；如果要求使用通行金鑰，
  安全性政策面板會顯示目前有多少啟用中的金鑰可獲得豁免。
</Note>

<Tip>
  請應用程式內的智慧副手「建立 API 金鑰」，它會引導你完成此流程，並即時標示每個控制項。
</Tip>

---

## 後續步驟

<CardGroup cols={2}>
  <Card title="API 快速入門" icon="terminal" href="/zh-Hant/quickstart">
    智慧體、號碼、Webhook、第一通電話——四個 REST 呼叫。
  </Card>
  <Card title="驗證參考" icon="lock" href="/api-reference/introduction">
    Bearer 驗證與組織綁定的運作方式。
  </Card>
</CardGroup>