Description
n8n-nodes-lmaoapi
一个用于在 n8n 中调用 LmaoAPI 的社区节点，当前提供文字生成、图像生成和音频转文本三种模式。
功能概览
- 文字生成：默认使用
gpt-5.6-sol，支持自定义模型 ID、系统提示词、文档文本拼接和最多 10 张图片输入。 - 图像生成：支持 GPT-Image-2、Nano Banana 2、Nano Banana 1 Pro 和即梦 5.0，生成结果直接输出为 n8n Binary。
- 音频转文本：固定使用
whisper-1，支持纯文本与句级时间戳 JSON，并额外输出可直接拖拽使用的time-text字段。 - 多种 Binary 来源：可从当前节点输入、指定节点读取图片或音频；文字与图像模式还支持从 URL 获取图片。
- 长任务超时：所有 API 请求统一使用 600 秒超时。
> 当前节点界面只开放上述三种模式。仓库中保留的视频与向量相关实现不属于 1.3.6 的公开节点功能。
安装
推荐在 n8n 的 Settings → Community Nodes 中安装：
n8n-nodes-lmaoapi
自托管环境也可以在相应的 n8n 节点目录执行：
npm install n8n-nodes-lmaoapi
安装完成后，在工作流节点搜索框中输入 LmaoAPI。
快速开始
1. 在 n8n 凭证管理中创建 LmaoAPI API 凭证。
2. 填入从 LmaoAPI 获取的 API Key；Base URL 已固定为 https://api.lmao.net.cn/v1，无需配置。
3. 添加 LmaoAPI 节点，选择文字生成、图像生成或音频转文本模式。
4. 配置提示词或 Binary 输入并执行节点。
Binary 输入
来源模式
| 模式 | 当前节点输入 | 指定节点 | 图片 URL |
| —– | —— | —- | —— |
| 文字生成 | 支持 | 支持 | 支持 |
| 图像生成 | 支持 | 支持 | 支持 |
| 音频转文本 | 支持 | 支持 | 不支持 |
文字、图像和音频模式统一使用以下默认 Binary 属性名：
data,data0,data1,data2,data3,data4,data5
节点会按照填写顺序寻找匹配属性。属性名不同或需要读取更多 Binary 时，可以直接修改这个逗号分隔列表。图片处理上限为 10 张；音频模式使用找到的第一个有效音视频文件。
选择“指定节点”时，填写一个或多个精确的节点名称，多个名称用逗号分隔。若指定节点没有可用 Binary，节点会回退到当前输入。
文字生成
文字生成通过 /chat/completions 调用兼容接口。
gpt-5.6-sol你是一个专业的助手。text 字段，节点会将其作为“参考文档内容”拼接到用户提示词后。choices、usage 等原始字段。配合 n8n 的 Extract From File 节点，可以先提取 PDF 等文件的文本，再交给文字生成模式处理。
图像生成
图像模式支持文生图、单图参考和多图参考。没有参考图时执行文生图；存在参考图时按模型对应的接口发送参考图片。成功后，图片位于输出 Item 的 binary.data。
模型与参数
| 前台名称 | 请求模型 ID | 分辨率 | 比例 | 其他参数 |
| —————– | ——————————– | ————- | —– | —————- |
| GPT-Image-2 | gpt-image-2-c | 自动、预设尺寸或自定义尺寸 | 不单独设置 | 质量、PNG/JPEG/WEBP |
| Nano Banana 2 | gemini-3.1-flash-image-preview | 1K / 2K / 4K | 13 种 | — |
| Nano Banana 1 Pro | gemini-3-pro-image-preview | 1K / 2K / 4K | 9 种 | — |
| 即梦 5.0 | doubao-seedream-5-0-260128 | 2K / 3K | 不单独设置 | 水印由节点请求启用 |
GPT-Image-2 在节点中仍显示为 gpt-image-2，发送请求时自动映射为 gpt-image-2-c。它支持以下尺寸：
auto1024x1024、1024x1536、1536x10242048x1152、2048x20482160x3840、3840x21602048x1152GPT-Image-2 的质量可选自动、低、中、高；输出格式可选 PNG、JPEG、WEBP。背景设置目前不在节点界面开放，固定使用自动背景。
音频转文本
音频模式使用 whisper-1 调用 /audio/transcriptions。
支持格式
flac、mp3、mp4、mpeg、mpga、m4a、ogg、wav、webm
输入既可以是音频，也可以是上述支持容器中的视频。语言可以自动识别，也可以手动指定中文或英语。
输出格式
text 字段返回转写内容，同时附带 _metadata。带时间戳输出示例：
{
"task": "transcribe",
"language": "chinese",
"duration": 7.2,
"text": "家里过年人多 炖肉时间长 你们也学我",
"time-text": "[0.0s - 1.3s] 家里过年人多n[1.5s - 2.6s] 炖肉时间长n[2.6s - 4.0s] 你们也学我",
"sentences": [
{
"text": "家里过年人多",
"start": 0,
"end": 1.3
},
{
"text": "炖肉时间长",
"start": 1.5,
"end": 2.6
},
{
"text": "你们也学我",
"start": 2.6,
"end": 4
}
],
"_metadata": {
"model": "whisper-1",
"format": "verbose_json",
"audioFormat": "mp4",
"sourceProperty": "data",
"timestampGranularity": "sentence",
"language": "zh"
}
}
time-text 位于 sentences 之前，每句话占一行，适合直接拖到后续 AI 节点中使用。手动填写表达式时，因为字段名包含连字符，应使用：
{{ $json["time-text"] }}
sentences 数组仍然保留，方便需要结构化 text、start、end 的工作流继续使用。
本地开发
环境要求
npm run dev 明确要求 Node.js 24。n8n@2.19.5 运行时。npm install
npm run build
npm test
npm run dev
| 命令 | 用途 |
| ————————– | ——————————– |
| npm run build | 构建 TypeScript 节点并复制静态资源到 dist/ |
| npm run build:watch | 持续监听 TypeScript 变更 |
| npm test | 先构建，再运行全部 Node.js 回归测试 |
| npm run test:audio | 运行音频输出与 Binary 默认值测试 |
| npm run test:gpt-image-2 | 运行 GPT-Image-2 回归测试 |
| npm run lint | 执行 n8n 社区节点规则检查 |
| npm run dev | 启动节点热更新和本地 n8n 开发服务器 |
首次执行 npm run dev 时会准备以下本地目录，后续启动会复用：
.n8n-dev-server-node24/：固定版 n8n 开发运行时.npm-n8n-cache-node24/：开发运行时 npm 缓存~/.n8n-node-cli/：独立的 n8n 用户目录Windows 下如遇原生依赖、node-gyp 或 SQLite 构建问题，请先确认当前 Shell 使用 Node.js 24。
1.3.6 更新内容
pairedItem 关联，修复多 Item 工作流中拖拽生成的 $('Node').item 表达式无法追溯上游数据的问题。
continueOnFail 输出统一通过同一关联逻辑，不改变现有 JSON、Binary、参数或 API 请求。
完整版本记录见 CHANGELOG.md。
项目说明
本项目由作者结合 AI 辅助持续迭代，主要服务于电商内容生产和自动化工作流。如遇问题，请在 GitHub Issues 提交可复现信息。
作者微信：maosonghuai
License
本项目采用 MIT License。
