01 · Freecode 快速开始#

目标：创建自己的 API 密钥，并通过 Freecode 发出一个实际请求。

1. 登录与准备余额#

打开 https://api.freecode.cc 注册并登录；如果注册入口要求邀请码，按页面提示获取。进入钱包，确认账户有可用余额。

2. 创建 API 密钥#

打开 API 密钥，点击创建按钮。

名称：例如 my-first-app。
分组：在模型广场查找 gpt-6.1-sol，选择包含该模型、允许你使用的分组。
额度与有效期：按实际需要设置。
模型限制：如启用限制，把准备调用的模型加入允许列表。

保存后复制完整密钥，包括 sk- 前缀。密钥选中的分组决定路由，不能只凭模型在广场中出现就判断这把密钥一定可用。

3. 设置环境变量#

以下命令在 macOS / Linux / WSL 的 Bash 或 Zsh 中运行：

export FREECODE_API_KEY="sk-your-freecode-api-key"
export FREECODE_MODEL="gpt-6.1-sol"

Windows PowerShell：

$env:FREECODE_API_KEY = "sk-your-freecode-api-key"
$env:FREECODE_MODEL = "gpt-6.1-sol"

这些设置只对当前终端及其启动的程序生效。示例密钥需要替换，模型名可换成该密钥有权使用的模型。

4. 查看该密钥的模型目录#

macOS / Linux / WSL：

curl -sS https://api.freecode.cc/v1/models \
  -H "Authorization: Bearer ${FREECODE_API_KEY}"

PowerShell 使用 curl.exe，避免旧版本 PowerShell 的命令别名影响：

curl.exe -sS "https://api.freecode.cc/v1/models" `
  -H "Authorization: Bearer $env:FREECODE_API_KEY"

这个接口用于发现模型；返回模型列表不代表一次实际生成已经成功。

5. 发出第一个 Responses 请求#

macOS / Linux / WSL：

curl -sS --max-time 120 https://api.freecode.cc/v1/responses \
  -H "Authorization: Bearer ${FREECODE_API_KEY}" \
  -H "Content-Type: application/json" \
  --data "{\"model\":\"${FREECODE_MODEL}\",\"input\":\"请用一句话打个招呼\",\"store\":false}"

Windows PowerShell：

$body = @{
  model = $env:FREECODE_MODEL
  input = "请用一句话打个招呼"
  store = $false
} | ConvertTo-Json

Invoke-RestMethod `
  -Method Post `
  -Uri "https://api.freecode.cc/v1/responses" `
  -Headers @{ Authorization = "Bearer $env:FREECODE_API_KEY" } `
  -ContentType "application/json; charset=utf-8" `
  -Body ([System.Text.Encoding]::UTF8.GetBytes($body))

成功时返回 Responses 对象，回答通常在 output 数组的文本内容中。随后打开使用日志，核对本次模型、实际分组、用量和费用。

6. 可选：使用 Chat Completions#

如果所选模型及分组支持 Chat Completions，可使用下面的示例。这里使用模型广场中可见的 gpt-4o，请为密钥选择对应分组。

curl -sS --max-time 120 https://api.freecode.cc/v1/chat/completions \
  -H "Authorization: Bearer ${FREECODE_API_KEY}" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "请用一句话打个招呼"}]
  }'

站内 Playground 可以验证当前账号的对话能力；要验证某把 API 密钥的分组和限制，应执行上面的实际请求。

接下来按工具选择 CC Switch、Claude Code、Codex CLI 或 SDK。报错时查看常见问题。

参考：原快速开始指南。本文地址、模型和菜单按 Freecode 整理。