Gamma API란 무엇인가요?
마음에 드는 덱이 있나요? 전 세계 다양한 청중을 위해 개인화된 100개의 덱을 똑같이 만들 수 있다면 어떨까요?
Gamma Generate API를 사용하면 Gamma 앱을 직접 사용하지 않고도 프레젠테이션, 문서, 웹페이지, 소셜 게시물을 프로그래밍 방식으로 생성할 수 있습니다. 이는 Zapier, Make, n8n 같은 도구를 사용해 워크플로우를 자동화하거나, 자체 애플리케이션에 아름다운 프레젠테이션 생성 기능을 통합하거나, 백엔드 코드 통합을 통해 대규모로 프레젠테이션을 생성하려는 사용자에게 적합합니다.
개발자라면 Gamma를 애플리케이션에 통합해 디자인 슈퍼파워를 부여할 수 있습니다!
💎 전문가 팁: 누구나 오늘부터 모든 플랜에서 API에 접근할 수 있으며, 넉넉한 사용 한도가 제공됩니다.
API가 준비되었나요?
Gamma API v1.0은 2025년 11월 5일부터 일반 공개(GA)되었습니다. 누구나 오늘부터 모든 플랜에서 API에 접근할 수 있으며, 넉넉한 사용 한도가 제공됩니다.
특정 API 매개변수와 프레젠테이션 생성에 미치는 영향에 대한 자세한 정보는 API 문서를 참조하세요.
어떻게 접근할 수 있나요?
Gamma API에 접근하려면 다음 단계를 따르세요.
1단계: API 키 생성
계정에서 설정 and 멤버로 이동한 후 API key 탭으로 가세요. Create API key를 클릭해 키를 생성한 후, API 키를 복사하여 안전하게 보관하세요.
🔷 참고: API 키는 sk-gamma-xxxxxxxx 형식을 사용하며, X-API-KEY 헤더를 통해 전달해야 합니다 (Bearer 토큰 형식 아님).
💎 전문가 팁: 좋아하는 자동화 도구로 API를 사용하거나 백엔드 코드에 직접 통합해 시작하세요. 기본 URL은 https://public-api.gamma.app/v1.0/ 입니다.
API 키 대신 OAuth로 인증할 수 있나요?
Gamma REST API는 정적 API 키 대신 OAuth 2.0으로 인증할 수 있습니다. OAuth는 장기 API 키를 생성하거나 저장하지 않고도 Gamma API를 애플리케이션에 연결할 수 있어 통합 및 파트너 앱에 유용합니다. 정적 API 키도 완전히 지원되므로 X-API-KEY 헤더를 계속 사용할 수 있습니다. OAuth 설정은 개발자 문서의 Authenticate with OAuth 가이드를 참고하세요: developers.gamma.app/get-started/authenticate-with-oauth.
사용량 및 속도 제한
현재 API 제한
Gamma의 API는 사용자의 필요에 맞게 확장되도록 설계되었습니다. 몇 개의 프레젠테이션을 생성하든 수백 개를 생성하든, 정상적인 사용 중에는 제한에 걸리지 않고 생성할 수 있어야 합니다.
🌀 인사이트: 속도 제한(HTTP 429 오류)이 발생하면 지원팀에 문의하세요. API가 여러분의 요구를 지원하도록 함께 노력하겠습니다!
API가 할 수 있는 일
Gamma API는 생성부터 내보내기까지 gamma의 전체 수명 주기를 다룹니다.
콘텐츠 생성: 자신의 텍스트로 프레젠테이션, 문서, 웹페이지, 소셜 게시물을 만듭니다.
템플릿에서 생성: Gamma에서 만든 템플릿을 사용해 레이아웃과 카드 구조를 유지하며 새 gamma를 생성합니다.
기존 gamma 편집: POST /v1.0/agent/gammas/{gammaId}/edits는 한 페이지에 자연어 변경을 적용합니다.
에이전트 생성: POST /v1.0/agent/generations는 작업 공간 템플릿, 기존 gamma, 공식 Gamma 템플릿에서 생성을 시작합니다.
기존 gamma 읽기, 내보내기, 분석: 가져오기, 댓글, 내보내기, 분석 엔드포인트를 제공합니다.
독립 이미지 생성: 전체 gamma와 별개로 개별 이미지를 생성합니다.
웹페이지 형식: 프레젠테이션, 문서, 소셜 게시물 외에 웹페이지도 생성합니다.
헤더 및 푸터 맞춤화: 콘텐츠의 헤더와 푸터를 맞춤 설정합니다.
입력 내 이미지 URL: 콘텐츠 내에서 이미지를 직접 참조합니다.
폴더 조직: 생성된 콘텐츠를 폴더로 정리합니다.
이메일 공유: 콘텐츠를 이메일로 프로그래밍 방식으로 공유합니다.
목록 API: 테마와 폴더를 나열하는 엔드포인트입니다.
gamma 검색: 접근 가능한 gamma의 제목과 전체 본문을 검색하고, 결과를 필터링한 후 열 수 있습니다.
넉넉한 입력 한도: 최대 100,000 토큰(약 400,000자)까지 지원합니다.
API로 독립 이미지를 생성할 수 있나요?
Gamma API와 Model Context Protocol(MCP)을 통해 독립 이미지를 생성할 수 있습니다. 이를 통해 전체 프레젠테이션, 문서, 웹페이지 생성과 별개로 개별 이미지를 프로그래밍 방식으로 만들 수 있습니다. API 또는 MCP를 통한 이미지 생성은 개발자 문서의 Create image generation 가이드를 참고하세요. MCP를 통한 이미지 생성은 Claude, ChatGPT 및 기타 MCP 클라이언트에서 사용할 수 있습니다.
API 또는 MCP로 gamma를 검색할 수 있나요?
Gamma API 또는 Model Context Protocol(MCP)을 통해 Gamma에 연결된 AI 어시스턴트로 전체 gamma 라이브러리를 검색할 수 있습니다. 검색은 접근 가능한 모든 gamma의 제목과 전체 본문을 대상으로 하며, 관련성에 따라 결과를 순위 매겨 가장 적합한 결과가 먼저 나타납니다. 각 결과에는 직접 연결 링크가 포함되어 있어 응답에서 바로 gamma를 열 수 있습니다.
검색 범위를 gamma 생성자와 마지막 업데이트 시점으로 좁힐 수 있습니다. 보관된 gamma는 기본적으로 제외되며, 포함할지 선택할 수 있습니다.
전체 검색 매개변수 목록과 예제 요청은 개발자 문서의 Search gammas 가이드를 참고하세요: developers.gamma.app/management/search-gammas.
API를 무엇에 사용할 수 있나요?
Gamma API를 Make, Zapier, Workato 등 자동화 플랫폼과 기타 워크플로우 도구에 활용하세요. 또한 백엔드 코드에 직접 통합해 맞춤 애플리케이션을 구축하거나, 여러 프레젠테이션을 프로그래밍 방식으로 생성해 대량 프레젠테이션을 만들거나, 대규모로 개인화된 콘텐츠를 생성할 수 있습니다.
🔷 참고: inputText에는 프레젠테이션 생성 방법에 대한 지시가 아니라 실제 슬라이드에 들어갈 콘텐츠가 포함되어야 합니다. 테마는 Gamma에서 미리 생성되어 ID로 참조해야 하며, inputText를 통해 생성할 수 없습니다.
템플릿 지원
'템플릿'은 사용자마다 의미가 다르므로, 여기서 제공되는 내용을 안내합니다.
시각적 테마: Gamma에서 사용자 지정 테마를 생성하여 프레젠테이션의 모양과 느낌을 정의한 다음, API에서 해당 테마 ID를 참조할 수 있습니다. 사용 가능한 테마 ID를 얻으려면 List Themes API(GET /v1.0/themes)를 사용하세요.
콘텐츠 구조 템플릿: Create from template를 사용하세요. Gamma에서 템플릿을 만든 후, 해당 ID와 프롬프트를 사용해 POST /v1.0/generations/from-template를 호출합니다. 템플릿의 레이아웃과 카드 구조는 기본적으로 유지되며, 프롬프트로 내용, 대상, 언어를 변경할 수 있습니다. 템플릿은 작업 공간의 단일 페이지 gammas여야 합니다(한 페이지에 여러 카드 포함 가능). 템플릿 ID는 GET /v1.0/templates/search에서 찾을 수 있습니다.
에이전트 생성: POST /v1.0/agent/generations는 작업 공간 템플릿, 기존 gamma 또는 공식 Gamma 템플릿(templateId)에서 시작할 수도 있습니다.
도움말 및 지원 받기
문서 및 자료
완전한 기술 참조는 개발자 문서를 방문하세요. API 액세스는 무료를 포함한 모든 플랜에 포함되어 있습니다.
디버깅 도움말
API 문제에 도움이 필요할 때는 일반적인 문제와 해결책을 위한 오류 문서를 확인한 후 고객 지원에 문의하세요. 도움을 요청할 때는 항상 API 응답의 x-request-id를 포함하세요.
모든 API 응답에는 헤더에 이 고유 식별자가 포함되어 있습니다. **Make.com 사용자**는 Output → Bundle → Headers에서 찾을 수 있습니다. Zapier 사용자는 성공한 실행의 경우 작업 기록의 Run Details → Data Out 섹션에서, 실패한 요청은 Logs 탭 → Response information (헤더 확장)에서 확인하세요.
💎 전문가 팁: 지원 요청 시 요청 ID, 정확한 오류 메시지, 요청 본문 샘플을 항상 포함하세요.
지원 범위
도움이 가능한 항목
Gamma 전용 API 문제, 인증 및 API 키 문제, 오류 메시지 이해, 속도 제한 질문, 크레딧 사용 질문에 대해 도움을 드릴 수 있습니다.
도움이 불가능한 항목
사용자 지정 코드 디버깅 또는 작성, Zapier, Make, N8N에서 완전한 워크플로우 구축, 맞춤형 애플리케이션 디버깅, Zapier, Make, N8N 사용법 안내, 맞춤형 아키텍처 설계는 지원하지 않습니다.
API 도움 요청 시 요청 ID, 오류 메시지, 요청 본문 샘플, 사용하는 자동화 플랫폼을 제공해 주세요.
일반 오류 코드
401 Unauthorized: 잘못된 API 키입니다. X-API-KEY 헤더를 사용하고 있는지 확인하세요(Authorization 또는 Bearer가 아닙니다).
403 Forbidden: 크레딧 잔액을 확인하고 자동 충전이 활성화되어 있는지 확인하세요.
429 Too Many Requests: 속도 제한에 도달했습니다. 더 높은 용량 옵션은 Slack 지원에 문의하세요.
422 Failed: 생성이 완료되지 못했습니다. 입력 매개변수를 확인하세요.
시작하는 데 도움이 필요하신가요?
기본 문제 해결 및 일반 API 문제에 대해서는 종합 문제 해결 가이드를 확인하세요. 자세한 API 참조 및 예제는 개발자 문서를 검토할 수 있습니다.
➡️ 개발자 문서 읽기
자주 묻는 질문 및 일반 문제
기존 gamma를 API로 편집할 수 있나요?
예.
POST /v1.0/agent/gammas/{gammaId}/edits는 자연어 지시를 적용하여 편집 가능한 gamma의 한 페이지를 수정할 수 있습니다. 예: "새 요금제 카드로 업데이트하세요."결과는
GET /v1.0/agent/edits/{editId}로 폴링하세요.편집은 페이지 추가가 불가능하며, 한 번에 한 페이지에서 하나의 편집만 실행됩니다.
이 기능은 Claude, ChatGPT, Slack 및 기타 MCP 클라이언트에서도 사용할 수 있습니다.
내 AI 에이전트가 Gamma를 사용할 수 있나요?
예. 모든 MCP 클라이언트를
https://mcp.gamma.app/mcp에 연결하고 Gamma 계정으로 로그인하세요. 모든 플랜에서 작동합니다.사용자 지정 클라이언트는 먼저 OAuth 리디렉션 URI를 등록해야 합니다.
내 API 키를 다른 사람과 공유할 수 있나요?
API 키는 안전하게 보관하고 공유하지 않아야 합니다.
필요한 경우 다른 사용 사례별로 별도의 키를 생성하세요.
왜 API 키를 다시 복사할 수 없나요?
보안상의 이유로 API 키는 생성 시 한 번만 표시됩니다.
키를 분실하면 새 키를 생성해야 합니다.
여러 API 키를 생성할 수 있나요?
예, 계정 설정을 통해 프로젝트나 사용 사례별로 여러 API 키를 생성할 수 있습니다.
API 또는 MCP 검색 결과에 어떤 gamma가 표시되나요?
검색은 이미 접근 권한이 있는 gamma만 반환하므로, 열 수 없는 콘텐츠는 노출되지 않습니다.
결과는 관련성에 따라 순위가 매겨지며, 쿼리와 가장 가까운 일치 항목이 먼저 표시됩니다.
보관된 gamma는 포함하지 않으며, 포함하려면 선택해야 합니다.
작성자 및 마지막 업데이트 시기로 필터링할 수도 있습니다.
내 작업 공간에서 검색이 작동하지 않는 이유는 무엇인가요?
여러분의 gammas를 대상으로 하는 검색 기능은 점진적으로 도입 중이며 아직 모든 작업 공간에 활성화되어 있지 않습니다.
사용할 수 없는 경우 고객 지원에 문의하시고
x-request-id를 포함하여 작업 공간을 확인할 수 있도록 하세요.편집자: 검색이 100% 확인되면 이 FAQ를 삭제하세요.
크레딧이 부족하면 어떻게 되나요?
중단 없는 API 접근을 위해 gamma.app/settings/billing에서 청구 설정에 자동 충전을 활성화하세요.
API로 생성된 프레젠테이션은 Gamma 대시보드 어디에 나타나나요?
API를 통해 생성된 프레젠테이션은 Gamma 대시보드의 API Generated 섹션에 나타나며, 기본 Gammas 목록(전체, 최근 본 항목, 또는 내가 생성한 항목)에는 나타나지 않습니다.
API로 생성된 프레젠테이션을 일반 Gammas 목록에 표시하려면 열고 Duplicate를 선택하세요. 복제본은 표준 웹 생성 gamma로 처리되어 모든 일반 보기에서 표시됩니다.