> ## 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 全流程指南

> 按新手流程完成 AIOAGI 登录、充值、创建令牌、配置聊天应用和移动端使用。

本页根据 `AIO平台【API key】全流程图解 新手上手指南.docx` 整理。为避免泄露敏感信息，文档中的示例卡密、示例 API Key 和可能过期的免费体验密码均已替换为占位符。

## 你会完成什么

<CardGroup cols={2}>
  <Card title="登录控制台" icon="right-to-bracket">
    进入 AIOAGI 控制台，准备创建令牌和查看模型。
  </Card>

  <Card title="充值并兑换额度" icon="wallet">
    通过钱包和兑换码完成账户额度充值。
  </Card>

  <Card title="创建 API Key" icon="key">
    设置令牌名称、过期时间、额度上限和分组。
  </Card>

  <Card title="配置聊天应用" icon="messages">
    在网页端或移动端应用中填写接口地址、API Key 和模型。
  </Card>
</CardGroup>

## 开始之前

<Info>
  AIO API 是大语言模型开放接口平台。你可以用一个账号创建不同令牌，并根据业务需要选择不同模型和分组。
</Info>

准备以下信息：

* AIOAGI 控制台账户。
* 可用的充值方式或兑换码。
* 要使用的模型系列，例如 GPT、Claude、DeepSeek、Gemini、Qwen 或绘画模型。
* 需要接入的应用，例如平台内置聊天应用、NextChat、你自建的服务或第三方客户端。

## 1. 登录控制台

<Steps>
  <Step title="打开登录页">
    访问 [AIOAGI 控制台登录页](https://api.aiearth.dev/login)。
  </Step>

  <Step title="登录或注册账号">
    使用你的账号登录。如果你是新用户，请先按页面提示完成注册。
  </Step>

  <Step title="确认首页入口">
    登录后确认可以看到 **钱包**、**令牌**、**模型列表** 和 **聊天** 等入口。
  </Step>
</Steps>

## 2. 充值并兑换额度

<Steps>
  <Step title="进入钱包">
    点击控制台中的 **钱包**，进入账户额度页面。
  </Step>

  <Step title="获取兑换码">
    点击 **获取兑换码**，进入发卡商城。商城地址通常为 `https://shop.aiearth.dev/`。
  </Step>

  <Step title="选择 API 商品">
    选择与 `api.aiearth.dev` 或 `api.aiearth.vip` 对应的 API 额度商品。
  </Step>

  <Step title="购买并复制卡密">
    购买完成后复制卡密。不要把卡密发到公开聊天、公开仓库或文档中。
  </Step>

  <Step title="返回钱包兑换">
    回到 **钱包** 页面，粘贴卡密并点击 **兑换**。兑换成功后检查余额是否增加。
  </Step>
</Steps>

<Warning>
  第三方支付、手续费、商品名称和兑换流程可能变化。请以当前控制台和商城页面为准。
</Warning>

## 3. 创建第一个 API Key

在控制台中，令牌就是 API Key。你可以为不同模型、不同业务或不同成员创建独立令牌。

<Steps>
  <Step title="进入令牌页面">
    点击 **令牌**，进入 Key 管理页面。
  </Step>

  <Step title="添加令牌">
    点击 **添加令牌**，进入令牌配置页面。
  </Step>

  <Step title="填写令牌名称">
    建议使用业务或模型命名，例如 `chat-gpt4o-prod`、`academic-claude` 或 `mj-image-test`。
  </Step>

  <Step title="选择过期时间">
    长期服务可以选择较长有效期。测试 Key 建议设置较短有效期，降低泄露风险。
  </Step>

  <Step title="设置额度上限">
    DOCX 手册中使用 `500000 = 1 USD` 作为额度示例。实际额度显示和换算以控制台为准。
  </Step>

  <Step title="选择分组">
    分组会影响可用模型、速度和价格。倍率通常越高，响应速度越快，单次调用成本也越高。
  </Step>

  <Step title="提交并复制 Key">
    点击 **提交** 后回到 **令牌** 页面，复制新创建的 Key。只在服务端或可信客户端中保存它。
  </Step>
</Steps>

<Tip>
  如果你不确定某个分组能使用哪些模型，先打开 **模型列表** 查看分组和模型对应关系。
</Tip>

## 4. 配置网页聊天应用

AIOAGI 提供内置聊天入口，也支持你在自建或第三方聊天应用中填写 OpenAI 兼容配置。

<Steps>
  <Step title="打开聊天入口">
    在控制台首页点击 **聊天**，进入平台内置的聊天应用或应用列表。
  </Step>

  <Step title="自动配置或手动配置">
    如果页面提示自动配置第一个 Key，可以确认自动配置。你也可以在 **设置** 中手动填写接口地址和 API Key。
  </Step>

  <Step title="填写接口地址">
    常用接口地址为 `https://api.aiearth.dev`。部分 OpenAI SDK 和 API 客户端需要填写带 `/v1` 的地址，例如 `https://api.aiearth.dev/v1`。
  </Step>

  <Step title="填写 API Key">
    使用你自己的 Key，例如 `sk-your-api-key`。不要使用他人的示例 Key。
  </Step>

  <Step title="选择模型">
    在应用设置中选择模型。具体可用模型以 **模型列表** 中对应分组为准。
  </Step>
</Steps>

## 5. 使用移动端或 NextChat

如果你想在手机上使用，可以打开 NextChat 或其他支持 OpenAI 兼容接口的客户端。

<Steps>
  <Step title="打开移动端应用">
    在手机浏览器访问 `https://app.nextchat.dev/`，或打开你自建的 NextChat 服务。
  </Step>

  <Step title="进入设置">
    打开应用设置页，找到接口地址、API Key 和模型配置。
  </Step>

  <Step title="填写代理地址和 Key">
    填写 `https://api.aiearth.dev` 或客户端要求的 `/v1` 地址，并填写你的 API Key。
  </Step>

  <Step title="开始对话">
    保存设置后返回聊天页面，发送测试问题确认配置是否生效。
  </Step>
</Steps>

## 6. 使用绘画能力

DOCX 手册中提到可通过 AIO APPS 使用 MidJourney 等绘画能力。入口和模型名称可能随平台调整，请以控制台为准。

<Steps>
  <Step title="打开 AIO APPS">
    在控制台点击 **聊天**，再进入 **AIO APPS**。
  </Step>

  <Step title="配置代理地址">
    根据应用要求填写 `https://api-s1.aiearth.dev` 或控制台展示的绘画 API 地址。
  </Step>

  <Step title="填写绘画令牌">
    使用支持绘画能力的令牌，例如 `sk-your-image-key`。
  </Step>

  <Step title="输入提示词">
    输入英文或中文提示词，并按应用支持的参数格式设置质量、风格和尺寸。
  </Step>
</Steps>

## 7. 常用检查清单

* 余额已充值，且令牌额度上限未用完。
* Key 所属分组支持当前模型。
* 应用中的接口地址格式正确。
* API Key 没有多复制空格或换行。
* 网络环境可以访问对应端点。
* 如果使用第三方客户端，确认它支持 OpenAI 兼容接口。

## 下一步

<CardGroup cols={2}>
  <Card title="调用 API" icon="terminal" href="/quickstart">
    使用 curl、Python 或 JavaScript 发起第一次聊天补全请求。
  </Card>

  <Card title="了解计费" icon="calculator" href="/pricing">
    理解分组倍率、模型倍率、Token 和费用计算方式。
  </Card>

  <Card title="学术智能体" icon="graduation-cap" href="/academic-agents-studio">
    使用 Academic Agents Studio 完成写作、检索、翻译、图表和代码解释等任务。
  </Card>

  <Card title="常见问题" icon="circle-question" href="/faq">
    排查 `Failed to fetch`、模型不可用、余额不足和密码重置问题。
  </Card>
</CardGroup>