DigitalCats 使用文档

一个 Key，接入所有主流 AI 客户端与 SDK。对话、生图分开计费，互不干扰。

最后更新：2026-10-17 · 有疑问请联系站主或查看控制台公告

获取 API Key

1. 登录 控制台（没有账号先注册）；
2. 左侧进入 API Keys → 新建；
3. 选择分组（分组决定可用的模型与计费倍率，创建后可在控制台随时更换 Key 的分组）；
4. 复制 sk- 开头的密钥。密钥只显示一次，请妥善保存；泄露请立即删除重建。

通用接入设置

所有客户端只需要两样东西：API 地址（Base URL） 和 API Key。

接口兼容性

CC Switch（推荐）

CC Switch 是一款开源的跨平台桌面工具（Windows / macOS / Linux），统一管理 Claude Code、Codex 等 CLI 工具的供应商配置，一键切换、免改配置文件。

1. 到 GitHub Releases 下载并安装 CC Switch；
2. 打开 CC Switch，在左侧选择要配置的工具（Claude Code 或 Codex），点击「添加供应商」；
3. 填写供应商信息：
   • 名称：随意（如 DigitalCats）；
   • API 地址：https://www.digitalcats.cc（Codex 供应商建议填带 /v1 的完整地址：https://www.digitalcats.cc/v1）；
   • API Key：你的 sk- 密钥。
4. 保存后一键切换到该供应商，然后启动 Claude Code / Codex 即可；
5. 以后在多家服务商之间切换，只需打开 CC Switch 点一下，无需再改任何配置。

Codex（CLI / 桌面端）

方式一：控制台向导（推荐）

控制台 → API Keys → 对应 Key 点「使用」→ 选 Codex → 按向导复制生成的配置即可，模型目录会自动生成。

方式二：手动配置

统一 API 地址为 https://www.digitalcats.cc；Codex 的 base_url 需要显式带 /v1（下面的示例已写好）。编辑 ~/.codex/config.toml（Windows 在 %userprofile%\.codex\config.toml）：

复制# DigitalCats · Codex 接入
model_provider = "digitalcats"
model = "gpt-5.5"            # 改成你分组里的模型，如 gpt-6、gpt-5.6 等
disable_response_storage = true

[model_providers.digitalcats]
name = "DigitalCats"
base_url = "https://www.digitalcats.cc/v1"
env_key = "DIGITALCATS_API_KEY"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false

把 Key 写入环境变量（终端执行，或写进 shell 配置文件）：

复制export DIGITALCATS_API_KEY="sk-你的Key"

重启 Codex 后用 /model 切换模型。桌面端 App 读取同一份配置，改完完全退出重开即可。

Claude Code

方式一：环境变量（临时）

复制export ANTHROPIC_BASE_URL="https://www.digitalcats.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

方式二：写入配置（长期）

编辑 ~/.claude/settings.json：

复制{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.digitalcats.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

模型选择你分组内的 Claude 系列模型（如 claude-sonnet-4-6、claude-opus-4-8）。

聊天客户端（Cherry Studio / Chatbox / LobeChat / NextChat 等）

1. 设置 → 模型服务/供应商 → 新增，类型选 OpenAI 兼容；
2. API 地址填 https://www.digitalcats.cc（若客户端要求完整路径则填 https://www.digitalcats.cc/v1）；
3. API Key 填 sk-你的Key；
4. 模型列表拉取失败就手动添加模型名（以你分组内可用模型为准，可用 模型广场 查询）；
5. 保存后选择模型开始对话。

SDK 与命令行

Python（openai SDK）

复制from openai import OpenAI

client = OpenAI(
    api_key="sk-你的Key",
    base_url="https://www.digitalcats.cc/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
    stream=True,
)
for chunk in resp:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Node.js（openai SDK）

复制import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的Key",
  baseURL: "https://www.digitalcats.cc/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

curl

复制curl https://www.digitalcats.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "你好"}]
  }'

🎨 生图指引

生图走独立的「生图分组」，按张计费：1K/2K 0.04 元/张、4K 0.05 元/张（以站内公告为准），与对话分组分开计费、互不占用。可用模型：gpt-image-2（默认）、gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-1.5、gpt-image-1。

复制curl https://www.digitalcats.cc/v1/images/generations \
  -H "Authorization: Bearer sk-你的生图Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴墨镜的橘猫，扁平插画风格",
    "size": "1024x1024"
  }'

计费说明

• 对话按 token 用量 × 分组倍率计费，生图按张独立计价；
• 每个 Key 只计算其所属分组的倍率，换分组即换倍率；
• 用量明细在控制台「使用记录」实时可查；
• 各分组最新倍率与特价见 模型广场 与站内公告。

常见问题

401 / 无效密钥

检查 Key 是否复制完整、是否被删除；确认请求头为 Authorization: Bearer sk-...。

404 / 模型不存在 / 无可用账号

模型名不在当前 Key 的分组内。到模型广场确认模型名，或在控制台把 Key 换到对应分组。

502 / 服务暂时不可用

多为高峰期瞬时拥堵，稍等重试即可；持续出现请联系站主。

生图超时

生成一张图通常 30~90 秒：API 调用请把超时设为 300 秒；Codex 用户确认配置里有 tool_timeout_sec = 300。

Codex 桌面 App 升级后生图失效

App 更新可能重写配置，重新执行一次生图指引中的一键安装即可（30 秒）。

如何查余额和用量

控制台首页与「使用记录」页面可查余额、用量明细与费用。

前往控制台　查看模型广场