https://github.com/1837620622/cknb-transfer-api

CKNB Transfer API - unlimited.surf 转 OpenAI/Anthropic 兼容中转，Key 池 + 代理池故障转移 + 身份白标 + 流式重试 | Node.js 服务器 + Cloudflare Worker 双部署
https://github.com/1837620622/cknb-transfer-api

ai-gateway anthropic anthropic-api api-gateway api-proxy claude claude-api claude-code cloudflare-worker llm nodejs openai openai-api proxy reverse-proxy unlimited-surf white-label

Last synced: 3 days ago
JSON representation

CKNB Transfer API - unlimited.surf 转 OpenAI/Anthropic 兼容中转，Key 池 + 代理池故障转移 + 身份白标 + 流式重试 | Node.js 服务器 + Cloudflare Worker 双部署

Host: GitHub
URL: https://github.com/1837620622/cknb-transfer-api
Owner: 1837620622
License: mit
Created: 2026-06-21T08:14:57.000Z (8 days ago)
Default Branch: main
Last Pushed: 2026-06-22T10:23:01.000Z (7 days ago)
Last Synced: 2026-06-22T12:13:16.704Z (7 days ago)
Topics: ai-gateway, anthropic, anthropic-api, api-gateway, api-proxy, claude, claude-api, claude-code, cloudflare-worker, llm, nodejs, openai, openai-api, proxy, reverse-proxy, unlimited-surf, white-label
Language: JavaScript
Size: 188 KB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# CKNB Transfer API

> 统一聚合 Claude、GPT、Gemini、DeepSeek V4 等顶级模型的通用中转服务，同时集成 **[Bad Theory Labs (BTL)](https://btl.uk)** 免费模型。提供 **OpenAI 兼容** 与 **Anthropic / Claude Code 兼容** 双协议接口，BTL 模型支持 Anthropic ↔ OpenAI 自动协议转换。自带 Key 池、代理池故障转移、指数退避重试、身份白标、流式重试，支持 **Node.js 服务器** 部署。默认模型 `gateway-claude-opus-4-8`（Claude Opus 4.8）。

中文 | [English](#english)

---

## 目录

- [功能特性](#功能特性)
- [两种部署方式对比](#两种部署方式对比)
- [方式一：Node.js 服务器部署（推荐）](#方式一nodejs-服务器部署推荐)
- [方式二：Cloudflare Worker 部署](#方式二cloudflare-worker-部署)
- [鉴权规则](#鉴权规则)
- [接口一览](#接口一览)
- [OpenAI 兼容接口](#openai-兼容接口)
- [Anthropic / Claude Code 兼容接口](#anthropic--claude-code-兼容接口)
- [可用模型](#可用模型)
- [BTL 模型特殊说明](#btl-模型特殊说明)
- [稳定性机制](#稳定性机制)
- [身份白标](#身份白标)
- [前端 Playground](#前端-playground)
- [配置项参考](#配置项参考)
- [English](#english)

---

## 功能特性

- **OpenAI 兼容**：`/v1/chat/completions`、`/v1/responses`、`/v1/models`、`/v1/files`。
- **Anthropic 兼容**：`/v1/messages`、`/v1/models`、`/anthropic/v1/messages`、`/anthropic/v1/models`。
- **Claude 模型 `/v1/messages` 直接透传上游原生接口**，完整保留 tools（工具调用）、thinking（思维链）、真实 usage、流式结构。
- **OpenAI `/v1/chat/completions` 带 tools 时自动转换到 Anthropic 协议**，返回标准 `tool_calls` 和 `finish_reason: tool_calls`。
- **Key 池**：通过伪造 `X-Forwarded-For` 自动生成多个独立 key 并轮询，规避单 key 限速；key 失效（401/429/502）自动淘汰并立即用伪造 IP 生成新 key 补充，池子持续自更新（仅服务器版）。
- **代理池故障转移**：直连上游失败时，自动通过 `proxy.scdn.io` 的免费公共代理 IP 重试（仅服务器版）。
- **流式重试 + 指数退避**：首个有效内容前出错自动换 key / 换代理重试，最多 10 次，指数退避间隔（300ms→2s）+ 随机抖动，绕过上游偶发 502 / 429 / closed-without-text / WebSocket error。
- **身份白标**：模型始终自称 `cknb-claude`，输出层自动过滤 `Claude` / `Anthropic` 等上游身份词汇。
- **原始接口代理**：`/api/*` 直接转发到上游。
- **BTL 免费模型集成**：集成 Bad Theory Labs 提供的 DeepSeek V4 Pro/Flash（**限时免费至 2026-06-28**）及 10 余个免费池模型，用量在模型列表中清晰标注到期时间和供应商标签。
- **Anthropic ↔ OpenAI 协议自动转换**：请求 BTL 模型时，Anthropic 协议 `/v1/messages` 自动转换为 OpenAI 格式 → 调用 BTL → 再将响应还原为 Anthropic 流式格式，客户端无需感知差异。
- **BTL 工具调用保护**：BTL 模型不支持 `tool_calls`，服务端自动剥离 tools 参数并注入回退提示，避免空响应。
- **双供应商模型目录**：前端模型列表为每个模型展示 **厂商**（Anthropic/OpenAI/DeepSeek/xAI 等）+ **供应商**（unlimited.surf / Bad Theory Labs），支持按协议 / 供应商 / 免费模型筛选。
- **到期倒计时显示**：限时免费模型显示 `到期倒计时：X 天 X 时 X 分`，到期自动转为不可用（红色），支持 `null` / `NaN` / `"不定期"` 等异常情况安全处理。
- **Web Search / Merge AI / Files**：分别映射到上游 `/api/search`、`/api/merge`、`/api/attachments/extract`。
- **前端 Playground**：`/app`，HTML / CSS / JS 三文件分离（`public/` 目录），浅色主题风格，支持模型选择、在线体验流式输出、思维链展示、工具调用展示、双供应商标签与到期倒计时。
- **Agent Setup / Codex / MCP**：`/v1/setup`、`/v1/codex`、`/v1/mcp`。

---

## 两种部署方式对比

| 特性 | Node.js 服务器版 | Cloudflare Worker 版 |
|------|------------------|----------------------|
| 入口文件 | `server.js` | `src/worker.js` |
| 运行环境 | 自有服务器 / VPS | Cloudflare 边缘网络 |
| Key 池（伪造 IP 轮询） | ✅ | ❌（边缘无法伪造 IP） |
| 代理池故障转移 | ✅ | ❌（边缘无需此机制） |
| 身份白标（输出层过滤） | ✅ | ❌（轻量版） |
| 流式重试 | ✅ | ❌ |
| BTL 免费模型（DeepSeek V4 等） | ✅ | ❌ |
| tools / thinking 完整保留 | ✅ | ⚠️（压扁为文本走 `/api/chat`） |
| 全球加速 | ❌ | ✅ |
| 部署难度 | 中（需服务器） | 低（一条命令） |

**选型建议**：
- 需要完整 tools / thinking / 最高稳定性 → **服务器版**
- 只需快速上线、全球加速、轻量调用 → **Worker 版**

---

## 方式一：Node.js 服务器部署（推荐）

### 1. 安装

```bash
# 需要 Node.js >= 20
git clone https://github.com/1837620622/cknb-transfer-api.git /opt/unlimited-transfer-api
cd /opt/unlimited-transfer-api
npm install
cp .env.example .env
# 编辑 .env，填入 UNLIMITED_SURF_API_KEY 及可选 BTL_API_KEY
```

`.env` 关键变量：

```text
PORT=8788
HOST=127.0.0.1
UPSTREAM_BASE_URL=https://unlimited.surf
UNLIMITED_SURF_API_KEY=ua_xxxxxxxxxxxxxxxx
DEFAULT_MODEL=gateway-claude-opus-4-8
DEFAULT_CLAUDE_MODEL=gateway-claude-opus-4-8
# 可选：WORKER_API_KEY=your-custom-client-key

# BTL (Bad Theory Labs) 免费模型配置
BTL_API_KEY=gw_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
BTL_BASE_URL=https://api.btl.uk
```

### 2. systemd 服务（开机自启 + 崩溃自动重启）

```bash
cp deploy/unlimited-transfer-api.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable --now unlimited-transfer-api
# 查看状态
systemctl status unlimited-transfer-api
# 查看日志
tail -f /var/log/unlimited-transfer-api.log
```

服务文件已配置 `Restart=always`，任何退出场景都会 5 秒后自动拉起，确保不间断运行。

### 3. nginx 反代（SSE 友好）

参考 `deploy/nginx.conf`，核心配置：

```nginx
location /ai/ {
proxy_pass http://127.0.0.1:8788/;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Connection '';
proxy_buffering off;
proxy_cache off;
proxy_read_timeout 600s;
chunked_transfer_encoding on;
}
```

### 4. 验证

```bash
curl http://your-server/ai/health
curl http://your-server/ai/v1/models
curl http://your-server/ai/v1/messages \
-H "Content-Type: application/json" \
-d '{"model":"gateway-claude-opus-4-8","max_tokens":100,"messages":[{"role":"user","content":"Hello"}]}'
```

`/health` 返回的 JSON 包含 `btl`（BTL 连接状态）、`key_pool`（Key 池状态）、`proxy_pool`（代理池状态），可监控运行状况。

---

## 方式二：Cloudflare Worker 部署

### 1. 本地 Wrangler 部署

```bash
npm install
npx wrangler login
npx wrangler secret put UNLIMITED_SURF_API_KEY # 填上游真实 key
npx wrangler secret put WORKER_API_KEY # 可选：客户端访问密钥
npx wrangler deploy -c deploy/wrangler.toml
```

### 2. 通过 GitHub 自动部署

1. 推送本项目到 GitHub 仓库。
2. Cloudflare Dashboard → `Workers & Pages` → `Create` → `Connect to Git`。
3. 选择仓库，配置：

```text
Framework preset: None
Build command: npm install
Deploy command: npx wrangler deploy -c deploy/wrangler.toml
Root directory: /
Wrangler config: deploy/wrangler.toml
```

4. 在 Worker `Settings → Variables → Secrets` 添加：
- `UNLIMITED_SURF_API_KEY` = 你的上游 key
- `WORKER_API_KEY` = 你的客户端访问密钥（可选）

### 3. 验证

```bash
curl https://.workers.dev/health
curl https://.workers.dev/v1/models \
-H "Authorization: Bearer "
```

> **注意**：Worker 版是轻量版，不支持 Key 池、代理池故障转移、身份白标、BTL 免费模型；Claude 模型的 `/v1/messages` 会压扁为文本走 `/api/chat`，不保留 tools/thinking。如需完整能力请用服务器版。

---

## 鉴权规则

```text
设置了 WORKER_API_KEY:
客户端必须传 WORKER_API_KEY
服务使用 UNLIMITED_SURF_API_KEY 请求上游

没有设置 WORKER_API_KEY:
客户端传任意 key 都可以
服务优先使用 UNLIMITED_SURF_API_KEY 请求上游
若也没有 UNLIMITED_SURF_API_KEY，则把客户端传入的 key 当作上游 key
```

---

## 接口一览

| 路径 | 方法 | 说明 |
|------|------|------|
| `/health` | GET | 健康检查 + BTL / Key 池 / 代理池状态 |
| `/v1/chat/completions` | POST | OpenAI Chat（带 tools 自动转 Anthropic） |
| `/v1/responses` | POST | OpenAI Responses |
| `/v1/models` | GET | 模型列表（OpenAI 格式） |
| `/v1/messages` | POST | Anthropic Messages（Claude 透传） |
| `/anthropic/v1/messages` | POST | Anthropic 别名 |
| `/v1/search` | POST | Web Search → 上游 `/api/search` |
| `/v1/merge` | POST | Merge AI → 上游 `/api/merge` |
| `/v1/files` | POST | 文件上传/提取 → 上游 `/api/attachments/extract` |
| `/v1/key` `/v1/usage` | GET | 上游 key / 用量查询 |
| `/v1/setup` `/v1/codex` `/v1/mcp` | GET | Agent / Codex / MCP 配置说明 |
| `/api/*` | * | 原始上游代理 |
| `/app` | GET | 前端 Playground |

---

## OpenAI 兼容接口

Base URL：`http://your-server/v1` 或 `https://.workers.dev/v1`

```bash
curl http://your-server/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"gateway-claude-opus-4-8","messages":[{"role":"user","content":"Hello"}],"stream":true}'
```

带 tools（Claude 模型自动转换协议）：

```bash
curl http://your-server/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"gateway-claude-opus-4-8","max_tokens":1024,
"messages":[{"role":"user","content":"What is the weather in Paris?"}],
"tools":[{"type":"function","function":{"name":"get_weather","description":"Get weather","parameters":{"type":"object","properties":{"city":{"type":"string"}},"required":["city"]}}}]}'
```

---

## Anthropic / Claude Code 兼容接口

Base URL：`http://your-server` 或 `https://.workers.dev`

```bash
# Claude Code
export ANTHROPIC_BASE_URL="http://your-server"
export ANTHROPIC_AUTH_TOKEN="any-key"
export ANTHROPIC_MODEL="gateway-claude-opus-4-8"
claude
```

思维链 + 工具调用：

```bash
curl http://your-server/v1/messages \
-H "Content-Type: application/json" \
-d '{"model":"gateway-claude-opus-4-8","max_tokens":4096,
"thinking":{"type":"enabled","budget_tokens":2048},
"messages":[{"role":"user","content":"What is 17*23?"}]}'
```

---

## 可用模型

模型列表由两个上游动态聚合：**unlimited.surf**（付费模型）与 **Bad Theory Labs / BTL**（免费模型），前端按 **供应商** 标签区分，自动去重。默认模型 `gateway-claude-opus-4-8`（Claude Opus 4.8），双协议统一。

### 限时免费模型（BTL）

由 BTL 补贴，当前全免费（`$0`），到期后恢复计费：

| 模型 | 到期时间 |
|------|----------|
| `deepseek-v4-pro` / `deepseek-v4-flash` | **2026-06-28**（BTL 官方 X 公告） |
| `free`（20rpm 免费池路由）| 不定期 |
| `auto`（按路由计费池）| 不定期 |
| `laguna-m.1-20260312`、`laguna-xs.2-20260421`、`owl-alpha` | 不定期 |
| `nemotron-3-nano-omni-30b-a3b-reasoning-20260428`、`nemotron-nano-12b-v2-vl`、`nemotron-nano-9b-v2` | 不定期 |
| `lfm-2.5-1.2b-instruct-20260120`、`lfm-2.5-1.2b-thinking-20260120` | 不定期 |

### 付费模型（unlimited.surf）

完整列表可通过 `GET /v1/models` 获取。常见模型包括 `gateway-gpt-5` 系列、`gateway-claude-opus-4-8` / `gateway-claude-sonnet-4` 系列、`gateway-gemini-3-pro`、`gateway-grok-4`、`gateway-qwen-3-max` 等。DeepSeek V4 系列通过 BTL 路线以 `deepseek-v4-pro` / `deepseek-v4-flash` 免费使用，无需走 unlimited.surf 付费网关。

---

## BTL 模型特殊说明

### 工具调用限制

BTL 模型（含 DeepSeek V4 系列）**不支持 `tool_calls`**。服务端在检测到 BTL 请求包含 `tools` 参数时，自动剥离所有 tool 定义，并向系统提示中注入回退说明（`[BTL 提示：当前模型不支持工具调用，请直接用文字回复]`）。即使 BTL 返回 `finish_reason: "tool_calls"`，服务端也会降级为 `finish_reason: "stop"` 并过滤空 `tool_calls` 字段，客户端不会收到破损响应。

### 协议兼容

BTL 仅提供 OpenAI 兼容接口。当客户端以 Anthropic 协议请求 BTL 模型时，服务端自动完成协议转换：
- **非流式**：Anthropic 请求体 → OpenAI 格式 → BTL → 转换回 Anthropic 响应格式
- **流式**：OpenAI SSE 事件逐个转换为 Anthropic SSE 事件（`message_start` → `content_block_delta` → `content_block_stop` → `message_delta` → `message_stop`），客户端以标准 Anthropic SDK 接收。

### 到期机制

前端模型列表对每个 BTL 模型展示 `expires` 字段，到期前 7 天显示橙色警告，到期后显示红色「已到期」标签，Playground 下拉会自动禁用到期模型。

---

## 稳定性机制

### Key 池（服务器版）

unlimited.surf 的 key 按 IP 绑定且 unlimited。服务器通过伪造 `X-Forwarded-For` 自动生成多个独立 key 并轮询使用，规避单 IP / 单 key 限速。`UNLIMITED_SURF_API_KEY` 作为兜底。

### 代理池故障转移（服务器版）

集成 [proxy.scdn.io](https://proxy.scdn.io) 免费公共代理 IP 池。当 unlimited.surf 直连失败（5xx / 网络超时）时，自动轮询最多 5 个代理 IP 重试；4xx 业务错误不转移。代理池定期刷新，失败代理自动淘汰。

### 流式重试 + 指数退避

- 非流式 `/v1/messages` 内部用流式调上游并收集 SSE，绕过上游非流式端点的不稳定。
- 首个有效内容块前出错自动换 key / 换代理重试（Anthropic 路径最多 10 次，Unlimited 路径最多 8 次）。
- **指数退避**：重试间隔 300ms→600ms→1.2s→2s（上限）+ 随机抖动，避免连续冲击上游触发限速。
- `closed-without-text`（空内容块）、`WebSocket error`、`429` 自动识别并重试；429 命中时立即淘汰当前 key。
- 一旦开始输出内容即切换到实时转发模式，不再重试（保证流式连贯）。

---

## 身份白标

服务器版内置身份白标机制，模型始终以 `cknb-claude` 身份对外：

- **系统提示词注入**：自动注入白标角色设定，引导模型自称 `cknb-claude`。
- **Assistant prefill**：对身份相关问题注入前缀补全，约束模型起手回答。
- **输出层过滤**：对返回内容做文本替换，`Claude` → `cknb-claude`、`Anthropic` → `CKNB 团队`，确保不暴露上游身份（Opus 4.8 的 RLHF 诚实约束极强，system prompt + prefill 在流式下不可靠，输出层过滤是最可靠的兜底手段）。

---

## 前端 Playground

访问 `/app`，前端采用 **HTML / CSS / JS 三文件分离** 结构，托管在 `public/` 目录：

- `public/index.html`：页面结构
- `public/app.css`：样式（浅色主题、绿色主色、胶囊按钮、卡片布局）
- `public/app.js`：交互逻辑（模型加载、在线体验、流式输出）

支持功能：

- **模型列表**：实时从 `/v1/models` 加载，每个模型展示 **厂商**（Anthropic / OpenAI / DeepSeek / xAI / Google 等）+ **供应商**（unlimited.surf / Bad Theory Labs），双胶囊标签并排显示
- **4 种筛选**：仅 Claude / 仅 OpenAI(Gateway) / 仅 BTL 免费 / 仅免费/限免，可多选，搜索框支持按 ID / 供应商 / 厂商 / 定价搜索
- **到期倒计时**：限时免费模型显示到期时间，7 天内橙色警告，到期红色标为不可用；支持 `null` / `NaN` / `"不定期"` 多种有效期格式
- **一键复制**：点击模型行任意位置复制模型 ID，URL 事件委托 + `execCommand('copy')` HTTP 兜底
- **在线体验**：选模型、输入消息、流式输出回复，Playground 自动判断协议（Anthropic vs OpenAI），BTL 模型显示 `[BTL]` / `[网关]` 前缀标签
- 思维链展示、工具调用展示

部署时把 `public/` 目录与 `server.js` 放同级，服务端自动托管静态文件。

---

## 配置项参考

### 服务器版（.env）

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `PORT` | `8787` | 监听端口（参考配置使用 8788） |
| `HOST` | `0.0.0.0` | 监听地址 |
| `UPSTREAM_BASE_URL` | `https://unlimited.surf` | unlimited.surf 上游地址 |
| `UNLIMITED_SURF_API_KEY` | - | unlimited.surf API key（必填） |
| `BTL_API_KEY` | - | BTL (Bad Theory Labs) API key（启用免费模型必填） |
| `BTL_BASE_URL` | `https://api.btl.uk` | BTL 上游地址 |
| `WORKER_API_KEY` | - | 客户端访问密钥（可选） |
| `DEFAULT_MODEL` | `gateway-claude-opus-4-8` | 默认模型（双协议统一） |
| `DEFAULT_CLAUDE_MODEL` | `gateway-claude-opus-4-8` | 默认 Claude 模型 |
| `KEY_POOL_ENABLED` | `true` | 启用 Key 池 |
| `KEY_POOL_SIZE` | `20` | Key 池大小 |
| `KEY_POOL_REFILL_THRESHOLD` | `5` | 池中有效 key 低于此值时补充 |
| `KEY_POOL_IP_BASE` | `198511000` | 伪造 IP 的基数（自增生成不同 IP） |
| `PROXY_POOL_ENABLED` | `true` | 启用代理池故障转移 |
| `PROXY_POOL_URL` | `https://proxy.scdn.io/api/get_proxy.php` | 代理池 API |
| `PROXY_POOL_PROTOCOL` | `http` | 代理协议（http/https/socks4/socks5） |
| `PROXY_POOL_FETCH_COUNT` | `20` | 每次拉取代理数 |
| `PROXY_POOL_REFRESH_MS` | `300000` | 代理池刷新间隔 |
| `PROXY_POOL_TIMEOUT_MS` | `8000` | 代理请求超时 |

### Worker 版（deploy/wrangler.toml + Secrets）

- `deploy/wrangler.toml` 的 `[vars]`：`UPSTREAM_BASE_URL`、`DEFAULT_MODEL`、`DEFAULT_CLAUDE_MODEL`
- Secrets：`UNLIMITED_SURF_API_KEY`、`WORKER_API_KEY`（可选）

---

## English

A universal transfer service that aggregates top-tier models (Claude, GPT, Gemini, DeepSeek V4, etc.) into OpenAI-compatible `/v1/*` routes and Anthropic/Claude Code-compatible `/v1/messages` routes. Integrates **[Bad Theory Labs (BTL)](https://btl.uk)** free models with automatic protocol conversion (Anthropic ↔ OpenAI). Built-in key pool, proxy failover, exponential-backoff retry, identity white-labeling, and streaming retry. Supports **Node.js server** deployment. Default model: `gateway-claude-opus-4-8`.

### Features

- OpenAI-compatible: `/v1/chat/completions`, `/v1/responses`, `/v1/models`, `/v1/files`.
- Anthropic-compatible: `/v1/messages`, `/v1/models`, `/anthropic/v1/messages`, `/anthropic/v1/models`.
- Claude `/v1/messages` passes through upstream natively, preserving tools, thinking, usage, and streaming.
- OpenAI chat with tools auto-converts to Anthropic protocol.
- Key pool: rotates multiple keys via spoofed `X-Forwarded-For` (server only).
- Proxy failover: retries via free public proxies from `proxy.scdn.io` on upstream failure (server only).
- Streaming retry with key/proxy rotation before first content.
- Identity white-label: model always identifies as `cknb-claude`; output-layer filtering strips upstream identity.
- **BTL free model integration**: DeepSeek V4 Pro/Flash (free until 2026-06-28) and 10+ free pool models from Bad Theory Labs with clear expiration labels.
- **Anthropic ↔ OpenAI protocol conversion**: BTL models auto-convert between protocols; Anthropic `/v1/messages` requests are proxied to BTL's OpenAI endpoint and responses converted back.
- **BTL tool call protection**: Server auto-strips `tools` from BTL requests to prevent empty `tool_calls` responses.
- **Dual-vendor model catalog**: Each model shows **upstream vendor** + **supplier badge** (unlimited.surf / BTL) with expiration countdown and 4 filter modes.
- Raw upstream proxy: `/api/*` forwards directly.
- Web Search / Merge AI / Files mapped to upstream endpoints.
- Playground at `/app`.

### Server deployment

```bash
git clone https://github.com/1837620622/cknb-transfer-api.git /opt/unlimited-transfer-api
cd /opt/unlimited-transfer-api
npm install
cp .env.example .env # fill in UNLIMITED_SURF_API_KEY and optionally BTL_API_KEY
cp deploy/unlimited-transfer-api.service /etc/systemd/system/
systemctl daemon-reload && systemctl enable --now unlimited-transfer-api
```

The systemd unit uses `Restart=always` for uninterrupted operation.

### Worker deployment

```bash
npm install
npx wrangler secret put UNLIMITED_SURF_API_KEY
npx wrangler deploy -c deploy/wrangler.toml
```

Note: The Worker version is lightweight — no key pool, proxy failover, identity white-label, or **BTL free model integration**; Claude `/v1/messages` is flattened to text via `/api/chat` without tools/thinking. Use the server version for full capabilities.

### Auth rules

```text
WORKER_API_KEY set: clients must send it; server uses UNLIMITED_SURF_API_KEY upstream.
WORKER_API_KEY unset: clients may send any key; server prefers UNLIMITED_SURF_API_KEY.
```

### License

MIT

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/1837620622/cknb-transfer-api

Awesome Lists containing this project

README