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

# API Key 管理

> 创建 API Key，设置分组、额度和过期时间，并安全地保管 Key。

API Key 是调用吉吉API 的凭证。你可以创建多个 Key，分别用于不同的工具、项目或成员。

## 创建 API Key

<Steps>
  <Step title="打开 API 密钥页面">
    登录后进入 [API 密钥](https://www.jiji.cc/keys) 页面，点击新建。
  </Step>

  <Step title="填写名称">
    名称只用于区分用途，例如 `claude-code-mac`、`团队-测试`。
  </Step>

  <Step title="选择分组">
    选择包含所需模型的分组。分组决定可用的模型和倍率，见 [分组与计费](/account/groups)。
  </Step>

  <Step title="设置额度和过期时间（可选）">
    * **额度**：这个 Key 最多可以消耗多少站内额度，用完后自动停止调用
    * **过期时间**：到期后 Key 自动失效

    不设置时，Key 可以使用账户的全部余额，并且长期有效。
  </Step>

  <Step title="复制 Key">
    创建完成后复制 Key，按对应工具的教程完成配置。
  </Step>
</Steps>

## 使用建议

<CardGroup cols={2}>
  <Card title="一个用途一个 Key" icon="key">
    不同工具、设备或成员使用不同的 Key。某个 Key 泄露时只需要删除它，不影响其他用途。
  </Card>

  <Card title="给 Key 设置额度" icon="gauge">
    分享给他人或在测试环境使用的 Key，建议设置额度上限，避免意外消耗。
  </Card>

  <Card title="临时用途设置过期时间" icon="clock">
    临时演示、短期项目用的 Key，设置过期时间后会自动失效。
  </Card>

  <Card title="按分组拆分" icon="layer-group">
    日常任务和重要任务使用不同分组的 Key，兼顾成本和稳定性。
  </Card>
</CardGroup>

## 保管 Key

<Warning>
  API Key 相当于账户密码，任何拿到 Key 的人都可以消耗你的余额。
</Warning>

* 不要把 Key 提交到代码仓库，包括项目目录下的 `.claude/settings.json`、`.env` 等文件
* 不要在截图、聊天记录或公开的 Issue 中暴露 Key
* 在代码中优先通过环境变量读取 Key，不要直接写在源码里
* 怀疑 Key 泄露时，立即在 [API 密钥](https://www.jiji.cc/keys) 页面删除或禁用，再创建新的 Key

## 常见问题

<AccordionGroup>
  <Accordion title="Key 可以更换分组吗">
    可以在 API 密钥页面编辑 Key 的分组。修改后，正在使用的工具无需改配置即可生效。
  </Accordion>

  <Accordion title="提示额度不足，但账户还有余额">
    检查这个 Key 是否设置了额度上限，且已经用完。在 API 密钥页面提高额度，或改为不限额度。
  </Accordion>

  <Accordion title="提示 Key 已过期或已禁用">
    在 API 密钥页面检查 Key 的状态和过期时间，重新启用或延长有效期。
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.