用 webhook 生成图库照片的标题、描述和关键词

用 webhook 生成图库照片的标题、描述和关键词

一个带 webhook 的 n8n 工作流。你把图片发给它，可以是公开地址，也可以是 base64，gpt-4o-mini 看图后写出适合图库平台的标题、描述和关键词。回复里既有分开的字段，也有现成的一行 CSV。

包里有什么

• workflow.json：n8n 导出的工作流，7 个节点，没有便签。里面没有任何凭据。
• README.md：这份设置说明，压缩包里的是英文版。

我们相对原来的副本改了什么

Vision LLM 的 Authorization 请求头原来写的是 Bearer YOUR_OPENAI_API_KEY，现在是 Bearer <YOUR_OPENAI_API_KEY>，这样粘贴密钥时一眼就能看出该替换哪里。其余都和原来的副本一样。

开始之前

• 一个发送方能访问到地址的 n8n 实例。n8n Cloud 可以，你自己放在公网上的服务器也可以。
• 一个能用 gpt-4o-mini 的 OpenAI API 密钥。
• 要发送的图片：公开链接，或文件本身转成的文本。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 打开 Vision LLM。在它的 Authorization 请求头里，把 <YOUR_OPENAI_API_KEY> 换成你的密钥。尖括号去掉，保留 Bearer 这个词和它后面的空格。
3. 保存，然后打开 Webhook，复制它的测试地址，它以 stock-image-meta 结尾。
4. 点 Listen for test event，再向这个地址发一张图片。下面这个请求体可用：

{ "imageUrl": "https://example.com/photo.jpg" }

1. 回复看着没问题后点 Publish。正式地址是同一个路径，放在 /webhook/ 下面。

一次运行的过程

1. Webhook 在路径 stock-image-meta 上接收 POST。它等一个节点来回复，所以发送方在同一次调用里就能拿到结果。
2. Parse Input 从请求体里读 imageUrl、image_url 或 image。它也接受 imageBase64，如果这段文字不是以 data: 开头，就补上 data:image/jpeg;base64,。没有图片时它会带着一条说明原因的错误停下。
3. Build Vision Request 写出发给 OpenAI chat completions API 的请求。system message 让模型扮演图库照片元数据的撰写者。用户消息要求返回纯 JSON：一个少于 12 个词的 title，一段 2 到 3 句话的 description，以及 20 到 40 个小写的 keywords。它设定 gpt-4o-mini、温度 0.3 和 800 个 token。
4. Vision LLM 把这个请求体发到 https://api.openai.com/v1/chat/completions，超时 120 秒。
5. Parse Metadata 取出模型的文字，去掉代码围栏，读取 JSON，读不出来就退回去取第一个 {...} 块。缺少标题时标题变成 Untitled。缺少描述或关键词列表为空时，运行停止。
6. Build CSV Row 把引号写成双引号，用分号加空格连起关键词，生成 csv_row，以及一份以表头 "title","description","keywords" 开头的 csv 文本。
7. Respond to Webhook 把所有传入项当作 JSON 回复。

改变风格

• 元数据的规则：Build Vision Request 里的两条消息。可以改标题长度、关键词数量，或者提到的图库平台。
• 模型：同一个节点里的 model。较新的模型可能不接受 max_tokens 或 temperature，换进去之前先确认它两个都接受。
• 回答的长度：那个节点里的 max_tokens。
• CSV：Build CSV Row。如果你的图库平台要用逗号，就改它的分隔符。
• 别人发请求的地址：Webhook 里的 path。

注意事项

• OpenAI 的弃用页面（2026 年 11 月 12 日查阅）把带日期的 gpt-4o-mini 版本列为 2027 年 1 月 14 日关停，替代是 gpt-6-luna。页面没有列出不带日期的 gpt-4o-mini，这个副本保留了这个名字。
• Respond to Webhook 设成了用所有传入项回复，所以回复是一个只有一个对象的 JSON 数组，里面有 title、description、keywords、keyword_count、csv_row 和 csv。节点里的 responseBody 文本本来会加上一个 success 标记，在这个设置下用不到。
• 20 到 40 个关键词只是提示词里的要求，没有任何东西去数，keyword_count 报告的是实际返回的数量。
• imageUrl 里的地址必须能被 OpenAI 访问到，所以要登录才能看的链接，或在内网里的链接都会失败。单独的 base64 文本一律被标成 image/jpeg，不管文件是什么格式。
• webhook 没有认证。任何拿到地址的人都能发起一次花你的密钥的调用，所以要打开 webhook 自带的认证，或者别公开这个地址。
• 每张图片运行一次 gpt-4o-mini 调用，每张图片都会发给 OpenAI。
• 密钥写在一个请求头字段里，不在凭据里，所以会随每次导出一起带走。分享工作流之前先删掉。