commit 4b9feda083abd89779f7c9c4025c26a50e825b80 Author: jinghui <181050043@qq.com> Date: Mon Oct 26 18:11:59 2026 +0800 封面AI助手:AI生图/AI重画/素材库,走omniroute+cheaperinference,零依赖单文件Node diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..1c1662d --- /dev/null +++ b/.gitignore @@ -0,0 +1,9 @@ +# 密钥:绝不入库(容器用 -e OMNI_KEY 注入) +.apikey +.env + +# 生成物 +gallery/ +gallery.json +node_modules/ +*.log diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..6f094c7 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,6 @@ +FROM node:20-alpine +WORKDIR /app +COPY server.js ui.html ./ +ENV PORT=3000 DATA=/data +EXPOSE 3000 +CMD ["node","server.js"] diff --git a/README.md b/README.md new file mode 100644 index 0000000..2c42c69 --- /dev/null +++ b/README.md @@ -0,0 +1,67 @@ +# 封面 AI 助手 · cover-ai + +给封面/配图用的 AI 生图与修图服务。零依赖单文件 Node + 一个 HTML 页面,Docker 一条命令跑起来, +模型走自建 omniroute 网关(OpenAI 兼容)里的 `cheaperinference` 通道。 + +典型用法:做公众号/知乎/头条/小红书/B站封面时缺一张配图,或者拿一张参考图要求「换个背景、保留主体」。 + +--- + +## 一、能力 + +| 页签 | 做什么 | 实现 | +|---|---|---| +| AI 生图 | 文字描述 → 图,可选尺寸/模型,一次出 1 张,可连点 | `POST /v1/images/generations`(`cheaperinference/grok-imagine`,约 10–20s) | +| AI 修图 | 上传一张图 + 改图要求 → 新图,左右对比看效果 | 视觉模型 `cheaperinference/deepseek-v4-flash-vision-exp` 先读出原图内容 → grok-imagine 重画 | +| 素材库 | 历史生成图,可预览/下载/删除 | 本地 `gallery/` 目录 + `gallery.json` 元数据 | + +出图后可直接:下载、**按平台精确尺寸居中裁切**(浏览器 canvas 完成,不额外消耗算力)、复制直链。 + +## 二、为什么"修图"是重画而不是像素级修 + +真·像素级修图要走 `/v1/images/edits` + `nano-banana-2`,实测两个硬限制: +1. omniroute 对**所有内置 provider** 硬拦 edits(`Image edit is not supported for built-in provider`),只允许 adobe-firefly / syntx / codex / 自定义 OpenAI 兼容通道 +2. 能真修图的 `cheaperinference/nano-banana-2/-pro` 当前 402 余额不足 + +所以当前实现走「看图 → 出中文描述 → 重画」,构图和配色跟随原图,但不是像素级。 +想升级成真修图有两条路(代码已就绪): +- 给 Cheaper Inference 钱包充值 → `nano-banana-2` 直接可用 +- 在 omniroute 加一个「自定义 OpenAI 兼容图像通道」(baseUrl `https://api.cheaperinference.com/v1` + 同一个 key)→ edits 会被转发 + +## 三、接口 + +``` +GET / UI(单页) +GET /api/health 健康检查 + 网关连通性 +POST /api/gen {prompt, size, model} → 生成 +POST /api/redraw {image(dataURL|base64), prompt, size, model} → 重画 +POST /api/edit {image, prompt} → 真·修图(当前网关不支持,返回明确原因) +GET /api/gallery → 历史图列表 +DELETE /api/gallery/:name → 删图 +GET /img/:name → 取图(供编辑器跨端口反代) +``` + +同源问题:快图设计(8126)通过 `/ai-img/*` 反代本服务的 `/img/*`,避免画布 canvas 被跨域污染。 + +## 四、跑起来 + +```bash +docker build -t cover-ai:1.0 . +docker run -d --name cover-ai --restart always --memory 384m -p 8128:3000 \ + -v $PWD:/data \ + -e OMNI_KEY= \ + -e OMNI_BASE=http://:20139/v1 \ + -e PUBLIC_BASE=http://<本机地址>:8128 \ + cover-ai:1.0 +``` + +- key 通过环境变量注入,**不进镜像、不进仓库**(`.apikey` 已在 `.gitignore` 里) +- `server.js` / `ui.html` 是 COPY 进镜像的,改完要重新 `docker build` +- 生成图落在 `/data/gallery/`(宿主目录),容器删了图还在 + +## 五、为什么这么写(几个刻意的选择) + +- **零依赖**:只用 Node 内置 `http`/`fetch`,不装 express、不带 `node_modules`,镜像几十 MB,构建 3 秒 +- **不做用户体系**:内网单用户工具,加登录只会让"笨用户"用不了 +- **裁切在前端做**:模型返回的尺寸是近似的(要 720×1280 实际可能回 864×1152),用 canvas 居中裁切才能拿到平台精确规格,且不额外花钱 +- **中文提示词兜底**:服务端固定追加「不要出现文字/水印」「主体占画面主要面积」等约束,减少脏图 diff --git a/server.js b/server.js new file mode 100644 index 0000000..4866b57 --- /dev/null +++ b/server.js @@ -0,0 +1,266 @@ +/* 封面 AI 助手 · 生图 / 修图 服务(零依赖 Node) + * 模型统一走 omniroute(OpenAI 兼容),默认 cheaperinference 渠道。 + * 环境变量:PORT / DATA / OMNI_BASE / OMNI_KEY / PUBLIC_BASE + */ +const http = require('http'); +const fs = require('fs'); +const path = require('path'); +const crypto = require('crypto'); + +const PORT = parseInt(process.env.PORT || '3000', 10); +const DATA = process.env.DATA || '/data'; +const OMNI_BASE = (process.env.OMNI_BASE || 'http://192.168.68.19:20139/v1').replace(/\/+$/, ''); +const OMNI_KEY = process.env.OMNI_KEY || ''; +const PUBLIC_BASE = (process.env.PUBLIC_BASE || 'http://192.168.68.19:8128').replace(/\/+$/, ''); +const GALLERY = path.join(DATA, 'gallery'); +const META = path.join(DATA, 'gallery.json'); + +fs.mkdirSync(GALLERY, { recursive: true }); + +/* ---------------- 模型表 ---------------- */ +const GEN_MODELS = [ + { id: 'cheaperinference/grok-imagine', name: 'Grok Imagine(cheaperinference)· 约 10 秒', ok: true, note: '主力:文生图,速度快' }, + { id: 'cheaperinference/nano-banana-2', name: 'Nano Banana 2(cheaperinference)· 质量更高', ok: false, note: '当前 402 余额不足,充值后自动可用' }, + { id: 'cheaperinference/nano-banana-pro', name: 'Nano Banana Pro(cheaperinference)· 最强', ok: false, note: '当前 402 余额不足,充值后自动可用' }, + { id: 'nvidia/black-forest-labs/flux.1-dev', name: 'FLUX.1-dev(备用通道)· 约 80 秒', ok: true, note: '备用:慢但可用' }, +]; +const EDIT_MODEL = 'cheaperinference/nano-banana-2'; // 真·修图(需余额) +const VISION_MODEL = 'cheaperinference/deepseek-v4-flash-vision-exp'; // 重绘用:先看图再重画 + +const SIZES = { + '900x383': '公众号封面 900×383', + '1080x1440': '小红书 1080×1440', + '1200x675': '知乎 1200×675', + '1280x720': '头条 / 横版 1280×720', + '1146x717': 'B站 1146×717', + '1024x1024': '方形 1024×1024', + '1080x1920': '竖版海报 1080×1920', +}; + +/* ---------------- 工具 ---------------- */ +const j = (res, code, obj) => { + const body = JSON.stringify(obj); + res.writeHead(code, { 'Content-Type': 'application/json; charset=utf-8', 'Access-Control-Allow-Origin': '*' }); + res.end(body); +}; + +function readBody(req, limit = 30 * 1024 * 1024) { + return new Promise((resolve, reject) => { + let size = 0; const chunks = []; + req.on('data', c => { + size += c.length; + if (size > limit) { reject(new Error('payload too large')); req.destroy(); return; } + chunks.push(c); + }); + req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8'))); + req.on('error', reject); + }); +} + +function loadMeta() { + try { return JSON.parse(fs.readFileSync(META, 'utf8')); } catch { return []; } +} +function addMeta(item) { + const list = loadMeta(); + list.unshift(item); + fs.writeFileSync(META, JSON.stringify(list.slice(0, 500), null, 1)); +} + +function dataUrlToBuffer(dataUrl) { + const m = /^data:([^;]+);base64,(.+)$/.exec(dataUrl || ''); + if (!m) return null; + return { mime: m[1], buf: Buffer.from(m[2], 'base64') }; +} + +function saveImage(buf, ext = 'jpg', tag = 'ai') { + const name = `${Date.now().toString(36)}-${crypto.randomBytes(4).toString('hex')}.${ext}`; + fs.writeFileSync(path.join(GALLERY, name), buf); + return name; +} + +function galleryItem(m) { + return { ...m, url: `${PUBLIC_BASE}/img/${m.name}` }; +} + +async function omni(pathname, payload, timeoutMs = 180000) { + const ctrl = new AbortController(); + const t = setTimeout(() => ctrl.abort(), timeoutMs); + try { + const r = await fetch(`${OMNI_BASE}${pathname}`, { + method: 'POST', + headers: { Authorization: `Bearer ${OMNI_KEY}`, 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + signal: ctrl.signal, + }); + const text = await r.text(); + let body; try { body = JSON.parse(text); } catch { body = { raw: text.slice(0, 400) }; } + return { status: r.status, body }; + } finally { clearTimeout(t); } +} + +function explainError(status, body) { + const msg = (body && body.error && (body.error.message || body.error)) || ''; + const s = String(msg); + if (status === 402 || /insufficient|balance|billing/i.test(s)) return '该图像模型余额不足(402),omniroute 的 cheaperinference 钱包需要充值后才能用;现在可用 Grok Imagine。'; + if (/edit is not supported/i.test(s)) return 'omniroute 内置 cheaperinference 通道不转发 /images/edits(真·修图需要 nano-banana + 余额,或给网关加自定义 OpenAI 兼容图像通道)。'; + if (status === 401) return 'omniroute 鉴权失败(API key 无效)。'; + if (status === 502 || /ECONNRESET|fetch failed/i.test(s)) return '上游通道连接失败,换一个模型或稍后重试。'; + return s || `请求失败(HTTP ${status})`; +} + +/* ---------------- 生成 ---------------- */ +async function generate({ prompt, size = '1280x720', model = GEN_MODELS[0].id, n = 1 }) { + const r = await omni('/images/generations', { model, prompt, size, n }); + if (r.status !== 200) return { ok: false, status: r.status, error: explainError(r.status, r.body) }; + const items = (r.body.data || []).map(it => { + if (it.b64_json) return Buffer.from(it.b64_json, 'base64'); + return null; + }).filter(Boolean); + const out = []; + for (const buf of items) { + const name = saveImage(buf, buf[0] === 0xFF && buf[1] === 0xD8 ? 'jpg' : 'png'); + const rec = { name, model, size, prompt, created: new Date().toISOString(), kind: 'gen' }; + addMeta(rec); + out.push(galleryItem(rec)); + } + return { ok: true, images: out }; +} + +async function describe(dataUrl) { + const r = await omni('/chat/completions', { + model: VISION_MODEL, + messages: [{ + role: 'user', + content: [ + { type: 'text', text: '用中文客观描述这张图片:主体是什么、构图与留白位置、主色调、风格(扁平/写实/3D)。200 字以内,不要评价。' }, + { type: 'image_url', image_url: { url: dataUrl } }, + ], + }], + max_tokens: 400, + }, 120000); + if (r.status !== 200) return { ok: false, error: explainError(r.status, r.body) }; + const txt = r.body?.choices?.[0]?.message?.content || ''; + return { ok: true, text: txt.trim() }; +} + +/* ---------------- 路由 ---------------- */ +const server = http.createServer(async (req, res) => { + const u = new URL(req.url, 'http://localhost'); + const p = u.pathname; + + if (req.method === 'OPTIONS') { + res.writeHead(204, { 'Access-Control-Allow-Origin': '*', 'Access-Control-Allow-Headers': '*', 'Access-Control-Allow-Methods': 'GET,POST,DELETE,OPTIONS' }); + return res.end(); + } + + try { + if (p === '/' || p === '/index.html') { + const html = fs.readFileSync(path.join(__dirname, 'ui.html'), 'utf8'); + res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' }); + return res.end(html); + } + + if (p === '/api/health') { + return j(res, 200, { ok: true, models: GEN_MODELS.map(m => ({ id: m.id, ok: m.ok })), editModel: EDIT_MODEL, visionModel: VISION_MODEL, sizes: SIZES }); + } + + if (p === '/api/models') return j(res, 200, { gen: GEN_MODELS, editModel: EDIT_MODEL }); + + if (p === '/api/gallery') { + const list = loadMeta().map(galleryItem); + const type = u.searchParams.get('type'); + return j(res, 200, { items: type ? list.filter(x => x.kind === type) : list }); + } + + if (p.startsWith('/api/gallery/') && req.method === 'DELETE') { + const name = path.basename(p.slice('/api/gallery/'.length)); + try { fs.unlinkSync(path.join(GALLERY, name)); } catch {} + fs.writeFileSync(META, JSON.stringify(loadMeta().filter(x => x.name !== name), null, 1)); + return j(res, 200, { ok: true }); + } + + if (p.startsWith('/img/')) { + const name = path.basename(p.slice(5)); + const f = path.join(GALLERY, name); + if (!fs.existsSync(f)) return j(res, 404, { error: 'not found' }); + const ext = path.extname(f).toLowerCase(); + res.writeHead(200, { + 'Content-Type': ext === '.png' ? 'image/png' : 'image/jpeg', + 'Cache-Control': 'public, max-age=86400', + 'Access-Control-Allow-Origin': '*', + }); + return fs.createReadStream(f).pipe(res); + } + + if (p === '/api/gen' && req.method === 'POST') { + const b = JSON.parse(await readBody(req) || '{}'); + if (!b.prompt) return j(res, 400, { ok: false, error: '缺少提示词' }); + const r = await generate(b); + return j(res, r.ok ? 200 : 502, r); + } + + if (p === '/api/describe' && req.method === 'POST') { + const b = JSON.parse(await readBody(req) || '{}'); + const img = dataUrlToBuffer(b.image); + if (!img) return j(res, 400, { ok: false, error: '缺少图片' }); + const r = await describe(b.image); + return j(res, r.ok ? 200 : 502, r); + } + + // AI 重绘:看图 → 生成描述 → 按用户要求重新生成(当前唯一可用的"改图"链路) + if (p === '/api/redraw' && req.method === 'POST') { + const b = JSON.parse(await readBody(req) || '{}'); + if (!dataUrlToBuffer(b.image)) return j(res, 400, { ok: false, error: '缺少图片' }); + const d = await describe(b.image); + if (!d.ok) return j(res, 502, d); + const prompt = [ + d.text, + b.prompt ? `在此基础上按要求修改:${b.prompt}` : '', + '画面干净、主体清晰并占据画面主要面积、主体与背景对比明显。', + '不要在图中出现任何文字、字母、数字或水印。', + ].filter(Boolean).join('\n'); + const r = await generate({ prompt, size: b.size, model: b.model || GEN_MODELS[0].id }); + if (r.ok) r.described = d.text; + return j(res, r.ok ? 200 : 502, r); + } + + // 真·修图:转发 /images/edits(需要支持 edits 的模型/通道,如 nano-banana + 余额) + if (p === '/api/edit' && req.method === 'POST') { + const b = JSON.parse(await readBody(req) || '{}'); + const img = dataUrlToBuffer(b.image); + if (!img) return j(res, 400, { ok: false, error: '缺少图片' }); + const form = new FormData(); + form.append('model', b.model || EDIT_MODEL); + form.append('prompt', b.prompt || ''); + form.append('image', new Blob([img.buf], { type: img.mime }), 'source.' + (img.mime.includes('png') ? 'png' : 'jpg')); + if (b.size) form.append('size', b.size); + const ctrl = new AbortController(); + const t = setTimeout(() => ctrl.abort(), 180000); + let r; + try { + const resp = await fetch(`${OMNI_BASE}/images/edits`, { + method: 'POST', headers: { Authorization: `Bearer ${OMNI_KEY}` }, body: form, signal: ctrl.signal, + }); + const text = await resp.text(); + let body; try { body = JSON.parse(text); } catch { body = { raw: text.slice(0, 300) }; } + r = { status: resp.status, body }; + } finally { clearTimeout(t); } + if (r.status !== 200) return j(res, 502, { ok: false, status: r.status, error: explainError(r.status, r.body) }); + const out = []; + for (const it of (r.body.data || [])) { + if (!it.b64_json) continue; + const buf = Buffer.from(it.b64_json, 'base64'); + const name = saveImage(buf, buf[0] === 0xFF && buf[1] === 0xD8 ? 'jpg' : 'png'); + const rec = { name, model: b.model || EDIT_MODEL, size: b.size || '', prompt: b.prompt || '', created: new Date().toISOString(), kind: 'edit' }; + addMeta(rec); out.push(galleryItem(rec)); + } + return j(res, 200, { ok: true, images: out }); + } + + return j(res, 404, { error: 'not found' }); + } catch (e) { + return j(res, 500, { ok: false, error: String(e.message || e) }); + } +}); + +server.listen(PORT, '0.0.0.0', () => console.log(`cover-ai on :${PORT} | omniroute ${OMNI_BASE}`)); diff --git a/ui.html b/ui.html new file mode 100644 index 0000000..c1c8dfd --- /dev/null +++ b/ui.html @@ -0,0 +1,351 @@ + + + + + +封面 AI 助手 · 生图 / 修图 + + + +
+

封面 AI 助手

+ omniroute · cheaperinference + Grok Imagine + 生成的图可直接在「快图设计」的素材面板里点用 +
+ +
+
+ + + +
+ + +
+
+
+ + +
+ +
+
+ + +
+
+ + +
+
+
+ + +
+
+
+
+ +
生成后会显示在这里,可下载或按平台尺寸裁剪。
+
+
+
+
+ + + + + + +
+ +
+ 模型走 omniroute();生图默认 cheaperinference/grok-imagine,修图精细模式用 cheaperinference/nano-banana-2。 +
+ + + +