메인 콘텐츠로 건너뛰기

Gamma API 문제 해결

지원 범위, 일반 오류 코드 및 문제 해결 단계 안내.

Gamma API 문제 해결 가이드

API 관련 모든 문제를 도와드리고 싶지만, 저희 지원팀은 워크플로우 구축, 백엔드 코드(FastAPI, Express, Django 등) 디버깅, 플랫폼별 특이사항 문제 해결은 지원하지 않습니다.

저희는 Gamma 특정 엔드포인트 및 매개변수, API 인증, 오류 문제 해결, 크레딧, 요청이 문서와 일치하는지 확인하는 데 도움을 드릴 수 있습니다.

플랫폼별 지원이 필요하면 Zapier Support, Make Support, 또는 N8N Support에 문의하세요.

Gamma의 API에 대한 자세한 내용은 다음을 참조하세요: developers.gamma.app


일반 오류 코드

400 잘못된 요청

잘못된 매개변수

요청을 다음과 같이 확인하세요:

  • 필수 필드 누락 (inputText, textMode)

  • 잘못된 매개변수 값

  • 문자/토큰 제한 초과

구체적인 검증 세부사항은 오류 메시지를 검토하세요.


401 권한 없음

잘못된 API 키

API 키가 잘못되었거나 Pro 계정과 연결되어 있지 않습니다.

  1. X-API-KEY 헤더(Authorization 아님)를 사용 중인지 확인하세요.

  2. 새 API 키를 gamma.app/settings/billing에서 생성하세요.

  3. 계정에 활성화된 Pro, Ultra, Teams 또는 Business 플랜이 있는지 확인하세요.


403 금지됨

사용 가능한 크레딧 없음

계정의 API 크레딧이 모두 소진되었습니다.

다음에서 해결하세요: gamma.app/settings/billing

  • 자동 충전 활성화 (권장)

  • 필요할 때 크레딧 구매

  • 상위 플랜으로 업그레이드


404 찾을 수 없음

잘못된 생성 ID

생성 ID가 존재하지 않거나 다른 사용자에게 속해 있습니다.

POST 응답에서 올바른 generationId를 사용 중인지 확인하세요.


422 실패

생성이 완료되지 않음

생성 결과가 비어 있습니다.

요청을 검토하세요:

  • inputText에 충분한 내용이 있는지 확인

  • 매개변수가 입력과 일치하는지 확인

  • 필요하면 복잡한 지시를 단순화하세요.


429 너무 많은 요청

요청 한도 초과

요청 한도(시간당 50회 생성)를 초과했습니다.

참고: API는 넉넉한 용량을 제공합니다. 대부분 사용자는 정상 사용 시 이 한도에 도달하지 않습니다.

해결책:

  1. 더 높은 용량이 필요하면 Gamma Support에 문의하세요.

  2. 지수 백오프 구현

  3. 요청을 시간에 분산


500 내부 서버 오류

예기치 않은 서버 오류

일시적인 서버 문제가 발생했습니다.

  1. 잠시 기다렸다가 다시 시도하세요.

  2. 지속되면 x-request-id와 함께 지원팀에 문의하세요.


502 잘못된 게이트웨이

일시적인 게이트웨이 문제

일시적인 연결 문제가 발생했습니다.

잠시 기다렸다가 요청을 다시 시도하세요.



내 API 생성 프레젠테이션이 내 Gammas 목록에 없습니다.

API 생성 프레젠테이션은 Gamma 대시보드의 API Generated 섹션에 나타나며, 기본 Gammas 목록(전체, 최근 본 항목, 내가 만든 항목)에는 나타나지 않습니다. 이는 정상 동작이며, 프레젠테이션 이름 변경은 분류에 영향을 주지 않습니다.

해결 방법: 프레젠테이션을 열고 복제를 선택하세요. 복제본은 일반 웹 생성 Gamma로 처리되어 기본 Gammas 목록에 나타납니다.

추가 도움이 필요하신가요?

답변이 도움되었나요?