Руководство по устранению неполадок Gamma API
Хотя мы и хотели бы помочь со всеми вопросами API, имейте в виду, что наша служба поддержки не может создавать рабочие процессы, отлаживать ваш серверный код (FastAPI, Express, Django и т. д.) или устранять специфические для платформы проблемы.
Мы можем помочь с вопросами, связанными с Gamma, касающимися наших endpoints и параметров, аутентификации API, устранения ошибок, кредитов и проверки соответствия вашего запроса нашей документации.
Для помощи, специфичной для платформы, обращайтесь в Zapier Support, Make Support или N8N Support.
Для получения дополнительной информации об API Gamma смотрите: developers.gamma.app
Распространённые коды ошибок
400 Bad Request
Неверные параметры
Проверьте ваш запрос на наличие:
Отсутствуют обязательные поля (
inputText,textMode).Недопустимые значения параметров.
Превышены ограничения по символам или токенам.
Для
from-template: шаблон должен быть одностраничным workspace gamma. Официальные Explore templates и многостраничные gammas отклоняются.
Просмотрите сообщение об ошибке для получения конкретных деталей проверки.
401 Unauthorized
Неверный API ключ
Ваш API ключ недействителен или не связан с Pro аккаунтом.
Убедитесь, что вы используете заголовок
X-API-KEY(не Authorization).Сгенерировать новый API ключ на gamma.app/settings/api-keys.
Подтвердите, что у вашего аккаунта активен план Pro, Ultra, Teams или Business.
403 Forbidden
Кредиты отсутствуют
Ваш аккаунт исчерпал API кредиты.
Исправьте это на gamma.app/settings/billing:
Включите авто-пополнение (рекомендуется).
Приобретайте кредиты по мере необходимости.
Обновите план на более высокий уровень.
404 Not Found
Неверный generation или gamma ID
ID generation не существует или принадлежит другому пользователю. Эта ошибка также возвращается для gamma ID, к которому у вас нет доступа при чтении, редактировании или экспорте существующего gamma.
Проверьте, что вы используете правильный generationId из ответа POST или что у вас есть доступ к целевому gamma.
422 Failed
Генерация не завершилась
Генерация выдала пустой результат.
Проверьте ваш запрос:
Убедитесь, что
inputTextсодержит достаточный объём информации.Проверьте, что параметры соответствуют вашему вводу.
При необходимости упростите сложные инструкции.
429 Too Many Requests
Превышен лимит запросов
Вы достигли лимита запросов. Лимиты установлены для каждого владельца API ключа и для каждого workspace, текущие значения указаны в справочнике по кодам ошибок.
🔷 Примечание: API имеет большую пропускную способность. Большинство пользователей никогда не сталкиваются с этим лимитом при обычном использовании.
Решения:
Обратитесь в Gamma Support для увеличения пропускной способности.
Реализуйте экспоненциальное ожидание повторных попыток.
Распределяйте запросы во времени.
500 Internal Server Error
Неожиданная ошибка сервера
Произошла временная ошибка сервера.
Подождите немного и попробуйте снова.
Если ошибка повторяется, обратитесь в поддержку с вашим
x-request-id.
502 Bad Gateway
Временная проблема шлюза
Произошла временная проблема с соединением.
Подождите немного и повторите запрос.
Моя презентация, созданная через API, не отображается в списке Gammas
Презентации, созданные через API, отображаются в разделе API Generated на панели Gamma, а не в основном списке Gammas (Все, Недавно просмотренные или Созданные вами). Это ожидаемое поведение, и переименование презентации не меняет её категорию.
Обходной путь: Откройте презентацию и выберите Duplicate. Дубликат будет рассматриваться как обычный gamma, созданный через веб, и появится в основном списке Gammas.
Нужна дополнительная помощь?
Общая поддержка: Как связаться с поддержкой Gamma.
Сообщество API: Присоединяйтесь к Gamma API Slack.
Проблемы с SSO: Обратитесь к IT-администратору вашей организации.