常见问题

为什么不能自助注册？

当前采用管理员审核开通，以控制滥用、支付争议和上游账户风险。请联系 QQ 1286407148 说明用途和所在地区。

API 地址是什么？

API 基础地址是 https://freedomz.cn/v1。https://ai.freedomz.cn/ 是用户控制台。

Base URL 到底要不要带 /v1？

OpenAI SDK 和 OpenAI Compatible 客户端通常填写 https://freedomz.cn/v1。 如果客户端明确说明会自动追加 /v1，则填写 https://freedomz.cn。Claude Code 的 ANTHROPIC_BASE_URL 也填写 https://freedomz.cn。

为什么文档不列出全部模型？

模型会随上游可用性和运营策略变化。请以控制台或 GET /v1/models 的实时结果 为准。

401 后可以自动换密钥重试吗？

不建议。401 通常表示认证失败。连续切换密钥或账号重试可能扩大风控影响。 客户端应停止自动重试，检查密钥状态并联系支持。

客户端能回复，为什么使用记录没有数据？

客户端可能仍在使用官方账号、旧 Provider 或其他网关。使用记录是请求是否经过 FreedomZ AI 的主要证据，请检查 Base URL 和 Provider，并重启客户端。

Codex 可以直接设置 OPENAI_BASE_URL 吗？

推荐使用当前 Codex 的 ~/.codex/config.toml 定义自有 model_provider， 并通过 env_key 读取密钥。完整示例见 Codex 接入。

Claude Code 为什么不能填写 /v1？

Claude Code 会按 Anthropic Messages 规则拼接接口路径，因此 ANTHROPIC_BASE_URL 使用 https://freedomz.cn。完整示例见 Claude Code 接入。

429 是否代表封号？

不一定。429 可能来自客户端并发过高、站点洪泛保护、上游限流或资源暂时不足。 请降低并发，使用指数退避，并保留请求 ID。

支付成功但余额没有变化怎么办？

等待 10 分钟后查看订单状态。仍未到账时不要重复付款，准备订单号和脱敏后的支付 凭证联系支持。

可以转售 API 或多人共用账号吗？

未经书面授权不得转售、分发额度、共享账户或将个人套餐包装为公开服务。