快速开始

这份指南会带你完成注册、创建令牌、查看模型并发出第一条 API 请求。

1. 登录控制台

打开 猫咖啡 API 控制台。已有账号可直接登录；没有账号时，点击注册并按页面提示完成账号创建。

保护账号

请使用独立且足够强的密码。不要与他人共享账号，也不要在公开截图中展示余额、邮箱或令牌。

2. 创建令牌

登录后进入 控制台 → 令牌管理，点击 添加令牌。

首次使用建议：

• 名称填写用途，例如“Cherry Studio”或“本地开发”。
• 只开启确实需要的模型权限。
• 按用途设置额度和有效期，避免长期使用无限制令牌。
• 创建后立即复制并保存在密码管理器中。

详细字段说明见创建与管理令牌。

3. 确认可用模型

进入控制台的 模型广场/定价 页面，确认当前账号可用的模型名称。调用 API 时，model 必须与页面显示的模型标识完全一致。

模型可用性和价格可能调整，请以控制台实时展示为准。

4. 发出第一条请求

在终端设置令牌。请将示例值替换为刚创建的令牌：

Linux / macOS

export NEWAPI_API_KEY="sk-你的令牌"

Windows PowerShell

$env:NEWAPI_API_KEY="sk-你的令牌"

然后调用 OpenAI 兼容接口：

curl https://coffeecatbox.cc/v1/chat/completions \
  -H "Authorization: Bearer $NEWAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "请替换为控制台中的可用模型名",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ],
    "stream": false
  }'

Windows PowerShell 可以使用：

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

$body = @{
  model = "请替换为控制台中的可用模型名"
  messages = @(
    @{ role = "user"; content = "用一句话介绍你自己" }
  )
  stream = $false
} | ConvertTo-Json -Depth 5

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

5. 配置客户端

打开客户端与编程工具配置总览，按用途选择教程：

• AI 编程 CLI：Codex、Claude Code、Gemini CLI、OpenCode；
• IDE 插件：Cline 与 Roo Code、Continue；
• 桌面客户端：Cherry Studio、Chatbox、NextChat；
• 统一管理：CC Switch；
• Windows 环境：Windows 与 WSL。

请求成功后

正常响应会包含助手回复和用量信息。你可以在控制台的 使用日志 中查看请求时间、模型、Token 用量和费用。

请求失败时，先查看故障排查。