快速开始

1. 获取账户

当前站点采用管理员审核开通，不开放匿名自助注册。请通过 QQ 1286407148 联系管理员，并说明用途和所在国家或地区。

账户开通后访问 FreedomZ AI 控制台登录。

2. 创建 API 密钥

登录后进入密钥管理页面创建密钥。密钥通常以 sk- 开头，只应在可信后端、本地开发环境或服务器密钥管理系统中使用。

不要公开密钥

不要在截图、工单、浏览器前端代码或 Git 仓库中提交完整 API 密钥。泄露后应立即删除旧密钥并创建新密钥。

3. 查询可用模型

bash

curl https://freedomz.cn/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

从返回结果的 data[].id 中选择模型名称。不要依赖文档中的静态模型清单，因为模型会随上游能力和运营策略调整。

4. 发起对话请求

bash

curl https://freedomz.cn/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "从 /v1/models 获取的模型名称",
    "messages": [
      {
        "role": "user",
        "content": "请用一句话说明请求已成功。"
      }
    ]
  }'

Windows PowerShell 可使用：

powershell

$headers = @{
  Authorization = "Bearer $env:FREEDOMZ_API_KEY"
  "Content-Type" = "application/json"
}

$body = @{
  model = "从 /v1/models 获取的模型名称"
  messages = @(
    @{
      role = "user"
      content = "请用一句话说明请求已成功。"
    }
  )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod `
  -Uri "https://freedomz.cn/v1/chat/completions" `
  -Method Post `
  -Headers $headers `
  -Body $body

5. 检查结果

成功请求通常返回 HTTP 200。常见错误：

状态码	含义	首要处理
400	请求格式或参数错误	核对 JSON、模型名称和必填字段
401	密钥无效或认证失败	检查密钥，停止重复重试
403	内容、账户或上游策略拒绝	修改请求并联系支持，不要换号连续重试
429	请求过快或资源暂不可用	指数退避并降低并发
5xx	网关或上游临时异常	稍后重试并保留请求 ID

下一步阅读 API 接入和密钥安全。

快速开始 ​

1. 获取账户 ​

2. 创建 API 密钥 ​

3. 查询可用模型 ​