注册与配置教程

本页把不同平台的共同流程整理成一条新手路线。服务商页面的按钮、实名要求和免费资格会变化；遇到差异时，以服务商官方控制台和对应的 模型 API 教程 为准。

第一步：先选清楚你要的“免费”

• 官方免费层：自己注册、自己创建 Key，通常最适合长期学习。
• 试用或赠送额度：可能一次性、会过期，或只支持指定模型。
• 免费模型：单个模型价格为 0，但仍可能有 RPM、TPM、每日请求和排队限制。
• 公开免 Key 接口：适合学习 HTTP，不建议发送隐私或生产请求。
• 本地 API：没有云端 Token 账单，但需要自己的电脑和模型文件。

不要把 ChatGPT Plus、Claude Pro、Gemini 网页会员当成 API Key 或 API 余额。会员和开发者 API 通常是分开的产品。

第二步：注册官方账号

1. 从 国际免费额度 或 国内免费额度 打开官方域名。
2. 使用自己能长期控制的邮箱、手机号和地区资料。不要使用共享账号、虚假实名或绕过地区验证的方式。
3. 阅读服务条款、隐私政策、数据保留和可用地区。
4. 如果平台要求付款方式，先确认是否会自动扣款、免费额度用完后是否转按量计费，以及如何设置预算提醒。
5. 完成邮箱、手机或实名认证后，进入 Developer、API、Console、Settings 或 Keys 页面。

第三步：创建并保护 API Key

在 API Keys / Credentials / Access tokens 页面创建一把专用 Key：

• 给 Key 起一个能识别用途的名称，例如 easyai-learning；
• 如果平台支持，限制模型、项目、来源 IP 或最大花费；
• 只复制一次完整 Key，保存到密码管理器或 EasyAI 的安全配置中；
• 不要放进 GitHub、截图、聊天记录、教程示例或前端网页源码；
• 泄露后立即撤销并重新创建，不要只删除本地文件。

不同平台的前缀、长度和是否需要额外的 Project ID 不同，不要根据网上示例手工改 Key。

第四步：找到三项配置值

值	在哪里找	常见错误
API 类型	服务商 API 文档的请求示例	把 Anthropic、Gemini 和 OpenAI Chat Completions 混用
Base URL	官方文档的 endpoint / base URL	填成官网登录页，或重复拼接 /chat/completions
模型 ID	Models、Playground、部署或模型列表	填展示名、别名或已下线的 preview 名称

如果平台使用 Deployment name、接入点 ID、Workspace ID 或 Project ID，这些也要按官方说明记录。Azure OpenAI 最常见的区别是模型字段填写 Deployment name，而不是模型展示名。

第五步：填入 EasyAI

1. 打开 EasyAI，进入已安装 Agent 的 配置 API。
2. 点击 添加服务商。
3. 填写服务商名称、API 类型、Base URL、API Key 和默认模型。
4. 打开 启用此服务商，保存配置。
5. 点击 重新检测；显示“可访问”后，再选择 配置生效。
6. 新建一个只包含短文本的会话，确认模型能返回内容。

可参考这些已经完成的详细页面：

• Gemini API
• OpenRouter
• SiliconFlow
• DeepSeek
• 智谱 GLM
• 阿里云百炼 / Qwen

第六步：用最小请求验证

先输入一条不含个人资料的提示，例如“用一句话解释什么是 API”。如果成功，再逐步测试更长上下文、工具调用和文件处理。

现象	优先检查
401	Key 是否复制完整、是否撤销、是否属于同一个站点 / Project
403	地区、组织、模型权限、实名或安全策略
404	Base URL、模型 ID、Deployment name 或接入点
429	免费层速率、每日额度、并发、上游排队
余额 / Billing 错误	该模型是否属于免费范围，免费额度是否已用完，是否必须先启用计费
超时 / 网络不可达	网络、代理、DNS、地区访问和服务商状态

不要通过共享 Key、未知代理或修改请求头来绕过限制。先查看官方用量页，降低请求频率或更换明确属于自己的免费路线。

多个免费服务怎么管理

建议使用不同名称保存多个服务商，并分别执行连接检测。把最常用且稳定的服务放在前面，体验额度快用完时再临时停用或切换。不要把同一把 Key 复制到多个不受信任的工具里，也不要在不清楚数据去向时开启自动 Fallback。

最后回到 启动与管理会话，选择在 EasyAI 内或单独窗口启动会话。