Что такое Gamma API?
У вас есть презентация, которая вам нравится? А что если вы сможете создать ещё 100 таких же, персонализированных для разных аудиторий по всему миру?
Gamma Generate API позволяет создавать презентации, документы, веб-страницы и социальные публикации программно, без прямого использования приложения Gamma. Это идеально для пользователей, которые хотят автоматизировать свои рабочие процессы с помощью таких инструментов, как Zapier, Make или n8n, интегрировать красивое создание презентаций в свои приложения или создавать презентации в большом объёме через интеграцию с серверным кодом.
Если вы разработчик, вы можете интегрировать Gamma в своё приложение, чтобы придать ему дизайнерские суперспособности!
💎 Совет профессионала: Любой пользователь с аккаунтом Pro или выше может сегодня получить доступ к API с щедрыми лимитами использования.
API готов?
Gamma API v1.0 доступен с 5 ноября 2025 года. Любой пользователь с аккаунтом Pro или выше может сегодня получить доступ к API с щедрыми лимитами использования.
Для подробной информации о конкретных параметрах 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).
💎 Совет профессионала: Начинайте использовать 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 поддерживает ваши задачи!
Что нового в версии 1.0?
API v1.0 включает несколько мощных новых функций:
Формат веб-страниц: Генерируйте веб-страницы помимо презентаций, документов и социальных публикаций.
Настройка заголовков и подвалов: Настраивайте заголовки и подвали вашего контента.
URL изображений во входных данных: Ссылайтесь на изображения напрямую в вашем контенте.
Организация в папки: Организуйте созданный контент в папки.
Поделиться по электронной почте: Программно отправляйте контент по email.
API для списков: Новые конечные точки для получения списков ваших Темы и Папки.
Поиск 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. Также вы можете ознакомиться с нашей посадочной страницей для обзора и руководства по началу работы. Доступ к API включён в подписки Pro, Ultra, Teams и Business.
Помощь в отладке
Если у вас проблемы с API, ознакомьтесь с нашей документацией по ошибкам для распространённых проблем и решений, затем обратитесь в службу поддержки. Всегда указывайте x-request-id из ответа API при обращении за помощью.
Каждый ответ API содержит этот уникальный идентификатор в заголовках. Для пользователей Make.com он находится в разделе Output → Bundle → Headers. Для Zapier смотрите Run Details → Data Out в истории задач для успешных запусков или вкладку Logs → Response information (разверните заголовки) для неудачных запросов.
💎 Совет профессионала: Всегда указывайте ваш request ID, точное сообщение об ошибке и пример тела запроса при обращении в поддержку.
Область поддержки
Чем мы можем помочь
Мы помогаем с проблемами, связанными с Gamma API, аутентификацией и 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 ключей для разных проектов или случаев использования через настройки аккаунта.
Какие gammas отображаются в результатах поиска API или MCP?
Поиск возвращает только те gammas, к которым у вас уже есть доступ, поэтому не раскрывает контент, который вы не можете открыть в Gamma.
Результаты ранжируются по релевантности, с наиболее подходящим совпадением в начале.
Архивные gammas исключены, если вы не выберете их включение.
Вы также можете фильтровать по создателю и дате последнего обновления gamma.
Почему поиск не работает в моём рабочем пространстве?
Поиск по gammas внедряется постепенно и пока не доступен во всех рабочих пространствах.
Если поиск недоступен, обратитесь в службу поддержки и укажите ваш
x-request-id, чтобы мы могли проверить ваше рабочее пространство.
Что произойдет, если у меня закончатся кредиты?
Включите авто-пополнение в настройках billing на gamma.app/settings/billing, чтобы обеспечить непрерывный доступ к API.
Где появляются презентации, созданные через API, на панели Gamma?
Презентации, созданные через API, появляются в разделе API Generated на панели Gamma, а не в основном списке Gammas (Все, Недавно просмотренные или Созданные вами).
Чтобы презентация, созданная через API, появилась в вашем обычном списке Gammas, откройте её и выберите Duplicate. Дубликат будет рассматриваться как стандартный gamma, созданный через веб, и появится во всех обычных представлениях.