快速开始
本站实现 OpenAI 兼容协议,任何支持自定义 Base URL 的客户端都能直接用。三步:
- 在 控制台 注册并复制一个
sk-令牌 - 把 Base URL 设为
/v1 - 模型填
deepseek-flash(通用·多模态)或deepseek-v4-pro(深度推理)
认证方式
所有请求都需要带令牌,支持两种写法(任选其一):
Authorization: Bearer sk-你的令牌 x-api-key: sk-你的令牌
令牌在服务端只用于校验和记账;余额不足时返回
402,不会转发到上游、不会产生费用。接口列表
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/chat/completions | 对话补全,支持流式 |
| GET | /v1/models | 列出可用模型 |
| GET | /v1/user/balance | 查询当前令牌的 g币余额 |
| GET | /healthz | 存活检查(无需认证) |
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
| model | string | deepseek-flash / deepseek-v4-pro;旧名 deepseek-chat、deepseek-reasoner 仍可用,服务端自动映射 |
| effort | string | low / high / max,控制推理投入力度(默认 high) |
| messages | array | 标准 OpenAI 格式,role + content;
flash 支持 image_url 图片输入 |
| stream | bool | 是否流式返回,默认 false |
| temperature | number | 0–2,默认 1 |
| max_tokens | int | 输出上限 |
| top_p | number | 核采样 |
| stop | string/array | 停止词 |
| response_format | object | {"type":"json_object"} 强制 JSON |
| jailbreak_level | int | 本站扩展:破甲等级 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,便于你本地对账。
错误码
| HTTP | type | 含义 / 处理 |
|---|---|---|
| 401 | auth_error | 未带 Key 或 Key 无效,检查令牌 |
| 402 | insufficient_quota | g币余额不足,去控制台兑换充值 |
| 403 | auth_error | 令牌或账号被停用 |
| 429 | rate_limit / concurrency_limit | 超出 RPM 或并发上限,退避重试 |
| 502 | upstream_error | 上游失败(已自动换 Key 重试过),稍后重试 |
| 503 | upstream_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 / Continue | override base URL 为本站 /v1,provider 选 openai |
| Anthropic SDK | 上游模型声明支持 messages 协议;本站当前以 OpenAI 协议为准,Anthropic 原生端点暂未开放 |
限流与并发
- 令牌级 RPM 与并发上限由管理员配置,超限返回
429 - 流式请求占用一个并发名额,结束后释放;客户端断开会立即释放
- 网关不缓存响应体,SSE 逐帧转发
常见问题
为什么返回 402?
余额 ≤ 0。到控制台「充值 g币」输入兑换码即可,兑换码由管理员发放。
用旧模型名还能跑吗?
可以。deepseek-chat 会映射到 deepseek-flash,deepseek-reasoner 映射到
deepseek-v4-pro,客户端不用改。
上下文和输出上限?
两个模型都是 1M 上下文、最长 393K 输出;flash 额外支持图片输入。
能不能关掉破甲?
可以,请求体加 "jailbreak_level": 0,行为与直连上游一致。
并发高了会怎样?
超过令牌并发上限返回 429(concurrency_limit),降低并发或找管理员提额。