外观
FreedomZ AI 使用教程
FreedomZ AIAPI 接入、客户端配置与问题排查
第一次使用时，按“账户状态 → API 密钥 → 分组与模型 → 客户端 → 使用记录”的顺序操作。 API 基础地址是 https://freedomz.cn/v1。
新用户 3 分钟速通
- 登录并确认账户查看余额、订单或管理员已开通的可用权限。
- 创建 API 密钥为当前设备单独创建密钥，并选择可用分组。
- 配置客户端优先一键导入 CCSwitch，也可以手动填写 Base URL。
- 发起最小请求先查询模型，再进行一次不带工具和附件的测试。
- 核对使用记录记录出现后，才说明请求确实经过 FreedomZ AI。
按任务查教程
创建 API 密钥了解名称、分组、额度、有效期和安全保存方式。选择模型与分组先按客户端协议选分组，再从实时模型列表选择模型。余额、订单与用量查看充值流程、订单状态、费用和每次请求的使用记录。请求失败排查按 400、401、403、429、5xx 和慢请求顺序定位。CCSwitch 接入从控制台一键导入，并确认配置已经启用。Grok 开发者接入调用 Grok 文本、图片、视频生成和异步任务接口。Codex 接入配置 Responses 协议、模型与推理强度。Claude Code 接入通过 Anthropic Messages 兼容入口连接网关。OpenCode 与 VS Code使用 OpenAI 兼容 Provider 或客户端原生配置。
常用入口
| 用途 | 入口 |
|---|---|
| 控制台首页 | 打开控制台 |
| API 密钥 | 创建和管理密钥 |
| 使用记录 | 核对请求和费用 |
| 余额与服务 | 查看可用入口 |
| 订单 | 查看订单状态 |
| API 基础地址 | https://freedomz.cn/v1 |
使用密钥前先确认
不要把完整 API 密钥写入网页前端、公开仓库、截图、聊天记录或安装包。不同设备 和客户端应使用独立密钥，泄露后立即撤销。
服务说明
- FreedomZ AI 是独立运营的 API 接入服务，不是上游模型厂商的官方网站。
- 模型、价格、能力和可用性会变化，以控制台和
GET /v1/models的实时结果为准。 - 不得利用本服务绕过模型安全机制、地域限制、访问控制或第三方服务条款。
- 需要支持时请提供请求时间、接口、状态码和请求 ID；密钥只保留前后各 4 位。