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