Appearance
Make.com 接入 Gemini 图像理解
文档说明
在 Make.com 自动化工作流中通过 HTTP 请求节点调用 FastAiToken 的 Gemini 图像理解 API,实现图片内容分析、OCR 识别等自动化任务。
概述
Make.com(原 Integromat)是一款强大的无代码自动化平台。通过其内置的 HTTP 请求节点(Make a request),你可以直接调用 FastAiToken 的 Gemini 原生格式 API,实现图像理解、图片内容分析等多模态自动化工作流,无需编写任何代码。
集成信息
- 🔧 工具:Make.com(
make.com) - 🔌 接入方式:HTTP 请求节点(Make a request)
- 🤖 模型:Gemini 系列(通过 FastAiToken Gemini 原生格式调用)
- 📡 API 端点:
https://fastaitoken.com/v1beta/models/{model}:generateContent
为什么选择 Make.com + FastAiToken
通过可视化拖拽配置 HTTP 请求节点,无需编写代码即可调用 AI 模型 结合 Make.com 的触发器和条件逻辑,构建完整的图像处理自动化流程 FastAiToken 支持 400+ 模型,一个密钥即可在 Make.com 中切换不同的 AI 能力 可与 Google Sheets、Slack、Email 等 1000+ 应用无缝衔接
支持的 FastAiToken 模型
| 模型名称 | 模型标识 | 用途 | 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 系列。
配置步骤
- 访问 FastAiToken控制台 注册/登录 2. 进入【令牌】栏目,生成新的 API 密钥 3. 复制密钥(以
sk-开头),后续配置需要用到 1. 登录 Make.com,点击 Create a new scenario 2. 点击 + 添加模块 3. 搜索并选择 HTTP 模块 4. 在 Actions 中选择 Make a request 在 HTTP 请求节点中填写以下配置:
text
**URL**:https://fastaitoken.com/v1beta/models/gemini-3.1-pro-preview:generateContent
text
**Method**:`POST`
**Headers**:
| Header 名称 | 值 |
| --------------- | -------------------- |
| `Content-Type` | `application/json` |
| `Authorization` | `Bearer sk-你的FastAiToken密钥` |
**Body type**:`Raw`
**Content 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/fastaitoken-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,实现批量图片分析:
json
{
"contents": [
{
"parts": [
{
"text": "请描述这张图片的内容,并提取其中的文字"
},
{
"fileData": {
"mimeType": "image/png",
"fileUri": "{{上游模块的图片URL变量}}"
}
}
]
}
]
}切换不同模型
只需修改 URL 中的模型名称即可切换模型:
| 需求 | URL |
|---|---|
| 最强理解能力 | https://fastaitoken.com/v1beta/models/gemini-3.1-pro-preview:generateContent |
| 高速分析 | https://fastaitoken.com/v1beta/models/gemini-3-flash-preview:generateContent |
常见问题
请检查:text
1. Authorization Header 格式是否正确:`Bearer sk-你的密钥`(注意 Bearer 后有空格)
2. API 密钥是否有效(在 FastAiToken控制台确认)
3. 账户余额是否充足请确认:text
1. `fileUri` 是公开可访问的 URL(在浏览器中可以直接打开)
2. `mimeType` 与实际图片格式一致
3. 图片大小不超过模型限制Gemini API 返回 JSON 格式的响应,你可以:text
1. 使用 Make.com 的 **JSON** 模块解析返回数据
2. 提取 `candidates[0].content.parts[0].text` 字段获取分析结果
3. 将结果传递给下游模块(如写入数据库、发送通知等)访问 [FastAiToken控制台](https://fastaitoken.com/token),注册账号后在【令牌】栏目生成新的密钥。新用户有免费测试额度。
支持。将 `fileData` 替换为 `inlineData`:json
{
"inlineData": {
"mimeType": "image/png",
"data": "Base64编码的图片数据"
}
}
相关资源
查看 Gemini 原生 API 格式的完整说明
查看 FastAiToken 图像理解能力总览
查看 FAQ 获取更多帮助
管理 API 密钥、查看用量和余额