聪叙
发布于 2026-09-19 / 33 阅读
0
0

CC Code 用户使用文档

本文档面向平台的普通用户,介绍如何注册账号、管理额度、创建令牌(API Key)、通过 API 或客户端调用模型,以及查看用量与计费。


目录


1. 平台简介

New API 是一个 AI 接口网关与资产管理系统。它将 OpenAI、Claude、Gemini、Midjourney、Suno 等多种上游 AI 服务聚合在统一的接口后面,你只需要一个账号和一个令牌,就可以用 OpenAI 兼容的格式调用多种模型,并由平台统一完成鉴权、计费、限流和用量统计。

对你来说,使用流程非常简单:

  1. 注册 / 登录账号;

  2. 在钱包中充值或兑换额度;

  3. 创建一个令牌(sk- 开头的 API Key);

  4. 把 https://你的站点地址 当作 OpenAI 的 Base URL,配合令牌调用模型。


2. 快速上手

2.1 注册与登录

  1. 打开站点首页,点击「注册」进入注册页面。

  2. 填写用户名、密码、邮箱(目前支持邮箱有:gmail.com、163.com、126.com、qq.com、hotmail.com、icloud.com、yahoo.com)。

  3. 注册完成后自动登录;之后可通过用户名/邮箱 + 密码登录。

忘记密码时,点击登录页的「忘记密码」,通过邮箱接收重置链接完成密码重置。

2.2 三步完成第一次调用

第一步:确认余额。 登录后进入「钱包」页面查看当前额度。新用户有站点赠送的初始额度(0.5 CNY)。

第二步:创建令牌。 进入「令牌」页面,点击「添加令牌」,填写名称后保存,复制生成的 sk- 开头的密钥(详见第 5 节)。

第三步:发起请求。 以 OpenAI 兼容格式调用,把 Base URL 换成你的站点地址:

curl https://你的站点地址/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "你好"}]
  }'

也可以在控制台「游乐场(Playground)」里直接选择想测试的分组以及模型进行对话测试,无需写代码(见第 8 节)。


3. 账号管理

登录后点击右上角头像进入「个人资料」(/profile),可管理以下内容:

  • 基本信息:头像、用户名、邮箱等;

  • 系统访问令牌:生成用于访问个人管理接口的 access token(区别于调用模型的 sk- 令牌);

  • 安全设置:

    • Passkey:注册通行密钥用于免密登录和敏感操作验证;

    • 两步验证(2FA):绑定 TOTP 验证器(如 Google Authenticator),并可生成备用恢复码;

    • 登录设备管理:查看当前所有登录会话,一键退出其他设备;

  • 邀请与收益:查看邀请码(aff),通过邀请获得的奖励可转入余额。

  • 每日签到:每日签到领取随机额度。


4. 额度与钱包

4.1 额度单位

本平台参考官方模型价格均以美元计费,为方便管理与计算,本平台基础设置基础优惠为 中美比例 1:1。及平台所有模型有0.14倍率优惠。

平台内部以「额度(quota)」计费,默认 500,000 额度 = $1(站点可在设置中改为以人民币等币种显示)。每次调用模型后,按模型的计价比率和实际消耗的 token 数(或图片张数、视频时长等)从你的余额中扣费。

4.2 充值与兑换

在「钱包」(/wallet)页面可以进行:

  • 在线充值(暂未开通):选择充值金额,通过站点配置的支付渠道付款(易支付、Stripe、Creem 等,以页面显示为准);

  • 兑换码充值:可以在钱包页面或https://catfk.com/shop/cc.code购买。在钱包页或「兑换码」页面输入兑换码,将码内额度充入余额;

  • 邀请奖励划转:把推广奖励额度转入可用余额;

  • 订阅套餐:如果站点开放了订阅计划,可以按周期购买套餐额度;

  • 每日签到:如果站点开启了签到功能,可每日领取少量额度。

4.3 计费方式速览

不同模型的计费方式不同,常见规则如下(具体价格以「模型定价」页为准):

类型

计费方式

对话 / 补全 / Embedding

按输入、输出 token 数计费(部分模型区分缓存命中价格)

图片生成

按生成张数和分辨率 / 质量计费

视频生成

按任务时长(秒)或次数计费

语音(TTS / 转写)

按字符数或音频时长计费

Rerank / 审核等

按次或按 token 计费

调用失败(上游报错、参数校验不通过等)不扣费;已预扣的额度会退回。


5. 令牌(API Key)管理

令牌是你调用 API 的凭证,格式为 sk- + 随机字符串。进入「令牌」(/keys)页面管理:

5.1 创建令牌

点击「添加令牌」,可配置以下选项:

选项

说明

名称

便于自己识别的备注,例如「Cherry Studio」「测试用」

过期时间

默认永不过期;可设置一个截止时间,到期自动失效

额度

默认「无限额度」(跟随账户余额);也可设为固定额度,令牌消耗完即停用,适合做预算隔离

模型限制

开启后只允许该令牌调用指定的模型列表

分组

指定令牌走哪个分组(不同分组可能对应不同价格,如国产模型分组2.2倍率,即2.2✖️0.14(基础优惠)=0.308倍率,也就是官方价格的0.308倍,如GPT·Codex系列特价|0.12x分组。也就是0.12✖️0.14=0.0168倍率,也就是官方价格的0.0168倍价格);

IP 白名单

填写允许调用该令牌的 IP,留空不限制

创建后立即复制并妥善保存密钥。列表中只显示掩码形式,需要时可通过「复制/查看」操作重新获取完整密钥。

5.2 令牌安全建议

  • 不要把令牌提交进代码仓库或分享给他人;泄露后在令牌页点「删除」即可立即作废;

  • 不同用途创建不同令牌:配合「固定额度 + 模型限制 + IP 白名单」,可以把泄露的影响降到最低;

  • 长期不用的令牌及时删除或设为过期。


6. 调用 API

6.1 通用约定

  • Base URL:https://你的站点地址(不带路径),接口路径与官方一致;

  • 鉴权:Authorization: Bearer sk-你的令牌(Claude 格式用 x-api-key,Gemini 格式用 x-goog-api-key 或 ?key=);

  • 模型列表:GET /v1/models 返回你当前可用分组下的全部模型,网页端「模型」页(/models)也可查看。

6.2 支持的接口族

平台兼容多套主流 API 协议,常见端点包括:

协议 / 功能

端点示例

OpenAI 对话

POST /v1/chat/completions

OpenAI 补全

POST /v1/completions

OpenAI Responses

POST /v1/responses

Embedding

POST /v1/embeddings

图片生成 / 编辑

POST /v1/images/generations、/v1/images/edits

语音合成 / 转写

POST /v1/audio/speech、/v1/audio/transcriptions

实时对话(Realtime)

GET /v1/realtime(WebSocket)

Claude Messages

POST /v1/messages

Gemini

/v1beta/models/{model}:generateContent 等

Rerank

POST /v1/rerank

审核

POST /v1/moderations

Midjourney

/mj/submit/imagine 等

Suno 音乐

/suno/submit/music 等

视频任务

POST /v1/videos、GET /v1/videos/{task_id}

文件

POST /v1/files、GET /v1/files/{id}

可用模型及其分组取决于站点接入的渠道;调用未授权的模型会返回权限错误。

6.3 常用调用示例

OpenAI SDK(Python)

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的令牌",
    base_url="https://你的站点地址/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
    stream=True,
)
for chunk in resp:
    print(chunk.choices[0].delta.content or "", end="")

Claude(Anthropic 格式)

curl https://你的站点地址/v1/messages \
  -H "x-api-key: sk-你的令牌" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

Gemini

curl "https://你的站点地址/v1beta/models/gemini-2.5-pro:generateContent?key=sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"parts": [{"text": "你好"}]}]}'

图片生成

curl https://你的站点地址/v1/images/generations \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model": "dall-e-3", "prompt": "一只在月球上喝咖啡的猫", "n": 1, "size": "1024x1024"}'

6.4 流式输出与重试

  • 支持 stream: true 的 SSE 流式返回;计费在流结束后按实际 token 结算;

  • 令牌选择 auto 分组并开启跨分组重试时,渠道失败可自动切换到其他分组重试;

  • 建议在客户端设置合理超时,并对 429 / 5xx 做指数退避重试。


7. 在第三方客户端中使用

大多数支持自定义 OpenAI Base URL 的客户端都可以直接接入,通用配置:

  • API 地址 / Base URL:https://你的站点地址(部分客户端要求带 /v1)

  • API Key:你的 sk- 令牌

  • 模型:填「模型」页中列出的任意模型名

常见客户端示例:

客户端

配置要点

Cherry Studio

添加「OpenAI 兼容」提供商,填 Base URL 和 Key

Chatbox / NextChat

自定义接口地址 + Key

Cursor / Cline 等 IDE 插件

选择 OpenAI Compatible,填 Base URL 和 Key

Claude Code 等

将 ANTHROPIC_BASE_URL 指向站点,ANTHROPIC_AUTH_TOKEN 填令牌

LangChain / LlamaIndex

使用 OpenAI 兼容端点配置


8. 控制台功能一览

登录后顶部 / 侧边导航中的主要页面:

页面

路径

作用

仪表盘

/dashboard

余额、消耗趋势、模型用量分布等统计图表

模型

/models

查看你可用的模型列表与说明

模型定价

/pricing

查看各模型的计费比率(无需登录也可查看,取决于站点设置)

令牌

/keys

创建和管理 API Key

钱包

/wallet

充值、兑换码、订阅、签到、邀请收益

使用日志

/usage-logs

逐条查看调用记录:模型、token 数、费用、耗时、IP 等

操练场

/playground

网页内直接对话测试模型

聊天

/chat

内置对话应用(如站点开启)

创作中心

/creation

图片工作室、视频工作室、画布等生成类工具(如站点开启)

排行榜

/rankings

站点用量 / 模型热度排行(如站点开启)

个人设置

/profile

账号、安全、第三方绑定、邀请码

关于 / 公告

/about

站点公告与说明


9. 常见问题

Q:令牌复制后还能再看到完整密钥吗?
A:列表默认显示掩码。可通过令牌的「复制密钥」操作重新获取完整 sk- 密钥;如果担心泄露,直接删除重建更稳妥。

Q:为什么返回「无可用渠道」或「模型不可用」?
A:说明当前分组下没有提供该模型的渠道,或令牌开启了模型限制但未包含该模型。换一个可用模型、调整令牌的分组/模型限制,或联系管理员。

Q:扣费是怎么算的?
A:按实际消耗结算:对话类按输入/输出 token × 模型比率;图片按张数与规格;视频按时长。每次调用的明细可在「使用日志」中查看。

Q:调用失败会扣钱吗?
A:不会。失败请求的预扣额度会自动退回;如对某条记录有疑问,可在日志中核对或联系管理员。

Q:余额为负 / 不足时会怎样?
A:请求会在预扣费阶段被拒绝(余额不足错误)。请及时充值;固定额度的令牌消耗完后同样会拒绝请求。

Q:如何限制某个令牌的调用范围?
A:创建/编辑令牌时设置模型限制、固定额度、过期时间和 IP 白名单即可。

Q:如何查看每天的消耗趋势?
A:「仪表盘」页提供按时间 / 模型维度的统计图表;「使用日志」页支持按令牌、模型、时间筛选导出明细。

Q:忘记密码怎么办?
A:在登录页使用「忘记密码」,通过绑定邮箱接收重置邮件。未绑定邮箱请联系站点管理员协助重置。



评论