본문으로 건너뛰기
Julian Pscheid ·

Gamma API v1.0에 맞게 n8n 워크플로를 업데이트하는 방법

Gamma API v0.2는 2026년 1월 31일에 지원이 종료됩니다. 핵심 변경 사항인 themeName에서 themeId로의 매개변수 변경을 중심으로, n8n 워크플로를 새로운 v1.0 API로 몇 분 만에 이전하는 방법을 알아보세요.

API 기어, 클라우드 아이콘, 2026년 1월 31일 마감일이 빛나는 칩이 있는 회로 기판의 3D 일러스트

중요 업데이트: Gamma API v0.2 지원 종료

n8n에서 Gamma API를 사용해 프레젠테이션을 자동으로 생성하고 있다면 2026년 1월 31일 전에 워크플로를 업데이트해야 합니다. Gamma는 v0.2 API 엔드포인트를 폐지할 예정이며, 이 날짜가 지나면 이전 버전을 사용하는 워크플로는 더 이상 작동하지 않습니다.

다행히 소프트웨어 마이그레이션은 간단하며 몇 분이면 끝납니다. 이 가이드에서는 무엇을 변경해야 하는지 차근차근 설명합니다.

Gamma API v1.0의 변경 사항

v1.0 API에서 가장 큰 변경 사항은 테마를 지정하는 방식입니다. 새 API에서는 사람이 읽기 쉬운 테마 이름 대신 테마 ID를 사용해야 합니다.

기존 방식(v0.2):

“themeName”: “Oasis”

새 방식(v1.0):

“themeId”: “theme_abc123xyz”

이 변경으로 API 안정성이 높아지고 테마를 더 정확하게 선택할 수 있지만, 워크플로를 한 번 업데이트해야 합니다.

n8n 사용자를 위한 단계별 마이그레이션

1단계: n8n 워크플로 열기

n8n 인스턴스에 접속해 Gamma API를 사용하는 워크플로를 여세요. Gamma에 API를 호출하는 HTTP Request 노드를 찾으세요.

2단계: API URL 업데이트

HTTP Request 노드에서 다음 URL을:

https://public-api.gamma.app/v0.2/generations

아래 URL로 변경하세요:

https://public-api.gamma.app/v1.0/generations

3단계: Gamma에서 테마 ID 가져오기

가장 중요한 단계입니다. 다음과 같이 테마 ID를 찾으세요.

  1. gamma.app에서 Gamma 계정에 로그인하세요
  2. 탐색 모음에서 팔레트 아이콘을 클릭해 디자인 라이브러리를 여세요
  3. 프레젠테이션에 사용할 테마를 찾으세요
  4. 테마 이름 옆의 점 세 개(⋯)를 클릭하세요
  5. 메뉴에서 “Copy theme ID for API”를 선택하세요

테마 ID가 클립보드에 복사됩니다. 다음과 같은 형식입니다: theme_12345abcde

4단계: JSON 페이로드 업데이트

n8n의 HTTP Request 노드에서 JSON 본문 섹션을 찾으세요. themeName 매개변수를 themeId로 바꾸세요.

변경 전:

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeName”: “Oasis”, “numCards”: 10 }

변경 후:

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeId”: “theme_12345abcde”, “numCards”: 10 }

5단계: 저장 및 테스트

업데이트한 워크플로를 저장하세요. n8n v2.0 이상을 사용한다면 새 버전을 게시하세요. v1.x를 사용한다면 워크플로를 활성화하세요.

테스트 실행으로 새 API 버전에서 모든 기능이 올바르게 작동하는지 확인하세요.

다른 방법: Gamma의 기본 테마 사용

특정 사용자 지정 테마가 필요하지 않다면 테마 매개변수를 완전히 제거해 마이그레이션을 간소화할 수 있습니다. v1.0 API는 Gamma의 표준 기본 테마를 자동으로 사용합니다.

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “numCards”: 10 }

워크플로가 여러 개라면?

Gamma API를 사용하는 n8n 워크플로가 여러 개라면 각각 업데이트해야 합니다. 다만 모든 워크플로에서 절차는 동일합니다.

  1. API URL을 v1.0으로 업데이트하세요
  2. themeName을 themeId로 바꾸세요
  3. 모든 워크플로에서 같은 테마 ID를 사용하세요(서로 다른 테마를 사용하려면 각 테마의 ID를 가져오세요)

테마 ID를 한곳에 정리해 두면 새 워크플로를 만들 때 쉽게 참고할 수 있습니다.

추가 자료

도움이 필요하신가요?

마이그레이션 중 문제가 발생하면 다음 사항을 다시 확인하세요.

  • API 키가 변경되지 않았는지 확인하세요(기존과 같아야 합니다)
  • Gamma에서 테마 ID 전체를 복사했는지 확인하세요
  • 올바른 v1.0 엔드포인트 URL을 사용하는지 확인하세요
  • JSON 문법이 올바른지 확인하세요(쉼표나 따옴표가 빠지지 않았는지 살펴보세요)

2026년 1월 31일 마감일이 빠르게 다가오고 있으니 워크플로를 서둘러 업데이트하세요. 마이그레이션은 간단하며, 완료하면 개선된 v1.0 API로 프레젠테이션 자동 생성 기능을 계속 원활하게 사용할 수 있습니다.

JP

About the author

Julian Pscheid is the founder and CEO of Hedy AI, a real-time AI meeting coach used by tens of thousands of professionals worldwide. He writes about how AI is changing the way people prepare for, capture, and understand important conversations.

다음 회의를 최고의 회의로 만드세요

무료로 시작하세요. 신용카드는 필요하지 않습니다. 봇이 통화에 참여하지 않고, 녹음 파일이 어디로도 전송되지 않습니다. 기기에서 실시간 코칭을 받으세요.