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 金鑰、檢視用量與餘額