本页根据 AIO平台【API key】全流程图解 新手上手指南.docx 整理。为避免泄露敏感信息，文档中的示例卡密、示例 API Key 和可能过期的免费体验密码均已替换为占位符。
你会完成什么
登录控制台
进入 AIOAGI 控制台，准备创建令牌和查看模型。
创建 API Key
设置令牌名称、过期时间、额度上限和分组。
配置聊天应用
在网页端或移动端应用中填写接口地址、API Key 和模型。
开始之前
AIO API 是大语言模型开放接口平台。你可以用一个账号创建不同令牌，并根据业务需要选择不同模型和分组。
- AIOAGI 控制台账户。
- 可用的充值方式或兑换码。
- 要使用的模型系列，例如 GPT、Claude、DeepSeek、Gemini、Qwen 或绘画模型。
- 需要接入的应用，例如平台内置聊天应用、NextChat、你自建的服务或第三方客户端。
1. 登录控制台
登录或注册账号
使用你的账号登录。如果你是新用户，请先按页面提示完成注册。
确认首页入口
登录后确认可以看到 钱包、令牌、模型列表 和 聊天 等入口。
2. 充值并兑换额度
获取兑换码
点击 获取兑换码，进入发卡商城。商城地址通常为 https://shop.aiearth.dev/。
选择 API 商品
选择与 api.aiearth.dev 或 api.aiearth.vip 对应的 API 额度商品。
购买并复制卡密
购买完成后复制卡密。不要把卡密发到公开聊天、公开仓库或文档中。
返回钱包兑换
回到 钱包 页面，粘贴卡密并点击 兑换。兑换成功后检查余额是否增加。
第三方支付、手续费、商品名称和兑换流程可能变化。请以当前控制台和商城页面为准。
3. 创建第一个 API Key
在控制台中，令牌就是 API Key。你可以为不同模型、不同业务或不同成员创建独立令牌。
填写令牌名称
建议使用业务或模型命名，例如 chat-gpt4o-prod、academic-claude 或 mj-image-test。
选择过期时间
长期服务可以选择较长有效期。测试 Key 建议设置较短有效期，降低泄露风险。
设置额度上限
DOCX 手册中使用 500000 = 1 USD 作为额度示例。实际额度显示和换算以控制台为准。
选择分组
分组会影响可用模型、速度和价格。倍率通常越高，响应速度越快，单次调用成本也越高。
提交并复制 Key
点击 提交 后回到 令牌 页面，复制新创建的 Key。只在服务端或可信客户端中保存它。
如果你不确定某个分组能使用哪些模型，先打开 模型列表 查看分组和模型对应关系。
4. 配置网页聊天应用
AIOAGI 提供内置聊天入口，也支持你在自建或第三方聊天应用中填写 OpenAI 兼容配置。
打开聊天入口
在控制台首页点击 聊天，进入平台内置的聊天应用或应用列表。
自动配置或手动配置
如果页面提示自动配置第一个 Key，可以确认自动配置。你也可以在 设置 中手动填写接口地址和 API Key。
填写接口地址
常用接口地址为 https://api.aiearth.dev。部分 OpenAI SDK 和 API 客户端需要填写带 /v1 的地址，例如 https://api.aiearth.dev/v1。
填写 API Key
使用你自己的 Key，例如 sk-your-api-key。不要使用他人的示例 Key。
选择模型
在应用设置中选择模型。具体可用模型以 模型列表 中对应分组为准。
5. 使用移动端或 NextChat
如果你想在手机上使用，可以打开 NextChat 或其他支持 OpenAI 兼容接口的客户端。
打开移动端应用
在手机浏览器访问 https://app.nextchat.dev/，或打开你自建的 NextChat 服务。
进入设置
打开应用设置页，找到接口地址、API Key 和模型配置。
填写代理地址和 Key
填写 https://api.aiearth.dev 或客户端要求的 /v1 地址，并填写你的 API Key。
开始对话
保存设置后返回聊天页面，发送测试问题确认配置是否生效。
6. 使用绘画能力
DOCX 手册中提到可通过 AIO APPS 使用 MidJourney 等绘画能力。入口和模型名称可能随平台调整，请以控制台为准。
打开 AIO APPS
在控制台点击 聊天，再进入 AIO APPS。
配置代理地址
根据应用要求填写 https://api-s1.aiearth.dev 或控制台展示的绘画 API 地址。
填写绘画令牌
使用支持绘画能力的令牌，例如 sk-your-image-key。
输入提示词
输入英文或中文提示词，并按应用支持的参数格式设置质量、风格和尺寸。
7. 常用检查清单
- 余额已充值，且令牌额度上限未用完。
- Key 所属分组支持当前模型。
- 应用中的接口地址格式正确。
- API Key 没有多复制空格或换行。
- 网络环境可以访问对应端点。
- 如果使用第三方客户端，确认它支持 OpenAI 兼容接口。
下一步
调用 API
使用 curl、Python 或 JavaScript 发起第一次聊天补全请求。
了解计费
理解分组倍率、模型倍率、Token 和费用计算方式。
学术智能体
使用 Academic Agents Studio 完成写作、检索、翻译、图表和代码解释等任务。
常见问题
排查 Failed to fetch、模型不可用、余额不足和密码重置问题。
