Что такое Gamma API?
У вас есть презентация, которая вам нравится? А что если вы сможете создать ещё 100 таких же, персонализированных для разных аудиторий по всему миру?
Gamma Generate API позволяет создавать презентации, документы, веб-страницы и социальные публикации программно без прямого использования приложения Gamma. Это идеально подходит для пользователей, которые хотят автоматизировать свои рабочие процессы с помощью таких инструментов, как Zapier, Make или n8n, интегрировать красивое создание презентаций в свои приложения или создавать презентации в большом объёме через интеграцию с серверным кодом.
Если вы разработчик, вы можете интегрировать Gamma в своё приложение, чтобы придать ему дизайнерские суперспособности!
💎 Совет профессионала: Сегодня любой может получить доступ к API на любом плане, включая Free, с щедрыми лимитами использования.
API готов?
Gamma API v1.0 доступен в общем доступе (GA) с 5 ноября 2025 года. Сегодня любой может получить доступ к API на любом плане с щедрыми лимитами использования.
Для подробной информации о конкретных параметрах API и их влиянии на создание презентаций обратитесь к нашей документации по API.
Как получить доступ?
Чтобы получить доступ к Gamma API, выполните следующие шаги.
Шаг 1: Сгенерировать ключ API
Перейдите в Настройки и Члены в вашем аккаунте, затем откройте вкладку API key. Нажмите Create API key, чтобы сгенерировать ключ, затем скопируйте и надежно сохраните его.
🔷 Примечание: Ключи API имеют формат sk-gamma-xxxxxxxx и должны передаваться с помощью заголовка X-API-KEY (не в формате Bearer token).
💎 Совет профессионала: Начните использовать API с любимыми инструментами автоматизации или интегрируйте напрямую в серверный код. Базовый URL: https://public-api.gamma.app/v1.0/
Можно ли аутентифицироваться через OAuth вместо ключа API?
Вы можете аутентифицироваться в Gamma REST API с помощью OAuth 2.0 вместо статического ключа API. OAuth позволяет подключать Gamma API к приложению без создания или хранения долгосрочного ключа API, что удобно для интеграций и партнерских приложений. Статические ключи API по-прежнему полностью поддерживаются, поэтому вы можете продолжать использовать заголовок X-API-KEY, если предпочитаете. Чтобы настроить OAuth, следуйте руководству Authenticate with OAuth в документации для разработчиков по адресу developers.gamma.app/get-started/authenticate-with-oauth.
Использование и лимиты запросов
Текущие лимиты API
API Gamma разработан для масштабирования под ваши нужды. Независимо от того, создаёте ли вы несколько презентаций или сотни, вы сможете работать в соответствии с вашими требованиями без ограничений при обычном использовании.
🌀 Совет: Если вы столкнулись с ограничением скорости (ошибки HTTP 429), обратитесь в нашу службу поддержки. Мы поможем вам обеспечить поддержку API для ваших задач!
Что может делать API
Gamma API охватывает полный жизненный цикл gamma — от создания до экспорта.
Генерация контента: Создавайте презентации, документы, веб-страницы и социальные публикации из вашего текста.
Создание из шаблона: Генерируйте новые gamma из шаблона, созданного в Gamma, сохраняя его макет и структуру карточек.
Редактирование существующих gamma: POST /v1.0/agent/gammas/{gammaId}/edits применяет изменение на естественном языке к одной странице.
Генерация агентом: POST /v1.0/agent/generations запускает генерацию из шаблона рабочего пространства, существующего gamma или официального шаблона Gamma.
Чтение, экспорт и анализ существующих gamma: Получение, комментарии, экспорт и аналитика.
Отдельная генерация изображений: Генерируйте отдельные изображения отдельно от полного gamma.
Формат веб-страницы: Генерируйте веб-страницы помимо презентаций, документов и социальных публикаций.
Настройка заголовков и подвалов: Настраивайте заголовки и подвали вашего контента.
URL изображений во входных данных: Ссылайтесь на изображения напрямую в вашем контенте.
Организация по папкам: Организуйте созданный контент в папки.
Поделиться по электронной почте: Программно делитесь контентом по электронной почте.
List APIs: Конечные точки для списка ваших тем и папок.
Поиск gamma: Ищите по заголовкам и полному тексту gamma, к которым у вас есть доступ, и фильтруйте результаты перед открытием.
Щедрые лимиты ввода: До 100 000 токенов (около 400 000 символов).
Можно ли генерировать отдельные изображения с помощью API?
Вы можете генерировать отдельные изображения с помощью Gamma API и через Model Context Protocol (MCP). Это позволяет создавать отдельные изображения программно, отдельно от генерации полной презентации, документа или веб-страницы. Чтобы генерировать изображения через API или MCP, следуйте руководству Create image generation в документации для разработчиков. Генерация изображений через MCP доступна в Claude, ChatGPT и других клиентах MCP.
Можно ли искать мои gamma с помощью API или MCP?
Вы можете искать всю свою библиотеку gamma через Gamma API или через AI-ассистента, подключенного к Gamma с помощью Model Context Protocol (MCP) — открытого стандарта, который позволяет AI-ассистентам подключаться к таким инструментам, как Gamma. Поиск охватывает заголовки и полный текст каждого gamma, к которому у вас есть доступ, и ранжирует результаты по релевантности, чтобы наиболее подходящий результат был первым. Каждый результат содержит прямую ссылку, чтобы вы могли открыть gamma прямо из ответа.
Вы можете сузить поиск по автору gamma и дате последнего обновления. Архивированные gamma по умолчанию исключены, но вы можете включить их.
Для полного списка параметров поиска и примеров запросов следуйте руководству Search gammas в документации для разработчиков по адресу developers.gamma.app/management/search-gammas.
Для чего можно использовать API?
Используйте Gamma API для платформ автоматизации, таких как Make, Zapier, Workato и других инструментов рабочих процессов. Вы также можете создавать собственные приложения с прямой интеграцией в серверный код, генерировать массовые презентации программно или создавать персонализированный контент в большом объёме.
🔷 Примечание: Ваш inputText должен содержать фактический контент для слайдов, а не инструкции по созданию презентации. Темы должны быть заранее созданы в Gamma и ссылаться по ID. Их нельзя создавать через inputText.
Поддержка шаблонов
Поскольку «templates» означает разное для разных пользователей, вот что доступно.
Визуальные темы: Вы можете определить внешний вид и стиль ваших презентаций, создавая пользовательские темы в Gamma, а затем используя их ID темы в API. Используйте List Themes API (GET /v1.0/themes), чтобы получить доступные ID тем.
Шаблоны структуры контента: Используйте Create from template. Создайте шаблон в Gamma, затем вызовите POST /v1.0/generations/from-template с его ID и подсказкой. Макет и структура карточек шаблона сохраняются по умолчанию, а ваша подсказка изменяет содержимое, аудиторию или язык. Шаблоны должны быть одностраничными гаммами из вашего рабочего пространства (на странице может быть много карточек). Найдите ID шаблонов с помощью GET /v1.0/templates/search.
Генерация агента: POST /v1.0/agent/generations также может начинаться с шаблона рабочего пространства, существующей гаммы или официального шаблона Gamma (templateId).
Получение помощи и поддержки
Документация и ресурсы
Для полного технического справочника посетите документацию для разработчиков. Доступ к API включён во все планы, включая Free.
Помощь с отладкой
Если вам нужна помощь с проблемами API, ознакомьтесь с нашей документацией по ошибкам для распространённых проблем и решений, затем обратитесь в службу поддержки клиентов. Всегда указывайте x-request-id из вашего ответа API при запросе помощи.
Каждый ответ API содержит этот уникальный идентификатор в заголовках. Для **Make.com пользователей** найдите его в разделе Output → Bundle → Headers. Для Zapier проверьте раздел Run Details → Data Out в истории задач для успешных запусков или вкладку Logs → Response information (разверните заголовки) для неудачных запросов.
💎 Полезный совет: Всегда указывайте ваш request ID, точное сообщение об ошибке и пример тела запроса при обращении в поддержку.
Область поддержки
Мы можем помочь с
Мы можем помочь с проблемами API, специфичными для Gamma, вопросами аутентификации и ключей API, пониманием сообщений об ошибках, вопросами лимитов запросов и использования кредитов.
Мы не можем помочь с
Мы не можем отлаживать или писать пользовательский код, создавать полные рабочие процессы в Zapier, Make или N8N, отлаживать пользовательские приложения, давать инструкции по использованию Zapier, Make или N8N, или проектировать пользовательскую архитектуру.
При запросе помощи по API, пожалуйста, предоставьте ваш request ID, сообщение об ошибке, пример тела запроса и платформу автоматизации, которую вы используете.
Распространённые коды ошибок
401 Unauthorized: Неверный ключ API. Убедитесь, что вы используете заголовок X-API-KEY (не Authorization или Bearer).
403 Forbidden: Проверьте баланс кредитов и убедитесь, что авто-пополнение включено.
429 Too Many Requests: Вы превысили лимит запросов. Свяжитесь со службой поддержки Slack для увеличения лимита.
422 Failed: Генерация не удалась. Проверьте параметры ввода.
Нужна помощь с началом работы?
Для базового устранения неполадок и распространённых проблем с API ознакомьтесь с нашим подробным руководством по устранению неполадок. Также вы можете просмотреть полную документацию для разработчиков с подробным справочником API и примерами.
Часто задаваемые вопросы и распространённые проблемы
Могу ли я редактировать существующую гамму через API?
Да.
POST /v1.0/agent/gammas/{gammaId}/editsприменяет инструкцию на естественном языке к одной странице гаммы, которую вы можете редактировать, например «обновить карточку с ценами новыми уровнями».Опросите
GET /v1.0/agent/edits/{editId}для получения результата.Редактирования не могут добавлять страницы, и на одной странице одновременно выполняется только одно редактирование.
Такая же возможность доступна в Claude, ChatGPT, Slack и других MCP клиентах.
Может ли мой собственный AI агент использовать Gamma?
Да. Подключите любой MCP клиент к
https://mcp.gamma.app/mcpи войдите с вашим аккаунтом Gamma. Это работает на всех планах.Пользовательские клиенты должны сначала зарегистрировать свои OAuth redirect URI.
Могу ли я делиться своими API ключами с другими?
API ключи должны храниться в безопасности и не передаваться другим.
При необходимости создавайте отдельные ключи для разных случаев использования.
Почему я не могу снова скопировать свой API ключ?
По соображениям безопасности API ключи показываются только один раз при создании.
Если вы потеряете ключ, вам нужно будет создать новый.
Могу ли я создать несколько API ключей?
Да, вы можете создавать несколько API ключей для разных проектов или случаев использования через настройки аккаунта.
Какие гаммы отображаются в результатах поиска API или MCP?
Поиск возвращает только те гаммы, к которым у вас уже есть доступ, поэтому он никогда не показывает контент, который вы не можете открыть в Gamma.
Результаты ранжируются по релевантности, с наиболее подходящим совпадением запроса в начале.
Архивные гаммы исключаются, если вы не выберете их включение.
Вы также можете фильтровать по создателю и по дате последнего обновления гаммы.
Почему поиск не работает в моём workspace?
Поиск по вашим gammas внедряется постепенно и ещё не доступен для каждого workspace.
Если он недоступен, свяжитесь с Customer Support и укажите ваш
x-request-id, чтобы мы могли проверить ваш workspace.Редактор: удалите этот FAQ, если поиск подтверждён на 100%.
Что произойдет, если у меня закончатся кредиты?
Включите авто-пополнение в ваших billing Настройках на gamma.app/settings/billing, чтобы обеспечить непрерывный доступ к API.
Где в панели Gamma отображаются презентации, созданные через API?
Презентации, созданные через API, отображаются в разделе API Generated панели Gamma, а не в вашем основном списке Gammas (Все, Недавно просмотренные или Созданные вами).
Чтобы презентация, созданная через API, появилась в вашем обычном списке Gammas, откройте её и выберите Duplicate. Дубликат рассматривается как стандартный gamma, созданный через веб, и будет отображаться во всех обычных видах.