doubao-relay · 本地媒体网关

无 Docker，个人自用。把豆包 / 即梦 / 可灵网页额度、本机 Cursor 编剧、火山方舟等，统一为 http://127.0.0.1:8787/v1 的 OpenAI 兼容 API。
GitHub：linyf-B/local-media-gateway（仓库名；管理页与 npm 包名仍为 doubao-relay）

能做什么

• 深色 管理页：账号池、本机试生成、成片记录、实时日志、ToonFlow 插件中心
• ToonFlow：同时挂「豆包 / 即梦本地中转」生图生视频 +「Cursor 编剧」用 Composer / Claude / GPT / Gemini / Kimi 等写剧本
• 脚本 / 任意客户端：同一套 Bearer LOCAL_API_KEY 调 /v1/*

• 背景与架构
• 功能一览
• 快速开始
• 网关控制台
• ToonFlow 与 Cursor
• HTTP API
• 常用命令
• 环境变量
• 旧版文档与免责

官方火山方舟要 Key、要计费；各平台网页版又难接工作流。本项目在本机起一个网关：用你的登录态调网页能力（或内嵌即梦 SDK），再以标准 HTTP 交给 ToonFlow、脚本或其它客户端。

ToonFlow / 脚本 / 任意 OpenAI 客户端
        │  Authorization: Bearer LOCAL_API_KEY
        ▼
  :8787  doubao-relay（管理页 + /v1 API）
        ├─ 生图 / 生视频：doubao · jimeng · jimeng-api · kling · …
        ├─ 编剧 / 大模型：cursor-relay → Cursor API（订阅额度）
        └─ 豆包对话：内部 :8000 doubao-free-api（npm start 一并拉起）

环境：Node.js ≥ 22.13（见 package.json → engines）。

cd doubao
copy .env.example .env
npm run setup
npm start

打开 **http://127.0.0.1:8787**：

npm run login
npm run login:switch   # 换账号，写入账号池

顶栏进入 「网关控制台」，左侧五个子页如下。

• 方案卡片：豆包、即梦、可灵等；点选后操作当前方案
• 登录当前方案 / 换账号登录：扫码或 CDP 窗口；会话在 data/（勿用 sessionid 当 API Bearer）
• 账号池：切换、单号清冷却、删除、清空全部
• 接口：GET /admin/providers

• 与 ToonFlow 同一 HTTP 接口；显示预计消耗
• 页签：文生图 / 文生视频；@图1… 对应参考图（最多 6 张）
• 可选模型、比例；可展开 原始 JSON

• 实时同步 / 清空（清空仅前端；日志文件仍按天保留）
• 含提示词、模型、缩略图、下载

• 路径示例：data/logs/relay-YYYY-MM-DD.log
• 跟随 / 暂停 / 清空

DOUBAO_USE_CDP=1
DOUBAO_CDP_URL=http://127.0.0.1:9222

插件细节见 toonflow/README.md。

1. npm start，管理页为对应平台 登录
2. ToonFlow → 导入 toonflow/*.ts（可 检查更新）
3. API 密钥 = LOCAL_API_KEY；地址 = http://127.0.0.1:8787/v1
4. doubaorelay.ts 可指定生图/视频方案（doubao、jimeng-api、kling…），留空用 .env 默认

设置 → 模型服务 可同时启用：媒体走 豆包 / 即梦本地中转，文本走 Cursor 编剧（均指本机 8787，不填网页 SessionID）。

网关将 ToonFlow 文本请求转到 Cursor Cloud Agents API（消耗订阅额度）。生图/生视频仍用 jimeng-relay.ts 或 doubaorelay.ts。

1. 网关 .env（完整项见 .env.example）

CURSOR_API_KEY=cursor_...
CURSOR_RUNTIME=cloud

• cloud：纯文本编剧（推荐）
• local：可设 CURSOR_CWD 让 Agent 读写本地项目

2. ToonFlow 供应商

• 导入 toonflow/cursor-relay.ts
• 填 LOCAL_API_KEY + http://127.0.0.1:8787/v1（Cursor 密钥只写在网关 .env）
• 编剧任务选 Cursor 编剧 下模型

3. 查可用模型

GET http://127.0.0.1:8787/admin/cursor/models

统一鉴权：

Authorization: Bearer <LOCAL_API_KEY>

curl http://127.0.0.1:8787/v1/images/generations ^
  -H "Authorization: Bearer local-dev-key-change-me" ^
  -H "Content-Type: application/json" ^
  -d "{\"model\":\"Seedream 5.0 Lite\",\"prompt\":\"一只戴墨镜的橘猫，赛博朋克霓虹\",\"ratio\":\"16:9\"}"

多参考图：images + 提示词 @图1、@图2（网关映射占位并注入角色锁定）。

curl http://127.0.0.1:8787/v1/videos/generations ^
  -H "Authorization: Bearer local-dev-key-change-me" ^
  -H "Content-Type: application/json" ^
  -d "{\"model\":\"Seedance 2.5\",\"prompt\":\"橘猫走过霓虹街道\",\"duration\":5,\"ratio\":\"16:9\"}"

同步等待，最长约数分钟。别名：/v1/videos、/v1/video/generations。

默认与 failover 在 .env；单次请求可覆盖：

{
  "provider": "jimeng-api",
  "prompt": "@图1 为角色立绘…",
  "ratio": "16:9",
  "images": ["…"]
}

或 Header：X-Image-Provider / X-Video-Provider。

支持：doubao、jimeng、jimeng-api、kling、volcengine、openai 等。

curl http://127.0.0.1:8787/v1/chat/completions ^
  -H "Authorization: Bearer local-dev-key-change-me" ^
  -H "Content-Type: application/json" ^
  -d "{\"model\":\"doubao\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"

需 CURSOR_API_KEY。model 为 Cursor 模型名（如 composer-2.5），或加 Header 显式走路由：

curl http://127.0.0.1:8787/v1/chat/completions ^
  -H "Authorization: Bearer local-dev-key-change-me" ^
  -H "Content-Type: application/json" ^
  -H "X-Provider: cursor" ^
  -d "{\"model\":\"composer-2.5\",\"messages\":[{\"role\":\"user\",\"content\":\"写一场古风对峙戏\"}]}"

详见 .env.example。常用：

勿提交：data/、.env、vendor/**/node_modules。

• 改版前 README：docs/README.legacy.md
• 非官方接口，网页改版可能失效；仅限个人学习，勿对外商用
• 生产环境请用各平台官方 API（如 火山引擎豆包）