마음에 드는 덱이 있나요? 전 세계 다양한 청중을 위해 개인화된 100개 이상의 덱을 만들 수 있다면 어떨까요?

Gamma Generate API를 사용하면 Gamma 앱을 직접 사용하지 않고도 프로그래밍 방식으로 프레젠테이션, 문서, 웹페이지, 소셜 게시물을 생성할 수 있습니다. Zapier, Make, n8n 같은 도구로 워크플로우를 자동화하거나, 자체 애플리케이션에 아름다운 프레젠테이션 생성을 통합하거나, 백엔드 코드 통합을 통해 대규모로 프레젠테이션을 생성하려는 사용자에게 적합합니다.

개발자라면 Gamma를 애플리케이션에 통합하여 디자인 슈퍼파워를 부여할 수 있습니다!

💎 전문가 팁: Pro 계정 이상이면 오늘 바로 API에 접근할 수 있으며 넉넉한 사용 한도가 제공됩니다.

Gamma API v1.0은 2025년 11월 5일부로 일반 제공(GA)됩니다. Pro 계정 이상이면 오늘 바로 API에 접근할 수 있으며 넉넉한 사용 한도가 제공됩니다.

🔷 참고: API v0.2는 더 이상 지원되지 않으며 2026년 1월 16일에 종료됩니다. 현재 v0.2를 사용 중이라면 이 날짜 이전에 v1.0으로 마이그레이션하세요.

특정 API 매개변수와 프레젠테이션 생성에 미치는 영향에 대한 자세한 정보는 API 문서를 참조하세요.

Gamma API에 접근하려면 다음 단계를 따르세요.

Gamma Pro, Ultra, Team 또는 Business 계정이 있어야 합니다. 현재 Pro 이상 사용자가 아니라면 API 접근을 위해 Pro로 업그레이드하세요.

Pro 계정에서 설정 and 멤버로 이동한 후 API key 탭으로 가세요. Create API key를 클릭해 키를 생성하고, 복사하여 안전하게 보관하세요.

🔷 참고: API 키는 sk-gamma-xxxxxxxx 형식을 사용하며 X-API-KEY 헤더로 전달해야 합니다 (Bearer 토큰 형식 아님).

💎 전문가 팁: 좋아하는 자동화 도구로 API를 사용하거나 백엔드 코드에 직접 통합하세요. 기본 URL은 https://public-api.gamma.app/v1.0/ 입니다.

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.

Gamma API는 사용자의 요구에 맞게 확장되도록 설계되었습니다. 몇 개의 프레젠테이션을 생성하든 수백 개를 생성하든, 정상적인 사용 중에는 사용량 제한에 걸리지 않고 생성할 수 있어야 합니다.

🌀 인사이트: 속도 제한(HTTP 429 오류)이 발생하면 지원팀에 문의하세요. API가 사용자의 요구를 지원하도록 함께 노력하겠습니다!

API v1.0에는 여러 강력한 새 기능이 포함되어 있습니다:

웹페이지 형식: 프레젠테이션, 문서, 소셜 게시물 외에 웹페이지도 생성할 수 있습니다.

헤더 및 푸터 맞춤화: 콘텐츠의 헤더와 푸터를 맞춤 설정할 수 있습니다.

입력 내 이미지 URL: 콘텐츠에 이미지를 직접 참조할 수 있습니다.

폴더 구성: 생성된 콘텐츠를 폴더로 정리할 수 있습니다.

이메일 공유: 콘텐츠를 이메일로 프로그래밍 방식으로 공유할 수 있습니다.

목록 API: 테마와 폴더를 나열하는 새 엔드포인트가 추가되었습니다.

Gamma 검색: 접근 가능한 Gamma의 제목과 본문 전체를 검색하고, 결과를 필터링하여 열기 전에 정렬할 수 있습니다.

향상된 입력 제한: 최대 100,000 토큰(약 400,000자)까지 지원합니다.

🌀 인사이트: API가 발전함에 따라 Gamma를 프로그래밍 방식으로 수정하고 재구성할 수 있는 옵션을 계속 추가할 예정입니다.

이제 Gamma Generate API와 Model Context Protocol(MCP)을 통해 독립 이미지를 생성할 수 있습니다. 이는 전체 프레젠테이션, 문서, 웹페이지 생성과 별개로 개별 이미지를 프로그래밍 방식으로 생성할 수 있게 해줍니다. API 또는 MCP를 통한 이미지 생성은 개발자 문서의 Create image generation 가이드를 참고하세요: developers.gamma.app/images/create-image-generation. MCP를 통한 이미지 생성은 현재 Claude 및 기타 MCP 클라이언트에서 사용할 수 있으며, ChatGPT에서는 아직 지원되지 않습니다.

Gamma API 또는 Model Context Protocol(MCP)을 통해 Gamma 라이브러리 전체를 검색할 수 있습니다. MCP는 AI 어시스턴트가 Gamma 같은 도구에 연결할 수 있게 하는 오픈 표준입니다. 검색은 접근 가능한 모든 Gamma의 제목과 본문 전체를 대상으로 하며, 관련성에 따라 결과를 정렬해 가장 적합한 항목이 먼저 나타납니다. 각 결과에는 직접 링크가 포함되어 있어 응답에서 바로 Gamma를 열 수 있습니다.

검색 범위를 Gamma 생성자와 마지막 업데이트 시점으로 좁힐 수 있습니다. 기본적으로 보관된 Gamma는 제외되며, 포함 여부를 선택할 수 있습니다.

🔷 참고: 검색 기능은 점진적으로 도입 중이므로 모든 작업 공간에서 아직 사용할 수 없습니다. 검색 엔드포인트나 MCP 검색 도구가 작동하지 않는다면 해당 작업 공간에 아직 도입되지 않은 것입니다.

전체 검색 매개변수 목록과 예제 요청은 개발자 문서의 Search gammas 가이드를 참고하세요: developers.gamma.app/management/search-gammas.

Make, Zapier, Workato 등 자동화 플랫폼에 Gamma API를 활용하세요. 백엔드 코드에 직접 통합해 맞춤 애플리케이션을 구축하거나, 프로그래밍 방식으로 여러 프레젠테이션을 생성해 대량 생성하거나, 대규모로 개인화된 콘텐츠를 만들 수 있습니다.

🔷 참고: inputText에는 슬라이드에 실제로 들어갈 콘텐츠를 포함해야 하며, 프레젠테이션 생성 방법에 대한 지침은 포함하지 마세요. 테마는 Gamma에서 미리 생성되어 있어야 하며 ID로 참조해야 합니다. inputText로는 생성할 수 없습니다.

"templates"는 사용자마다 의미가 다르므로, 사용 가능한 내용을 안내합니다.

비주얼 테마: Gamma에서 맞춤 테마를 생성하고 API에서 테마 ID로 참조해 프레젠테이션의 외관을 정의할 수 있습니다. 사용 가능한 테마 ID는 List Themes API(GET /v1.0/themes)로 확인하세요.

콘텐츠 구조 템플릿: 향후 업데이트에서 엄격한 콘텐츠 구조 지원을 추가할 예정입니다.

완전한 기술 참조는 API Reference 문서를 방문하세요. 개요 및 시작 가이드는 Landing Page에서 확인할 수 있습니다. API 액세스는 Pro, Ultra, Teams 및 Business 구독에 포함되어 있습니다.

API 문제에 대한 도움이 필요할 때는 일반적인 문제와 해결책이 있는 오류 문서를 확인한 후 Customer Support에 문의하세요. 도움을 요청할 때는 항상 API 응답의 x-request-id를 포함하세요.

모든 API 응답에는 헤더에 이 고유 식별자가 포함되어 있습니다. Make.com 사용자는 Output → Bundle → Headers에서 찾을 수 있습니다. Zapier 사용자는 성공한 실행의 경우 Task History의 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 문제 해결 가이드 보기

➡️ 개발자 문서 읽기

API 키를 다른 사람과 공유할 수 있나요?

API 키를 다시 복사할 수 없는 이유는 무엇인가요?

여러 개의 API 키를 생성할 수 있나요?

API 또는 MCP 검색 결과에 어떤 gammas가 표시되나요?

내 작업 공간에서 검색이 작동하지 않는 이유는 무엇인가요?

v0.2에서 v1.0으로 마이그레이션해야 하나요?

v0.2와 v1.0의 주요 차이점은 무엇인가요?

크레딧이 부족하면 어떻게 되나요?

API로 생성된 프레젠테이션은 Gamma 대시보드 어디에 표시되나요?