Gamma API란 무엇인가요?
마음에 드는 덱이 있나요? 전 세계 다양한 청중을 위해 개인화된 100개의 덱을 똑같이 만들 수 있다면 어떨까요?
Gamma Generate API를 사용하면 Gamma 앱을 직접 사용하지 않고도 프레젠테이션, 문서, 웹페이지, 소셜 게시물을 프로그래밍 방식으로 생성할 수 있습니다. Zapier, Make, n8n 같은 도구로 워크플로우를 자동화하거나, 자체 애플리케이션에 아름다운 프레젠테이션 생성 기능을 통합하거나, 백엔드 코드 통합을 통해 대규모로 프레젠테이션을 생성하려는 사용자에게 적합합니다.
개발자라면 Gamma를 애플리케이션에 통합해 디자인 슈퍼파워를 부여할 수 있습니다!
💎 전문가 팁: Pro 계정 이상이면 오늘 바로 넉넉한 사용 한도로 API에 접근할 수 있습니다.
API가 준비되었나요?
Gamma API v1.0은 2025년 11월 5일부터 일반 제공(GA) 중입니다. Pro 계정 이상이면 오늘 바로 넉넉한 사용 한도로 API에 접근할 수 있습니다.
특정 API 매개변수와 프레젠테이션 생성에 미치는 영향에 대한 자세한 내용은 API 문서를 참조하세요.
어떻게 접근할 수 있나요?
Gamma API에 접근하려면 다음 단계를 따르세요.
1단계: 계정 업그레이드
Gamma Pro, Ultra, Team 또는 Business 계정이 있어야 합니다. 현재 Pro 이상 사용자가 아니라면 API 접근을 위해 Pro로 업그레이드하세요.
2단계: API 키 생성
Pro 계정에서 설정 and 멤버로 이동한 후 API key 탭으로 가세요. Create API key를 클릭해 키를 생성한 뒤, API 키를 복사해 안전하게 보관하세요.
🔷 참고: API 키는 sk-gamma-xxxxxxxx 형식을 사용하며 X-API-KEY 헤더로 전달해야 합니다(베어러 토큰 형식 아님).
💎 전문가 팁: 좋아하는 자동화 도구로 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를 무엇에 사용할 수 있나요?
Make, Zapier, Workato 등 자동화 플랫폼에 Gamma API를 활용하세요. 백엔드 코드에 직접 통합해 맞춤 애플리케이션을 구축하거나, 여러 프레젠테이션을 프로그래밍 방식으로 생성해 대량 프레젠테이션을 만들거나, 대규모로 개인화된 콘텐츠를 생성할 수 있습니다.
🔷 참고: inputText에는 슬라이드에 실제로 들어갈 콘텐츠가 포함되어야 하며, 프레젠테이션 생성 방법에 대한 지침은 포함하지 마세요. 테마는 Gamma에서 미리 생성되어 ID로 참조해야 하며, inputText로 생성할 수 없습니다.
템플릿 지원
"templates"가 사용자마다 다르게 의미하기 때문에, 사용 가능한 항목은 다음과 같습니다.
Visual themes: Gamma에서 사용자 지정 테마를 생성하여 프레젠테이션의 모양과 느낌을 정의한 후, API에서 해당 테마 ID를 참조할 수 있습니다. 사용 가능한 테마 ID는 List Themes API(GET /v1.0/themes)를 사용해 확인하세요.
Content structure templates: Create from template를 사용하세요. Gamma에서 템플릿을 만든 후, 해당 ID와 프롬프트를 사용해 POST /v1.0/generations/from-template를 호출합니다. 템플릿의 레이아웃과 카드 구조는 기본적으로 유지되며, 프롬프트로 내용, 대상, 언어를 변경할 수 있습니다. 템플릿은 작업 공간의 단일 페이지 gamma여야 합니다(한 페이지에 여러 카드 포함 가능). 템플릿 ID는 GET /v1.0/templates/search에서 찾으세요.
Agent generation: POST /v1.0/agent/generations는 작업 공간 템플릿, 기존 gamma 또는 공식 Gamma 템플릿(templateId)에서 시작할 수도 있습니다.
도움말 및 지원 받기
문서 및 자료
완전한 기술 참조는 developers.gamma.app의 개발자 문서를 방문하세요. API 액세스는 Pro, Ultra, Teams, Business 구독에 포함되어 있습니다.
디버깅 도움말
API 문제에 도움이 필요할 때는 일반적인 문제와 해결책이 있는 오류 문서를 확인한 후 고객 지원에 문의하세요. 도움 요청 시 항상 API 응답의 x-request-id를 포함하세요.
모든 API 응답 헤더에는 이 고유 식별자가 포함되어 있습니다. **Make.com 사용자**는 Output → Bundle → Headers에서 찾으세요. Zapier는 성공 실행 시 Run Details → Data Out 섹션, 실패 요청 시 Logs 탭 → Response information (헤더 확장)에서 확인할 수 있습니다.
💎 Pro Tip: 지원 요청 시 요청 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는 "새 요금제 카드로 업데이트"와 같은 자연어 지시를 한 페이지에 적용합니다.결과는
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는 포함하지 않으며, 포함하려면 선택해야 합니다.
작성자와 감마가 마지막으로 업데이트된 시점으로도 필터링할 수 있습니다.
내 작업 공간에서 검색이 작동하지 않는 이유는 무엇인가요?
감마 전체 검색 기능은 점진적으로 도입 중이며 아직 모든 작업 공간에 활성화되어 있지 않습니다.
사용할 수 없는 경우 고객 지원에 문의하고
x-request-id를 포함하여 작업 공간을 확인할 수 있도록 하세요.편집자: 검색이 100% 확인되면 이 FAQ를 삭제하세요.
크레딧이 부족하면 어떻게 되나요?
중단 없는 API 접근을 위해 gamma.app/settings/billing에서 청구 설정에 자동 충전을 활성화하세요.
API로 생성된 프레젠테이션은 Gamma 대시보드 어디에 표시되나요?
API를 통해 생성된 프레젠테이션은 Gamma 대시보드의 API Generated 섹션에 표시되며, 기본 Gammas 목록(전체, 최근 본 항목, 또는 내가 생성한 항목)에는 나타나지 않습니다.
API로 생성된 프레젠테이션을 일반 Gammas 목록에 표시하려면 열고 Duplicate를 선택하세요. 복제본은 표준 웹 생성 감마로 처리되어 모든 일반 보기에서 표시됩니다.