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

# 密钥与账户设置

> 管理 API Key、Token 组、余额和安全配置。

控制台是管理 AIOAGI 服务的主入口。你可以在控制台创建 API Key、查看余额、配置 Token 组和进入在线聊天应用。

## API Key 管理

<Steps>
  <Step title="进入控制台">
    打开 [AIOAGI 控制台](https://api.aiearth.dev)，登录你的账户。
  </Step>

  <Step title="创建密钥">
    在 **令牌** 页面创建新密钥，并为不同业务线使用不同密钥。
  </Step>

  <Step title="保存密钥">
    将密钥保存到服务端环境变量或密钥管理服务中，例如 `AIO_API_KEY`。
  </Step>
</Steps>

<Tip>
  如果你需要完整的新手路径，请阅读 [API Key 全流程指南](/api-key-guide)。
</Tip>

## 令牌字段说明

<ResponseField name="名称" type="string" required>
  建议使用业务名、环境名或目标模型名，例如 `chat-prod-gpt4o`、`academic-claude` 或 `image-mj-test`。
</ResponseField>

<ResponseField name="过期时间" type="datetime or never">
  测试 Key 建议设置较短有效期。长期服务可以使用更长有效期，但仍建议定期轮换。
</ResponseField>

<ResponseField name="额度上限" type="number">
  单个令牌可使用的上限额度。额度用尽后，该 Key 会停止可用。DOCX 手册中给出了 `500000 = 1 USD` 的示例换算，实际显示以控制台为准。
</ResponseField>

<ResponseField name="分组" type="string" required>
  分组会影响可用模型、速度和费率。不同分组可访问的模型集合可能不同。
</ResponseField>

<ResponseField name="状态" type="enabled or disabled">
  不再使用的 Key 建议及时禁用或删除，减少泄露风险。
</ResponseField>

## 令牌配置建议

* 生产、测试和个人实验使用不同 Key。
* 给每个业务线设置独立额度上限。
* 先确认分组支持目标模型，再把 Key 下发到客户端配置。
* 不要在截图、录屏或公开 issue 中展示完整 Key。
* 对短期协作场景使用临时 Key，而不是长期共享同一个 Key。

## 安全建议

* 不要把 API Key 写入前端代码。
* 不要把 API Key 提交到 Git 仓库。
* 为测试、生产和不同业务线使用不同密钥。
* 定期轮换密钥，并删除不再使用的密钥。
* 为企业团队配置独立 Token 组，限制可用额度。

## 余额与额度

<CardGroup cols={2}>
  <Card title="余额查询" icon="wallet">
    在控制台查看账户余额、消费记录和可用资源。
  </Card>

  <Card title="Token 组" icon="layer-group">
    按业务、团队或客户拆分额度，避免不同业务互相影响。
  </Card>
</CardGroup>

## 分组与模型

<AccordionGroup>
  <Accordion title="为什么分组很重要？" icon="layer-group">
    分组决定线路、可用模型和倍率。你在聊天应用或 SDK 中选不到某个模型时，先检查 Key 所属分组是否支持它。
  </Accordion>

  <Accordion title="什么时候需要新建一个 Key？" icon="circle-plus">
    当你要隔离预算、隔离环境、切换模型族或给不同成员分配额度时，都应该新建独立 Key。
  </Accordion>
</AccordionGroup>

<Note>
  官网说明余额查询与部分实时语音能力使用 `api-s1.aiearth.dev` 或 `api-s1.aiearth.vip` 系列端点。具体接口以控制台和开发者指南为准。
</Note>