К основному содержимому

Устранение неполадок Gamma API

Область поддержки, распространённые коды ошибок и шаги по их устранению.

Руководство по устранению неполадок 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)

  • Неверные значения параметров

  • Превышены лимиты символов/токенов

Просмотрите сообщение об ошибке для конкретных деталей проверки.


401 Unauthorized

Неверный API ключ

Ваш API ключ недействителен или не связан с Pro аккаунтом.

  1. Убедитесь, что вы используете заголовок X-API-KEY (не Authorization)

  2. Сгенерировать новый API ключ на gamma.app/settings/billing

  3. Подтвердите, что у вашего аккаунта активен план Pro, Ultra, Teams или Business


403 Forbidden

Кредиты отсутствуют

В вашем аккаунте закончились API кредиты.

Исправьте это на gamma.app/settings/billing:

  • Включите авто-пополнение (рекомендуется)

  • Приобретайте кредиты по мере необходимости

  • Обновите план на более высокий уровень


404 Not Found

Неверный ID генерации

ID генерации не существует или принадлежит другому пользователю.

Проверьте, что вы используете правильный generationId из ответа POST.


422 Failed

Генерация не завершилась

Генерация вернула пустой результат.

Проверьте ваш запрос:

  • Убедитесь, что inputText содержит достаточный объём информации

  • Проверьте, что параметры соответствуют вашему вводу

  • Упростите сложные инструкции при необходимости


429 Too Many Requests

Превышен лимит запросов

Вы достигли лимита запросов (50 генераций в час).

Примечание: API имеет большую пропускную способность. Большинство пользователей не сталкиваются с этим лимитом при обычном использовании.

Решения:

  1. Обратитесь в Gamma Support для увеличения пропускной способности

  2. Реализуйте экспоненциальное увеличение интервалов повторных попыток

  3. Распределяйте запросы во времени


500 Internal Server Error

Неожиданная ошибка сервера

Произошла временная ошибка сервера.

  1. Подождите немного и попробуйте снова

  2. Если ошибка повторяется, обратитесь в поддержку с вашим x-request-id


502 Bad Gateway

Временная проблема шлюза

Произошла временная проблема с соединением.

Подождите немного и повторите запрос.



Моя презентация, созданная через API, не отображается в моём списке Gammas

Презентации, созданные через API, отображаются в разделе API Generated на панели Gamma, а не в основном списке Gammas (Все, Недавно просмотренные или Созданные вами). Это ожидаемое поведение — переименование презентации не меняет её категорию.

Обходной путь: Откройте презентацию и выберите Duplicate. Дубликат будет рассматриваться как обычная презентация, созданная через веб, и появится в вашем основном списке Gammas.

Нужна дополнительная помощь?

Нашли ответ на свой вопрос?