快速开始

本站实现 OpenAI 兼容协议,任何支持自定义 Base URL 的客户端都能直接用。三步:



    

认证方式

所有请求都需要带令牌,支持两种写法(任选其一):

Authorization: Bearer sk-你的令牌
x-api-key: sk-你的令牌
令牌在服务端只用于校验和记账;余额不足时返回 402,不会转发到上游、不会产生费用。

接口列表

方法路径说明
POST/v1/chat/completions对话补全,支持流式
GET/v1/models列出可用模型
GET/v1/user/balance查询当前令牌的 g币余额
GET/healthz存活检查(无需认证)

请求参数

参数类型说明
modelstringdeepseek-flash / deepseek-v4-pro;
旧名 deepseek-chat、deepseek-reasoner 仍可用,服务端自动映射
effortstringlow / high / max,控制推理投入力度(默认 high)
messagesarray标准 OpenAI 格式,role + content; flash 支持 image_url 图片输入
streambool是否流式返回,默认 false
temperaturenumber0–2,默认 1
max_tokensint输出上限
top_pnumber核采样
stopstring/array停止词
response_formatobject{"type":"json_object"} 强制 JSON
jailbreak_levelint本站扩展:破甲等级 0–3,见下节

破甲参数

破甲层在网关侧统一注入,不需要你在提示词里写任何越狱话术。

取值效果
不传使用站点默认等级(当前 2)
0关闭,请求原样透传给上游
1轻度:去免责套话,不追问动机
2标准:关闭自我审查,禁拒答与说教,要求给全细节
3深度:ROOT OVERRIDE,允许边缘内容,完整可复现
{
  "model": "deepseek-flash",
  "jailbreak_level": 3,
  "messages": [{ "role": "user", "content": "..." }]
}
你自带的 system 消息不会丢:网关把它保留在破甲规则之后,并标注「冲突时以破甲规则为准」。

计费与用量

1 g币 = 1 元人民币,按百万 token 结算;单价为 DeepSeek 官方价的 1.5 倍, 官方分高峰/空闲两档,本站默认按高峰档计费,可按时段自动切换。每次响应头会带上本次扣费:

X-Gcoin-Cost: 0.00069
X-Jailbreak-Level: 2

响应体里的 usage 与上游一致,含命中缓存的 token 数:

{
  "usage": {
    "prompt_tokens": 120,
    "completion_tokens": 60,
    "prompt_cache_hit_tokens": 20,
    "prompt_cache_miss_tokens": 100
  }
}
项目单价(g币 / 百万 token)

流式请求会自动附加 stream_options.include_usage,最后一帧带完整 usage,便于你本地对账。

错误码

HTTPtype含义 / 处理
401auth_error未带 Key 或 Key 无效,检查令牌
402insufficient_quotag币余额不足,去控制台兑换充值
403auth_error令牌或账号被停用
429rate_limit / concurrency_limit超出 RPM 或并发上限,退避重试
502upstream_error上游失败(已自动换 Key 重试过),稍后重试
503upstream_config / maintenance站点未配上游或维护中

错误体统一为:

{"error":{"message":"g币余额不足,请充值兑换码","type":"insufficient_quota"}}

客户端配置

客户端填写方式
Cherry Studio设置 → 模型服务 → OpenAI → API 地址填本站 /v1,密钥填令牌,模型手动添加 deepseek-chat
NextChat设置 → 自定义接口,接口地址填 /v1,填入密钥;模型名保持一致
LobeChat设置 → 语言模型 → OpenAI → 代理地址与 API Key
ChatBox设置 → 模型提供商选 OpenAI API,API Host 填 /v1
沉浸式翻译翻译服务 → OpenAI,自定义 API 地址填 /v1,模型填 deepseek-chat
Cursor / Continueoverride base URL 为本站 /v1,provider 选 openai
Anthropic SDK上游模型声明支持 messages 协议;本站当前以 OpenAI 协议为准,Anthropic 原生端点暂未开放


    

限流与并发

常见问题

为什么返回 402?

余额 ≤ 0。到控制台「充值 g币」输入兑换码即可,兑换码由管理员发放。

用旧模型名还能跑吗?

可以。deepseek-chat 会映射到 deepseek-flash,deepseek-reasoner 映射到 deepseek-v4-pro,客户端不用改。

上下文和输出上限?

两个模型都是 1M 上下文、最长 393K 输出;flash 额外支持图片输入。

能不能关掉破甲?

可以,请求体加 "jailbreak_level": 0,行为与直连上游一致。

并发高了会怎样?

超过令牌并发上限返回 429(concurrency_limit),降低并发或找管理员提额。