Documentation Index
Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
Use this file to discover all available pages before exploring further.
概述
这是一套让飞书多维表格变成生图生产线的完整方案:运营/设计同学在表格里填写提示词、上传素材图,附件自动转 OSS 链接,再触发 Coze 工作流调用 Nano Banana Pro 出图,最后把生成结果回写到表格中作为图片附件展示——全程零代码操作。 方案由作者 Shuaila1996 在企业实际业务中沉淀,包含 3 个互相独立但配合使用的代码片段:飞书字段捷径、阿里云函数计算、Coze 插件。
项目信息
- 📦 形态:代码包形式分享(未公开在 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易 模型
| 模型名称 | 模型标识 | 用途 | API 文档 |
|---|---|---|---|
| Nano Banana Pro | gemini-3-pro-image-preview | 文生图、图生图 | 查看文档 |
整体架构
部署步骤
第一步:阿里云基础设施
- 开通 OSS Bucket,创建 RAM 子账号并授权
oss:PutObject、oss:ProcessObject - 开通函数计算 FC,创建一个 HTTP 触发器函数,运行环境选 Node.js 18+
- 安装依赖:
ali-oss - 配置环境变量(避免硬编码密钥):

第二步:部署阿里云 FC 函数
把作者提供的
aliyun-fc-oss-upload.js 完整代码部署到 FC 函数。函数核心逻辑:- 接收飞书字段捷径传来的图片二进制
client.put上传原图client.processObjectSave压缩到长边 4500 / 质量 95- 把压缩图的公网 URL 包装成飞书可识别的
feishuWrapper结构返回
第三步:开发飞书字段捷径
第四步:配置飞书多维表格
在飞书多维表格里准备以下字段:
合并公式示例:
| 字段名 | 类型 | 说明 |
|---|---|---|
| 需求提示词填写 | 文本 | 用户输入的图像生成指令 |
| 目标图 | 附件 | 期望参考的目标图 |
| 素材图 | 附件 | 改图所用的素材图 |
| 目标图链接 | 字段捷径(附件转 OSS) | 自动产出 OSS 链接 |
| 素材图链接 | 字段捷径(附件转 OSS) | 自动产出 OSS 链接 |
| 合并提示词 | 公式 | 见下方公式 |
| 调用人 | 人员 / 文本 | 用于分发 API 密钥 |
| apichoice | 文本 | 固定填 apiyi |
| 生成结果链接 | 字段捷径(Coze 工作流调用) | 触发 Coze |
| 生成图片 | 字段捷径(URL 转附件) | 展示最终图片 |
第五步:部署 Coze 插件 + 工作流
- 按 Nano Banana Pro Coze 插件 文档部署 Python 插件
- 导入作者提供的 Coze 工作流包,包含:
- 图片链接和提示词分离代码节点
- 「人员 apikey 分离」字典节点(按调用人匹配 API 密钥)
- Nano Banana Pro 插件节点
- 成功 / 失败 / 错误聚合逻辑
- 在工作流中维护「人员 apikey 分离」字典,按团队成员姓名映射到对应的 API易 密钥
第六步:在飞书侧配置 Coze 工作流字段捷径
在飞书多维表格里添加官方 / 自研的「Coze 工作流调用」字段捷径,按下图配置:
关键点:

- 填入 Coze 申请的工作流令牌和工作流 ID
- 请求模板字段名必须严格匹配 Coze 工作流入口参数名
- 必填项以 Coze 工作流入口勾选的字段为准
apichoice列填apiyi,不要写成apiyi(0.35元/张)这种展示文案,否则字典匹配失败
多维表格合并公式
多维表格里的「合并提示词」公式: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+)。所有密钥都从环境变量读取,不要硬编码。
aliyun-fc-oss-upload.js
Coze 插件源码
Coze 侧的 Python 插件coze-nanobanana-pro.py 完整源码已嵌入到 Nano Banana Pro Coze 插件 文档的”插件完整源码”章节,复制即用。
安全注意事项
常见问题
飞书字段捷径无法访问阿里云函数
飞书字段捷径无法访问阿里云函数
检查两件事:
basekit.addDomainList中是否加入了函数公网域名(去掉 https://)context.fetch中是否用的是完整https://地址
Coze 工作流提示账号或配置错误
Coze 工作流提示账号或配置错误
优先检查:
- 多维表格里的
apichoice列是否填apiyi(不要写展示文案如apiyi(0.35元/张)) - 「人员 apikey 分离」节点字典里是否已添加对应调用人姓名
- 调用人姓名是否与多维表格人员字段输出完全一致(含空格、繁简体)
图片生成成功但飞书不显示图片
图片生成成功但飞书不显示图片
Coze 工作流默认返回的是文本 URL,飞书需要再过一道「URL 转附件」字段捷径才能渲染成图片。可以:
- 直接购买 Coze 官方的「URL 转附件」字段捷径(最省事)
- 自己开发 URL 转附件字段捷径
阿里云 FC 函数返回 500 但 OSS 上传成功
阿里云 FC 函数返回 500 但 OSS 上传成功
通常是
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 密钥、查看用量与余额