Gamma API 문제 해결 가이드
API 관련 모든 문제를 도와드리고 싶지만, 지원팀은 워크플로우 구축, 백엔드 코드(FastAPI, Express, Django 등) 디버깅, 플랫폼별 특이사항 문제 해결은 지원하지 않습니다.
Gamma의 엔드포인트 및 매개변수, API 인증, 오류 문제 해결, 크레딧, 요청이 문서와 일치하는지 확인하는 Gamma 관련 질문은 도와드릴 수 있습니다.
플랫폼별 지원이 필요하면 Zapier Support, Make Support, 또는 N8N Support에 문의하세요.
Gamma API에 대한 자세한 내용은 다음을 참조하세요: developers.gamma.app
일반 오류 코드
400 잘못된 요청
잘못된 매개변수
요청을 확인하세요:
필수 필드 누락 (
inputText,textMode).잘못된 매개변수 값.
문자 또는 토큰 제한 초과.
from-template의 경우: 템플릿은 단일 페이지 워크스페이스 gamma여야 합니다. 공식 Explore 템플릿과 다중 페이지 gamma는 거부됩니다.
구체적인 검증 세부사항은 오류 메시지를 검토하세요.
401 권한 없음
잘못된 API 키
API 키가 잘못되었거나 Pro 계정과 연결되어 있지 않습니다.
X-API-KEY헤더(Authorization 아님)를 사용 중인지 확인하세요.gamma.app/settings/api-keys에서 새 API 키를 생성하세요.
계정에 활성화된 Pro, Ultra, Teams 또는 Business 플랜이 있는지 확인하세요.
403 금지됨
사용 가능한 크레딧 없음
계정의 API 크레딧이 모두 소진되었습니다.
다음에서 해결하세요: gamma.app/settings/billing
자동 충전 활성화(권장).
필요할 때 크레딧 구매.
상위 플랜으로 업그레이드.
404 찾을 수 없음
잘못된 생성 또는 gamma ID
생성 ID가 존재하지 않거나 다른 사용자에게 속해 있습니다. 이 오류는 읽기, 편집 또는 내보내기 시 접근할 수 없는 gamma ID에도 반환됩니다.
POST 응답에서 올바른 generationId를 사용 중인지, 대상 gamma에 접근 권한이 있는지 확인하세요.
422 실패
생성이 완료되지 않음
생성 결과가 비어 있습니다.
요청을 검토하세요:
inputText에 충분한 내용이 있는지 확인하세요.매개변수가 입력과 일치하는지 확인하세요.
필요하면 복잡한 지침을 단순화하세요.
429 너무 많은 요청
요청 한도 초과
요청 한도에 도달했습니다. 한도는 API 키 소유자 및 워크스페이스별로 설정되며 현재 값은 오류 코드 참조에 문서화되어 있습니다.
🔷 참고: API는 넉넉한 용량을 제공합니다. 대부분 사용자는 정상 사용 중 이 한도에 도달하지 않습니다.
해결책:
더 높은 용량이 필요하면 Gamma Support에 문의하세요.
지수 백오프 구현.
요청을 시간에 분산시키세요.
500 내부 서버 오류
예기치 않은 서버 오류
일시적인 서버 문제가 발생했습니다.
잠시 기다렸다가 다시 시도하세요.
지속되면
x-request-id와 함께 지원팀에 문의하세요.
502 잘못된 게이트웨이
일시적인 게이트웨이 문제
일시적인 연결 문제가 발생했습니다.
잠시 기다렸다가 요청을 다시 시도하세요.
내 API 생성 프레젠테이션이 내 Gammas 목록에 없습니다
API 생성 프레젠테이션은 Gamma 대시보드의 API Generated 섹션에 표시되며, 기본 Gammas 목록(전체, 최근 본 항목, 내가 만든 항목)에는 나타나지 않습니다. 이는 정상 동작이며, 프레젠테이션 이름 변경은 분류에 영향을 주지 않습니다.
해결 방법: 프레젠테이션을 열고 복제를 선택하세요. 복제본은 일반 웹 생성 gamma로 처리되어 기본 Gammas 목록에 표시됩니다.
추가 도움이 필요하신가요?
일반 지원: Gamma 지원 문의 방법.
API 커뮤니티: Gamma API Slack 참여하기.
SSO 문제: 조직의 IT 관리자에게 문의하세요.
