Skip to main content

概述

这是一套让飞书多维表格变成生图生产线的完整方案:运营/设计同学在表格里填写提示词、上传素材图,附件自动转 OSS 链接,再触发 Coze 工作流调用 Nano Banana Pro 出图,最后把生成结果回写到表格中作为图片附件展示——全程零代码操作 方案由作者 Shuaila1996 在企业实际业务中沉淀,包含 3 个互相独立但配合使用的代码片段:飞书字段捷径、阿里云函数计算、Coze 插件。 飞书多维表格 AI 生图架构图
项目信息
  • 📦 形态:代码包形式分享(未公开在 GitHub
  • 👤 作者:Shuaila1996
  • 🎯 适用场景:飞书企业版多维表格 + 阿里云 + Coze 国内版
  • 🔌 调用模型:gemini-3-pro-image-preview(Nano Banana Pro,通过 API易 接入)
  • 📝 飞书字段捷径、阿里云函数完整源码已嵌入本文档;Coze 插件完整源码见 Nano Banana Pro Coze 插件

核心功能

表格即工作台

运营同学只需在飞书多维表格里填提示词、上传素材图,无需接触任何代码或工作流后台

附件自动转 OSS

飞书附件通过自研字段捷径下载并转发到阿里云函数计算,自动压缩后上传 OSS 拿到公网 URL

多人多 Key 管理

Coze 工作流内置「人员 apikey 分离」字典,按调用人自动分配 API易 密钥,便于用量核算

批量出图

多维表格天然支持批量行操作,配合字段捷径可一键对几十上百行进行批量生图

结果直接入表

Coze 返回的 OSS 链接通过飞书官方「URL 转附件」字段捷径写回表格,作为图片附件直接展示

清晰错误反馈

审核失败、违规拒绝、超时等情况会以友好文案返回到表格,便于运营快速定位问题

支持的 API易 模型

整体架构

部署步骤

1

第一步:阿里云基础设施

  1. 开通 OSS Bucket,创建 RAM 子账号并授权 oss:PutObjectoss:ProcessObject
  2. 开通函数计算 FC,创建一个 HTTP 触发器函数,运行环境选 Node.js 18+
  3. 安装依赖:ali-oss
  4. 配置环境变量(避免硬编码密钥):
阿里云函数计算配置
2

第二步:部署阿里云 FC 函数

把作者提供的 aliyun-fc-oss-upload.js 完整代码部署到 FC 函数。函数核心逻辑:
  • 接收飞书字段捷径传来的图片二进制
  • client.put 上传原图
  • client.processObjectSave 压缩到长边 4500 / 质量 95
  • 把压缩图的公网 URL 包装成飞书可识别的 feishuWrapper 结构返回
部署完成后获取函数公网触发地址,备用。
3

第三步:开发飞书字段捷径

使用 飞书字段捷径开发框架 部署作者提供的 feishu-attachment-to-oss.ts。两处需要替换:
飞书字段捷径运行在飞书官方云沙箱,部分 Node.js 库不可用,因此附件上传必须拆成「字段捷径下载二进制 → FC 上传 OSS」两步,无法在字段捷径里直接调用 OSS SDK。
打包后交由飞书官方人员上传到企业字段捷径库。
4

第四步:配置飞书多维表格

在飞书多维表格里准备以下字段:合并公式示例:
5

第五步:部署 Coze 插件 + 工作流

  1. Nano Banana Pro Coze 插件 文档部署 Python 插件
  2. 导入作者提供的 Coze 工作流包,包含:
    • 图片链接和提示词分离代码节点
    • 「人员 apikey 分离」字典节点(按调用人匹配 API 密钥)
    • Nano Banana Pro 插件节点
    • 成功 / 失败 / 错误聚合逻辑
  3. 在工作流中维护「人员 apikey 分离」字典,按团队成员姓名映射到对应的 API易 密钥
6

第六步:在飞书侧配置 Coze 工作流字段捷径

在飞书多维表格里添加官方 / 自研的「Coze 工作流调用」字段捷径,按下图配置:飞书 Coze 工作流调用配置关键点:
  • 填入 Coze 申请的工作流令牌和工作流 ID
  • 请求模板字段名必须严格匹配 Coze 工作流入口参数名
  • 必填项以 Coze 工作流入口勾选的字段为准
  • apichoice 列填 apiyi不要写成 apiyi(0.35元/张) 这种展示文案,否则字典匹配失败
7

第七步:URL 转附件展示

最后一步是把 Coze 返回的图片 URL 转成飞书图片附件。两种方式:
  1. 直接购买:使用 Coze 官方提供的「URL 转附件」字段捷径
  2. 自研:参考飞书字段捷径开发文档自行实现

多维表格合并公式

多维表格里的「合并提示词」公式:
CHAR(10) 是换行符,可以让 Coze 的代码节点用 \n 分割提示词与图片链接。

飞书字段捷径完整源码

下面是 feishu-attachment-to-oss.ts 的完整代码,可以直接复制到飞书字段捷径开发框架。部署前只需把两处 feishu-service 改成你阿里云 FC 的公网域名/链接
feishu-attachment-to-oss.ts

阿里云函数计算完整源码

下面是 aliyun-fc-oss-upload.js 的完整代码,可以直接放进阿里云函数计算的代码编辑器(运行时 Node.js 18+)。所有密钥都从环境变量读取,不要硬编码
函数返回的是 feishuWrapper(...) 双层结构:HTTP 层固定 200,避免飞书 fetch 因非 2xx 抛异常;真正的状态码与数据放在 body 字段(JSON 字符串),飞书侧用 JSON.parse(result.body) 取数。
aliyun-fc-oss-upload.js

Coze 插件源码

Coze 侧的 Python 插件 coze-nanobanana-pro.py 完整源码已嵌入到 Nano Banana Pro Coze 插件 文档的”插件完整源码”章节,复制即用。

安全注意事项

本方案涉及 API 密钥、阿里云 AccessKey、飞书令牌、Coze 调用令牌 多重凭证,请务必:
  1. 不要硬编码密钥:阿里云 FC 用环境变量,Coze 插件用平台加密配置,飞书字段捷径使用前清空真实地址
  2. OSS 子账号最小权限:只授予对应 Bucket 的 oss:PutObjectoss:ProcessObject,不要给全局权限
  3. API易 密钥分人发放:通过「人员 apikey 分离」字典分发,便于追溯用量与吊销
  4. 公网触发器加签名:函数计算建议开启签名鉴权,避免被外部恶意调用

常见问题

检查两件事:
  1. basekit.addDomainList 中是否加入了函数公网域名(去掉 https://
  2. context.fetch 中是否用的是完整 https:// 地址
飞书沙箱默认禁止访问未声明的域名。
优先检查:
  • 多维表格里的 apichoice 列是否填 apiyi(不要写展示文案如 apiyi(0.35元/张)
  • 「人员 apikey 分离」节点字典里是否已添加对应调用人姓名
  • 调用人姓名是否与多维表格人员字段输出完全一致(含空格、繁简体)
Coze 工作流默认返回的是文本 URL,飞书需要再过一道「URL 转附件」字段捷径才能渲染成图片。可以:
  1. 直接购买 Coze 官方的「URL 转附件」字段捷径(最省事)
  2. 自己开发 URL 转附件字段捷径
通常是 processObjectSave 处理参数串与 Bucket 区域不匹配。检查:
  • Bucket 是否开启「图片处理」功能
  • process.env.OSS_REGION 与 Bucket 实际区域一致
  • RAM 子账号是否有 oss:ProcessObject 权限
Nano Banana Pro 4K 出图较慢,建议:
  • 在 Coze 工作流入口加并发限制
  • 多维表格里分批次触发字段捷径,每批 5-10 行
  • 不同调用人配置不同 API易 密钥,分摊速率限制
本方案的所有源码都已嵌入文档,作者 Shuaila1996 贡献,复制即用:
  • feishu-attachment-to-oss.ts(飞书字段捷径)→ 见本页”飞书字段捷径完整源码”章节
  • aliyun-fc-oss-upload.js(阿里云函数计算)→ 见本页”阿里云函数计算完整源码”章节
  • coze-nanobanana-pro.py(Coze 插件)→ 见 Nano Banana Pro Coze 插件 文档的”插件完整源码”章节

相关资源

Nano Banana Pro Coze 插件

本方案配套的 Coze 插件代码与详细说明,单独使用也能让任意 Coze 工作流接入 Nano Banana Pro

Nano Banana Pro 文档

查看 Nano Banana Pro 完整 API 文档、定价与生图样例

生图失败排查

Nano Banana 生图常见问题排查指南

API易控制台

管理 API 密钥、查看用量与余额