Make.com + Gemini 이미지 이해

개요

Make.com(이전의 Integromat)은 강력한 노코드 자동화 플랫폼입니다. 기본 제공되는 **HTTP request node (Make a request)**를 사용하면 APIYI의 Gemini 네이티브 형식 API를 이미지 이해, 콘텐츠 분석 및 기타 멀티모달 자동화 워크플로에 직접 호출할 수 있으며, 코딩은 필요하지 않습니다.

연동 정보

🔧 도구: Make.com (make.com)
🔌 연동: HTTP request node (Make a request)
🤖 모델: Gemini 시리즈 (APIYI Gemini 네이티브 형식 경유)
📡 API 엔드포인트: https://api.apiyi.com/v1beta/models/{model}:generateContent

Make.com + APIYI를 선택해야 하는 이유

코드 없는 통합

시각적 드래그 앤 드롭 방식으로 HTTP 요청 노드를 구성하여 코딩 없이 AI 모델을 호출할 수 있습니다

자동화된 워크플로

Make.com 트리거와 조건 논리를 결합하여 완전한 이미지 처리 자동화를 구축할 수 있습니다

다중 모델 지원

APIYI는 400개 이상의 모델을 지원합니다 — 하나의 API 키로 Make.com에서 다양한 AI 기능을 전환할 수 있습니다

유연한 확장

Google Sheets, Slack, Email 등을 포함한 1000개 이상의 앱과 원활하게 연결할 수 있습니다

지원되는 APIYI 모델

모델명	모델 ID	사용 사례	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 시리즈를 선택하십시오.

설정 단계

1단계: APIYI API 키 받기

APIYI 콘솔에 방문하여 등록/로그인합니다
토큰 섹션으로 이동하여 새 API 키를 생성합니다
키를 복사합니다(sk-로 시작합니다). 구성에 필요합니다

2단계: Make.com 시나리오 만들기

Make.com에 로그인하고 새 시나리오 만들기를 클릭합니다
**+**를 클릭하여 모듈을 추가합니다
검색하여 HTTP 모듈을 선택합니다
작업에서 요청 만들기를 선택합니다

3단계: HTTP 요청 노드 구성

HTTP 요청 노드에 다음 구성을 입력합니다:URL:

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

메서드: POST헤더:

헤더 이름	값
`Content-Type`	`application/json`
`Authorization`	`Bearer sk-your-APIYI-key`

본문 유형: Raw콘텐츠 유형: JSON (application/json)요청 내용(본문):

{
  "contents": [
    {
      "parts": [
        {
          "text": "What is in this image?"
        },
        {
          "fileData": {
            "mimeType": "image/png",
            "fileUri": "https://your-image-url-here"
          }
        }
      ]
    }
  ]
}

4단계: 테스트 실행

한 번 실행을 클릭하여 요청을 테스트하고 올바른 이미지 이해 결과가 반환되는지 확인합니다

전체 요청 예시

수달 이미지를 분석하는 전체 이미지 이해 요청 예시입니다:

{
  "contents": [
    {
      "parts": [
        {
          "text": "What is in this image?"
        },
        {
          "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	예	사용자의 텍스트 prompt
`parts[].fileData.mimeType`	string	예	이미지 형식: `image/png`, `image/jpeg`, `image/webp`, 등
`parts[].fileData.fileUri`	string	예	공개적으로 접근 가능한 이미지 URL

fileUri은 공개적으로 접근 가능한 이미지 URL이어야 합니다. 이미지에 인증이 필요하면 먼저 공개 저장소 서비스에 업로드하십시오.

실용적 시나리오

시나리오 1: 이메일 첨부 이미지 자동 분석

트리거: Gmail - Watch emails(새 이메일을 모니터링합니다)
프로세스: HTTP node가 Gemini 이미지 이해를 호출합니다
출력: 분석 결과를 Google Sheets에 기록하거나 Slack으로 전송합니다

시나리오 2: 이커머스 제품 이미지 자동 태깅

트리거: Google Drive - Watch files(새로 업로드된 이미지를 모니터링합니다)
프로세스: HTTP node가 제품 이미지 콘텐츠를 분석합니다
출력: 제품 이미지에 카테고리 태그를 자동으로 추가합니다

시나리오 3: 소셜 미디어 콘텐츠 모더레이션

트리거: 사용자 제출 이미지를 주기적으로 가져옵니다
프로세스: HTTP node가 준수 여부를 위해 이미지 콘텐츠를 분석합니다
출력: 준수하지 않는 콘텐츠를 자동으로 표시하여 검토합니다

고급 팁

동적 이미지 URL 대체

Make.com에서는 상위 모듈의 출력 변수를 사용하여 배치 이미지 분석을 위해 fileUri를 동적으로 대체할 수 있습니다:

{
  "contents": [
    {
      "parts": [
        {
          "text": "Please describe this image and extract any text in it"
        },
        {
          "fileData": {
            "mimeType": "image/png",
            "fileUri": "{{upstream module's image URL variable}}"
          }
        }
      ]
    }
  ]
}

모델 전환

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`

FAQ

HTTP 요청이 401 오류를 반환합니까?

다음을 확인하십시오:

Authorization 헤더 형식: Bearer sk-your-key (Bearer 뒤에 공백이 있어야 합니다)
API key가 유효한지(APIYI 콘솔에서 확인)
계정 잔액이 충분한지

이미지가 인식되지 않거나 오류를 반환합니까?

다음을 확인하십시오:

fileUri이 공개적으로 접근 가능한 URL인지(브라우저에서 직접 열 수 있어야 함)
mimeType이 실제 이미지 형식과 일치하는지
이미지 크기가 모델 제한 내인지

Make.com에서 응답을 어떻게 처리합니까?

Gemini API는 JSON 형식으로 반환합니다. 다음과 같이 할 수 있습니다:

Make.com의 JSON 모듈을 사용해 응답을 파싱합니다
분석 결과를 위해 candidates[0].content.parts[0].text 필드를 추출합니다
결과를 하위 모듈로 전달합니다(예: 데이터베이스에 기록, 알림 전송)

APIYI API key는 어떻게 얻습니까?

APIYI 콘솔을 방문하여 계정을 등록하고 Tokens 섹션에서 새 key를 생성하십시오. 새 사용자는 무료 테스트 크레딧을 받습니다.

Base64로 인코딩된 이미지를 지원합니까?

예. fileData을 inlineData로 바꾸십시오:

{
  "inlineData": {
    "mimeType": "image/png",
    "data": "Base64-encoded-image-data"
  }
}

Gemini 네이티브 형식 문서

Gemini 네이티브 API 형식 문서 전체 보기

이미지 이해 API

APIYI 이미지 이해 기능 개요 보기

자주 묻는 질문

FAQ 섹션에서 추가 도움 받기

APIYI token 관리

API 키를 관리하고 사용량과 잔액을 확인합니다

개요

대화형 AI

프로그래밍

커뮤니티 기여

AI 에이전트

엔지니어링

번역

Make.com + Gemini 이미지 이해

개요

Make.com + APIYI를 선택해야 하는 이유

코드 없는 통합

자동화된 워크플로

다중 모델 지원

유연한 확장

지원되는 APIYI 모델

설정 단계

전체 요청 예시

요청 매개변수

실용적 시나리오

시나리오 1: 이메일 첨부 이미지 자동 분석

시나리오 2: 이커머스 제품 이미지 자동 태깅

시나리오 3: 소셜 미디어 콘텐츠 모더레이션

고급 팁

동적 이미지 URL 대체

모델 전환

FAQ

관련 자료

Gemini 네이티브 형식 문서

이미지 이해 API

자주 묻는 질문

APIYI token 관리

​개요

​Make.com + APIYI를 선택해야 하는 이유

코드 없는 통합

자동화된 워크플로

다중 모델 지원

유연한 확장

​지원되는 APIYI 모델

​설정 단계

​전체 요청 예시

​요청 매개변수

​실용적 시나리오

​시나리오 1: 이메일 첨부 이미지 자동 분석

​시나리오 2: 이커머스 제품 이미지 자동 태깅

​시나리오 3: 소셜 미디어 콘텐츠 모더레이션

​고급 팁

​동적 이미지 URL 대체

​모델 전환

​FAQ

​관련 자료

Gemini 네이티브 형식 문서

이미지 이해 API

자주 묻는 질문

APIYI token 관리

개요

Make.com + APIYI를 선택해야 하는 이유

지원되는 APIYI 모델

설정 단계

전체 요청 예시

요청 매개변수

실용적 시나리오

시나리오 1: 이메일 첨부 이미지 자동 분석

시나리오 2: 이커머스 제품 이미지 자동 태깅

시나리오 3: 소셜 미디어 콘텐츠 모더레이션

고급 팁

동적 이미지 URL 대체

모델 전환

FAQ

관련 자료