Make.com 接入 Gemini 影像理解

概述

Make.com（原 Integromat）是一款強大的無程式碼自動化平臺。通過其內建的 HTTP 請求節點（Make a request），你可以直接呼叫 API易的 Gemini 原生格式 API，實現影像理解、圖片內容分析等多模態自動化工作流，無需編寫任何程式碼。

整合資訊

🔧 工具：Make.com（make.com）
🔌 接入方式：HTTP 請求節點（Make a request）
🤖 模型：Gemini 系列（通過 API易 Gemini 原生格式呼叫）
📡 API 端點：https://api.apiyi.com/v1beta/models/{model}:generateContent

為什麼選擇 Make.com + API易

零程式碼整合

通過視覺化拖拽配置 HTTP 請求節點，無需編寫程式碼即可呼叫 AI 模型

自動化工作流

結合 Make.com 的觸發器和條件邏輯，構建完整的影像處理自動化流程

多模型支援

API易支援 400+ 模型，一個金鑰即可在 Make.com 中切換不同的 AI 能力

靈活擴充套件

可與 Google Sheets、Slack、Email 等 1000+ 應用無縫銜接

支援的 API易模型

模型名稱	模型標識	用途	API文件
Gemini 3.1 Pro Preview	`gemini-3.1-pro-preview`	影像理解、文本生成	檢視文件
Gemini 3 Pro Preview	`gemini-3-pro-preview`	影像理解、影像生成	檢視文件
Gemini 3 Flash Preview	`gemini-3-flash-preview`	影像理解（高速）	檢視文件

推薦使用 gemini-3.1-pro-preview，擁有最強的影像理解能力。如果對速度要求更高，可以選擇 Flash 系列。

配置步驟

第一步：獲取 API易金鑰

訪問 API易控制台註冊/登入
進入【令牌】欄目，生成新的 API 金鑰
複製金鑰（以 sk- 開頭），後續配置需要用到

第二步：建立 Make.com 場景

登入 Make.com，點選 Create a new scenario
點選 + 新增模組
搜尋並選擇 HTTP 模組
在 Actions 中選擇 Make a request

第三步：配置 HTTP 請求節點

在 HTTP 請求節點中填寫以下配置：URL：

https://api.apiyi.com/v1beta/models/gemini-3.1-pro-preview:generateContent

Method：POSTHeaders：

Header 名稱	值
`Content-Type`	`application/json`
`Authorization`	`Bearer sk-你的API易金鑰`

Body type：RawContent type：JSON (application/json)Request content（Body）：

{
  "contents": [
    {
      "parts": [
        {
          "text": "這張圖片裡有什麼？"
        },
        {
          "fileData": {
            "mimeType": "image/png",
            "fileUri": "https://你的圖片URL地址"
          }
        }
      ]
    }
  ]
}

第四步：測試執行

點選 Run once 測試請求，確認返回正確的影像理解結果。

完整請求示例

以下是一個完整的影像理解請求示例，分析一張水獺圖片的內容：

{
  "contents": [
    {
      "parts": [
        {
          "text": "這張圖片裡有什麼？"
        },
        {
          "fileData": {
            "mimeType": "image/png",
            "fileUri": "https://raw.githubusercontent.com/apiyi-api/ai-api-code-samples/refs/heads/main/Vision-API-OpenAI/otter.png"
          }
        }
      ]
    }
  ]
}

請求引數說明

欄位	型別	必填	說明
`contents`	array	是	對話內容陣列
`contents[].parts`	array	是	訊息組成部分（文本 + 圖片）
`parts[].text`	string	是	使用者的文字提示
`parts[].fileData.mimeType`	string	是	圖片格式：`image/png`、`image/jpeg`、`image/webp` 等
`parts[].fileData.fileUri`	string	是	圖片的公開訪問 URL

fileUri 必須是公開可訪問的圖片 URL。如果圖片需要登入才能訪問，請先將圖片上傳到公開的儲存服務（如物件儲存）。

實用場景

場景一：自動分析郵件附件中的圖片

觸發器：Gmail - Watch emails（監聽新郵件）
處理：HTTP 節點呼叫 Gemini 影像理解
輸出：將分析結果寫入 Google Sheets 或傳送到 Slack

場景二：電商產品圖自動標籤

觸發器：Google Drive - Watch files（監聽新上傳的圖片）
處理：HTTP 節點分析產品圖片內容
輸出：自動為產品圖新增分類標籤

場景三：社交媒體內容稽核

觸發器：定時獲取使用者提交的圖片
處理：HTTP 節點分析圖片內容是否合規
輸出：不合規內容自動標記告警

進階技巧

動態替換圖片 URL

在 Make.com 中，你可以使用上游模組的輸出變數動態替換 fileUri，實現批次圖片分析：

{
  "contents": [
    {
      "parts": [
        {
          "text": "請描述這張圖片的內容，並提取其中的文字"
        },
        {
          "fileData": {
            "mimeType": "image/png",
            "fileUri": "{{上游模組的圖片URL變數}}"
          }
        }
      ]
    }
  ]
}

切換不同模型

只需修改 URL 中的模型名稱即可切換模型：

需求	URL
最強理解能力	`https://api.apiyi.com/v1beta/models/gemini-3.1-pro-preview:generateContent`
高速分析	`https://api.apiyi.com/v1beta/models/gemini-3-flash-preview:generateContent`

常見問題

HTTP 請求返回 401 錯誤？

請檢查：

Authorization Header 格式是否正確：Bearer sk-你的金鑰（注意 Bearer 後有空格）
API 金鑰是否有效（在 API易控制台確認）
賬戶餘額是否充足

圖片無法識別或返回錯誤？

請確認：

fileUri 是公開可訪問的 URL（在瀏覽器中可以直接開啟）
mimeType 與實際圖片格式一致
圖片大小不超過模型限制

如何在 Make.com 中處理返回結果？

Gemini API 返回 JSON 格式的響應，你可以：

使用 Make.com 的 JSON 模組解析返回資料
提取 candidates[0].content.parts[0].text 欄位獲取分析結果
將結果傳遞給下游模組（如寫入資料庫、傳送通知等）

如何獲取 API易金鑰？

訪問 API易控制台，註冊賬號後在【令牌】欄目生成新的金鑰。新使用者有免費測試額度。

支援 Base64 編碼的圖片嗎？

支援。將 fileData 替換為 inlineData：

{
  "inlineData": {
    "mimeType": "image/png",
    "data": "Base64編碼的圖片資料"
  }
}

Gemini 原生格式文件

檢視 Gemini 原生 API 格式的完整說明

影像理解 API

檢視 API易影像理解能力總覽

常見問題

檢視 FAQ 獲取更多幫助

API易-令牌管理

管理 API 金鑰、檢視用量和餘額

概覽

對話型 AI

程式設計開發

社群貢獻

AI Agent

技術工程

翻譯場景

Make.com 接入 Gemini 影像理解

概述

為什麼選擇 Make.com + API易

零程式碼整合

自動化工作流

多模型支援

靈活擴充套件

支援的 API易模型

配置步驟

完整請求示例

請求引數說明

實用場景

場景一：自動分析郵件附件中的圖片

場景二：電商產品圖自動標籤

場景三：社交媒體內容稽核

進階技巧

動態替換圖片 URL

切換不同模型

常見問題

相關資源

Gemini 原生格式文件

影像理解 API

常見問題

API易-令牌管理

​概述

​為什麼選擇 Make.com + API易

零程式碼整合

自動化工作流

多模型支援

靈活擴充套件

​支援的 API易 模型

​配置步驟

​完整請求示例

​請求引數說明

​實用場景

​場景一：自動分析郵件附件中的圖片

​場景二：電商產品圖自動標籤

​場景三：社交媒體內容稽核

​進階技巧

​動態替換圖片 URL

​切換不同模型

​常見問題

​相關資源

Gemini 原生格式文件

影像理解 API

常見問題

API易-令牌管理

概述

為什麼選擇 Make.com + API易

支援的 API易模型

配置步驟

完整請求示例

請求引數說明

實用場景

場景一：自動分析郵件附件中的圖片

場景二：電商產品圖自動標籤

場景三：社交媒體內容稽核

進階技巧

動態替換圖片 URL

切換不同模型

常見問題

相關資源