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 키는 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가 귀하의 요구를 지원하도록 함께 해결하겠습니다!
v1.0의 새로운 기능은 무엇인가요?
API v1.0에는 여러 강력한 새 기능이 포함되어 있습니다:
웹페이지 형식: 프레젠테이션, 문서, 소셜 게시물 외에 웹페이지도 생성할 수 있습니다.
헤더 및 푸터 맞춤화: 콘텐츠의 헤더와 푸터를 맞춤 설정할 수 있습니다.
입력 내 이미지 URL: 콘텐츠 내에서 이미지를 직접 참조할 수 있습니다.
폴더 구성: 생성된 콘텐츠를 폴더로 정리할 수 있습니다.
이메일 공유: 콘텐츠를 프로그래밍 방식으로 이메일로 공유할 수 있습니다.
목록 API: 테마와 폴더를 나열하는 새 엔드포인트가 추가되었습니다.
Gamma 검색: 접근 가능한 Gamma의 제목과 전체 본문을 검색하고, 결과를 필터링한 후 열 수 있습니다.
향상된 입력 제한: 최대 100,000 토큰(약 400,000자)까지 지원합니다.
🌀 인사이트: API가 발전함에 따라 Gamma를 프로그래밍 방식으로 수정하고 재구성할 수 있는 옵션을 계속 추가할 예정입니다.
API로 독립 이미지 생성이 가능한가요?
이제 Gamma Generate API와 Model Context Protocol(MCP)을 통해 독립 이미지를 생성할 수 있습니다. 이는 전체 프레젠테이션, 문서, 웹페이지 생성과 별개로 개별 이미지를 프로그래밍 방식으로 생성할 수 있게 해줍니다. API 또는 MCP를 통한 이미지 생성은 개발자 문서의 Create image generation 가이드를 참고하세요: developers.gamma.app/images/create-image-generation. MCP를 통한 이미지 생성은 현재 Claude 및 기타 MCP 클라이언트에서 사용할 수 있으며, ChatGPT에서는 아직 지원되지 않습니다.
API 또는 MCP로 내 Gamma를 검색할 수 있나요?
Gamma API 또는 Model Context Protocol(MCP)을 통해 Gamma AI 어시스턴트와 연결된 도구에서 전체 Gamma 라이브러리를 검색할 수 있습니다. 검색은 접근 가능한 모든 Gamma의 제목과 전체 본문을 대상으로 하며, 관련성에 따라 결과를 순위 매겨 가장 근접한 결과가 먼저 나타납니다. 각 결과에는 직접 링크가 포함되어 있어 응답에서 바로 Gamma를 열 수 있습니다.
검색 범위는 Gamma 생성자와 마지막 업데이트 시점으로 좁힐 수 있습니다. 기본적으로 보관된 Gamma는 제외되며 포함할지 선택할 수 있습니다.
🔷 참고: 검색 기능은 점진적으로 도입 중이므로 모든 작업 공간에서 아직 사용할 수 없습니다. 검색 엔드포인트나 MCP 검색 도구가 작동하지 않으면 해당 작업 공간에 아직 도입되지 않은 것입니다.
전체 검색 매개변수 목록과 예제 요청은 개발자 문서의 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)로 확인하세요.
콘텐츠 구조 템플릿: 향후 업데이트에서 엄격한 콘텐츠 구조 지원을 추가할 예정입니다.
도움 및 지원 받기
문서 및 자료
완전한 기술 참조는 API Reference 문서를 방문하세요. 개요 및 시작 가이드는 랜딩 페이지에서 확인할 수 있습니다. API 접근은 Pro, Ultra, Teams, Business 구독에 포함되어 있습니다.
디버깅 도움말
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 참조 및 예제는 개발자 문서를 검토하세요.
➡️ 개발자 문서 읽기
자주 묻는 질문 및 일반 문제
API 키를 다른 사람과 공유할 수 있나요?
API 키는 안전하게 보관하고 공유하지 마세요.
필요에 따라 별도의 키를 생성하세요.
API 키를 다시 복사할 수 없는 이유는?
보안상 API 키는 생성 시 한 번만 표시됩니다.
키를 잃어버리면 새로 생성해야 합니다.
여러 API 키를 생성할 수 있나요?
예, 계정 설정에서 프로젝트나 용도별로 여러 API 키를 생성할 수 있습니다.
API 또는 MCP 검색 결과에 어떤 Gamma가 표시되나요?
검색은 이미 접근 권한이 있는 Gamma만 반환하므로 열 수 없는 콘텐츠는 노출되지 않습니다.
결과는 관련성 순으로 정렬되며, 가장 근접한 결과가 먼저 나타납니다.
보관된 Gamma는 기본적으로 제외되며 포함할지 선택할 수 있습니다.
생성자와 마지막 업데이트 시점으로 필터링할 수도 있습니다.
내 작업 공간에서 검색이 작동하지 않는 이유는?
Gamma 검색 기능은 점진적으로 도입 중이며 아직 모든 작업 공간에 활성화되지 않았습니다.
사용할 수 없으면 고객 지원에 문의하고
x-request-id를 포함해 작업 공간 상태를 확인하세요.
크레딧이 부족하면 어떻게 되나요?
gamma.app/settings/billing에서 청구 설정의 자동 충전을 활성화해 API 접근이 중단되지 않도록 하세요.
API로 생성된 프레젠테이션은 Gamma 대시보드 어디에 표시되나요?
API로 생성된 프레젠테이션은 Gamma 대시보드의 API Generated 섹션에 표시되며, 기본 Gammas 목록(전체, 최근 본 항목, 내가 생성한 항목)에는 나타나지 않습니다.
API로 생성된 프레젠테이션을 일반 Gammas 목록에 표시하려면 열고 Duplicate를 선택하세요. 복제본은 일반 웹 생성 Gamma로 처리되어 모든 일반 보기에서 표시됩니다.
