> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建 API 密钥

> 在 UQPAY 控制台生成 API 凭证，用于认证你的 API 请求。

每一次对 UQPAY 的 API 请求都需要两项凭证：**Client ID**（公开标识）和 **API Key**（密钥）。两者都在控制台生成。

<Steps>
  <Step title="打开 API 密钥设置">
    登录控制台，点击右上角的头像并选择 **Settings**，然后进入 **Developer > API Keys**。

    <img src="https://mintcdn.com/uqpay-0838527a/ynKaMDHkJfeg6L8y/images/account-center/create-api-keys-1.png?fit=max&auto=format&n=ynKaMDHkJfeg6L8y&q=85&s=c10b93fe1356c7181f9e0ac9eab70652" alt="API Keys 设置页面" width="1920" height="968" data-path="images/account-center/create-api-keys-1.png" />
  </Step>

  <Step title="创建一个新的 API 密钥">
    在 API Keys 页面右上角点击 **Create API Keys**。

    <img src="https://mintcdn.com/uqpay-0838527a/ynKaMDHkJfeg6L8y/images/account-center/create-api-keys-image.png?fit=max&auto=format&n=ynKaMDHkJfeg6L8y&q=85&s=bbf5b45b128d521bfa23e38153a6a746" alt="Create API Keys 按钮" width="1721" height="1234" data-path="images/account-center/create-api-keys-image.png" />

    <Tip>
      你可以在创建时配置 IP 白名单，限制哪些 IP 地址可以使用这个密钥。白名单也可以稍后编辑。
    </Tip>
  </Step>

  <Step title="复制并保存你的 API 密钥">
    API 密钥会在创建后显示在页面上。

    <img src="https://mintcdn.com/uqpay-0838527a/ynKaMDHkJfeg6L8y/images/account-center/create-api-keys-3.png?fit=max&auto=format&n=ynKaMDHkJfeg6L8y&q=85&s=46fbec52a9aad5f832e54463b4485671" alt="显示 API 密钥" width="1352" height="755" data-path="images/account-center/create-api-keys-3.png" />

    <Warning>
      API 密钥**只会显示一次**。请立即复制并妥善保管。如果遗失，你需要创建一个新密钥。
    </Warning>
  </Step>

  <Step title="查看你的 Client ID">
    Client ID 始终显示在 API Keys 页面 —— 你可以随时查看或复制。

    <img src="https://mintcdn.com/uqpay-0838527a/ynKaMDHkJfeg6L8y/images/account-center/create-api-keys-4.png?fit=max&auto=format&n=ynKaMDHkJfeg6L8y&q=85&s=493eded6cd034b455902a245920bec3c" alt="API Keys 页面上的 Client ID" width="1352" height="755" data-path="images/account-center/create-api-keys-4.png" />
  </Step>
</Steps>

<Note>
  只有主账户可以生成 API 密钥。如需代表子账户调用 API，请使用 `x-on-behalf-of` 请求头 —— 参见 [关联账户](/zh/account-center/v1.6/guide/connected-accounts)。
</Note>

<h2 id="next-step">下一步</h2>

你已获得 Client ID 和 API 密钥。前往[快速开始](/zh/account-center/v1.6/guide/quickstart)发起你的第一次 API 调用。