webhook一句话生成PNG图片

原文要点

原作者jal的n8n模板：暴露一个webhook，接收POST的prompt字段及可选model、size参数（默认gpt-image-2、1024x1024），调用Sublyx AI Images Generation API生成一张图，从响应中提取图片URL或base64数据，把base64转成PNG二进制，直接在原webhook响应里以二进制文件返回。需创建HTTP templated custom auth凭据填入Sublyx API key，激活工作流后把webhook地址配到自己的客户端。作者提到新用户注册可按当前活动获得试用额度，后续可接Telegram、Discord、Google Drive、Notion等节点。

这次做成什么

在n8n里搭一个统一的图像生成入口：外部应用只要POST一个prompt，就能直接拿到PNG文件。模板免费，Sublyx生成调用按该平台计费（试用额度以其当前活动为准）。

准备什么

• 一个可登录的n8n实例（云版或自托管均可）
• 一个Sublyx账号及有效的Sublyx API key
• 一个能发POST请求的客户端，如curl、Postman或你自己的应用

具体怎么做

1. 创建Sublyx凭据

   在n8n凭据页新建HTTP templated custom auth类型凭据，按模板要求把你的Sublyx API key填入对应字段（通常在请求头中作为鉴权），命名保存，稍后在工作流的Sublyx请求节点里选中它。

2. 导入并检查工作流

   从模板页导入工作流，确认链路为：Webhook（接收POST）→调用Sublyx图像生成API的请求节点→从响应提取URL或base64→把base64转成PNG二进制→用二进制响应原请求。把请求节点的凭据切到上一步建好的凭据。

3. 激活并复制webhook地址

   保存并激活工作流，复制正式（production）webhook URL。测试webhook地址只在编辑器监听时有效，给你的应用必须配置正式地址。

4. 发送测试请求

   用下方示例的JSON体向webhook发POST：prompt必填，model和size可省略走默认值gpt-image-2与1024x1024。用curl时加-o把响应存成文件，例如curl -X POST 你的URL -H 'Content-Type: application/json' -d @body.json -o result.png。

5. 可选扩展出口

   确认PNG返回正常后，可在响应节点后追加Telegram、Discord、Google Drive或Notion节点，把同一张图分发到这些渠道；这一步为本站建议的扩展方向，原模板默认只在webhook响应里返回文件。

可直接复制的材料

{"prompt":"一只橘猫坐在日式咖啡馆窗边，水彩插画风格，柔和午后光线","model":"gpt-image-2","size":"1024x1024"}

curl -X POST "https://你的n8n域名/webhook/该工作流路径" -H "Content-Type: application/json" -d "{\"prompt\":\"一只橘猫坐在日式咖啡馆窗边，水彩插画风格\",\"size\":\"1024x1024\"}" -o result.png

输入与输出示例

本站虚构演示的请求与响应形态，未实际调用Sublyx；实际生成内容与耗时以Sublyx服务为准。

输入

POST JSON：{"prompt":"一只橘猫坐在日式咖啡馆窗边，水彩插画风格，柔和午后光线","size":"1024x1024"}，model字段省略走默认。

对应输出

HTTP响应200，Content-Type为image/png，响应体是PNG二进制；用curl -o result.png保存后得到一张1024x1024的图片文件，用系统看图工具可正常打开。

做完检查这些

• 不带model和size只发prompt时，也能正常返回PNG（走默认值gpt-image-2、1024x1024）
• 响应头Content-Type为image/png，且保存的文件能正常打开而非报错JSON
• 更换size参数后返回图尺寸随之变化
• API key失效或额度不足时工作流报错可见，便于排查凭据问题

容易卡住的地方

• 测试webhook地址与正式地址不同，客户端必须配置激活后的正式URL；正式URL若可被公网匿名调用会消耗Sublyx额度，应加Header/token校验、IP白名单或仅允许内网与可信后端调用。
• prompt字段为必填，缺失时工作流无法正常生成
• 试用额度属Sublyx当前活动，具体数量与有效期以该平台页面为准，本站不作保证
• 生成耗时取决于模型与尺寸，原模板未给出时限承诺，大尺寸图需客户端留出足够超时时间
• Sublyx返回URL或base64两种形态，模板已分别处理；若其API响应结构变化，提取节点需要相应调整