Что такое Gamma API?
У вас есть презентация, которая вам нравится? А что если вы сможете создать ещё 100 таких же, персонализированных для разных аудиторий по всему миру?
Gamma Generate API позволяет создавать презентации, документы, веб-страницы и социальные посты программно, без прямого использования приложения Gamma. Это идеально для пользователей, которые хотят автоматизировать свои рабочие процессы с помощью таких инструментов, как Zapier, Make или n8n, интегрировать красивое создание презентаций в свои приложения или создавать презентации в большом объёме через интеграцию с серверным кодом.
Если вы разработчик, вы можете интегрировать Gamma в своё приложение, чтобы придать ему дизайнерские суперспособности!
💎 Совет Pro: Любой пользователь с аккаунтом Pro или выше может сегодня получить доступ к API с щедрыми лимитами использования.
API готов?
Gamma API v1.0 доступен для общего пользования (GA) с 5 ноября 2025 года. Любой пользователь с аккаунтом Pro или выше может сегодня получить доступ к API с щедрыми лимитами использования.
🔷 Примечание: API v0.2 устарел и будет отключён 16 января 2026 года. Если вы сейчас используете v0.2, пожалуйста, перейдите на v1.0 до этой даты.
Для подробной информации о конкретных параметрах API и их влиянии на создание презентаций обратитесь к нашей документации по API.
Как получить доступ?
Чтобы получить доступ к Gamma API, выполните следующие шаги.
Шаг 1: Обновите свой аккаунт
У вас должен быть аккаунт Gamma Pro, Ultra, Team или Business. Если у вас сейчас нет аккаунта Pro или выше, обновитесь до Pro, чтобы получить доступ к API.
Шаг 2: Сгенерировать API ключ
Перейдите в Настройки и Члены в вашем аккаунте Pro, затем на вкладку API key. Нажмите Create API key, чтобы сгенерировать ключ, затем скопируйте и надежно сохраните его.
🔷 Примечание: API ключи имеют формат sk-gamma-xxxxxxxx и должны передаваться с помощью заголовка X-API-KEY (не в формате Bearer token).
💎 Совет Pro: Начните использовать 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 поддерживал ваши задачи!
Что нового в v1.0?
API v1.0 включает несколько мощных новых функций:
Формат веб-страниц: Создавайте веб-страницы помимо презентаций, документов и социальных постов.
Настройка заголовков и подвалов: Настраивайте заголовки и подвалы вашего контента.
URL изображений во входных данных: Ссылайтесь на изображения напрямую в вашем контенте.
Организация в папки: Организуйте созданный контент в папки.
Поделиться по электронной почте: Программно отправляйте контент по email.
List APIs: Новые конечные точки для списка ваших Темы и Папки.
Поиск gammas: Ищите по заголовкам и полному тексту gammas, к которым у вас есть доступ, и фильтруйте результаты перед открытием.
Лучшие лимиты ввода: До 100 000 токенов (около 400 000 символов).
🌀 Совет: По мере развития API мы продолжим добавлять больше опций для программного изменения и ремикса Gammas.
Можно ли создавать отдельные изображения с помощью API?
Теперь вы можете создавать отдельные изображения с помощью Gamma Generate API и через Model Context Protocol (MCP). Это позволяет программно создавать отдельные изображения, отдельно от создания полной презентации, документа или веб-страницы. Чтобы создавать изображения через API или MCP, следуйте руководству Create image generation в документации для разработчиков на developers.gamma.app/images/create-image-generation. Создание изображений через MCP доступно в Claude и других клиентах MCP сегодня; пока недоступно в ChatGPT.
Можно ли искать мои gammas с помощью API или MCP?
Вы можете искать всю вашу библиотеку gammas через Gamma API или через AI-ассистента, подключенного к Gamma с помощью Model Context Protocol (MCP) — открытого стандарта, который позволяет AI-ассистентам подключаться к таким инструментам, как Gamma. Поиск охватывает заголовки и полный текст каждого gamma, к которому у вас есть доступ, и ранжирует результаты по релевантности, чтобы наиболее подходящие появлялись первыми. Каждый результат содержит прямую ссылку, чтобы вы могли открыть gamma прямо из ответа.
Вы можете сузить поиск по создателю gamma и дате последнего обновления. Архивные gammas по умолчанию исключены, но вы можете включить их.
🔷 Примечание: Поиск внедряется постепенно, поэтому пока недоступен во всех рабочих пространствах. Если у вас не работает конечная точка поиска или инструмент поиска MCP, значит ваше рабочее пространство ещё не получило эту функцию.
Для полного списка параметров поиска и примеров запросов следуйте руководству Search gammas в документации для разработчиков на developers.gamma.app/management/search-gammas.
Для чего можно использовать API?
Используйте Gamma API для платформ автоматизации, таких как Make, Zapier, Workato и других инструментов рабочих процессов. Вы также можете создавать собственные приложения с прямой интеграцией в серверный код, генерировать презентации оптом, создавая несколько презентаций программно, или создавать персонализированный контент в большом объёме.
🔷 Примечание: Ваш inputText должен содержать фактический контент для слайдов, а не инструкции по созданию презентации. Темы должны быть заранее созданы в Gamma и ссылаться по ID. Их нельзя создавать через inputText.
Поддержка шаблонов
Поскольку "шаблоны" означают разное для разных пользователей, вот что доступно.
Визуальные темы: Вы можете определить внешний вид ваших презентаций, создавая пользовательские Темы в Gamma и ссылаясь на них в API по ID темы. Используйте List Themes API (GET /v1.0/themes), чтобы получить доступные ID Тем.
Шаблоны структуры контента: Мы работаем над добавлением строгой поддержки структуры контента в будущих обновлениях.
Получение помощи и поддержки
Документация и ресурсы
Для полного технического справочника посетите документацию API Reference. Также вы можете ознакомиться с нашей Landing Page для обзора и руководства по началу работы. Доступ к API включён в подписки Pro, Ultra, Teams и Business.
Помощь с отладкой
Если вам нужна помощь с проблемами API, ознакомьтесь с нашей документацией по ошибкам для распространённых проблем и решений, затем обратитесь в Customer Support. Всегда указывайте 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 ключами с другими?
API ключи должны храниться в безопасности и не передаваться другим.
При необходимости создавайте отдельные ключи для разных случаев использования.
Почему я не могу снова скопировать свой API ключ?
По соображениям безопасности API ключи показываются только один раз при создании.
Если вы потеряете ключ, вам нужно будет сгенерировать новый.
Могу ли я сгенерировать несколько API ключей?
Да, вы можете создать несколько API ключей для разных проектов или случаев использования через настройки вашего аккаунта.
Какие gammas отображаются в результатах поиска API или MCP?
Поиск возвращает только те gammas, к которым у вас уже есть доступ, поэтому он никогда не показывает контент, который вы не можете открыть в Gamma.
Результаты ранжируются по релевантности, сначала показывается наиболее подходящее совпадение с вашим запросом.
Архивные gammas не включаются, если вы не выберете их включение.
Вы также можете фильтровать по создателю и дате последнего обновления gamma.
Почему поиск не работает в моём рабочем пространстве?
Поиск по вашим gammas внедряется постепенно и ещё не доступен во всех рабочих пространствах.
Если он недоступен, свяжитесь с Customer Support и укажите ваш
x-request-id, чтобы мы могли проверить ваше рабочее пространство.
Нужно ли мне мигрировать с v0.2 на v1.0?
Да, поддержка v0.2 завершится 16 января 2026 года.
Миграция проста: обновите базовый URL с
/v0.2/на/v1.0/.Измените параметр
themeNameнаthemeId(получите ID через List Themes API).Обновите лимиты ввода — в v1.0 используется 100k токенов вместо 750k символов.
Проверьте документацию API для полного описания конечных точек v1.0.
В чём основные отличия между v0.2 и v1.0?
v1.0 предлагает гораздо более щедрые лимиты запросов (сотни в час против 50 в день).
v1.0 поддерживает формат веб-страниц.
Лучшие лимиты ввода (100k токенов против 750k символов).
Организация папок и List API для Темы и папок.
Что произойдет, если у меня закончатся кредиты?
Включите авто-пополнение в ваших billing Настройках на gamma.app/settings/billing, чтобы обеспечить непрерывный доступ к API.
Где в панели Gamma отображаются презентации, созданные через API?
Презентации, созданные через API, появляются в разделе API Generated панели Gamma, а не в основном списке ваших Gammas (Все, Недавно просмотренные или Созданные вами).
Чтобы презентация, созданная через API, появилась в вашем обычном списке Gammas, откройте её и выберите Duplicate. Дубликат считается стандартной gamma, созданной через веб, и будет отображаться во всех обычных видах.