Как обновить воркфлоу n8n для Gamma API v1.0

Важное обновление: отключение Gamma API v0.2

Если вы используете API Gamma в n8n для автоматического создания презентаций, обновить воркфлоу нужно до 31 января 2026 года. Gamma прекращает поддержку конечных точек API v0.2, и все воркфлоу, которые продолжат использовать старую версию, после этой даты перестанут работать.

Хорошая новость: миграция ПО несложная и занимает всего несколько минут. В этом руководстве подробно показано, что именно нужно изменить.

Что меняется в Gamma API v1.0

Самое значимое изменение в API v1.0 — способ указания тем. Вместо понятных человеку названий тем новый API требует идентификаторы тем.

Старый способ (v0.2):

“themeName”: “Oasis”

Новый способ (v1.0):

“themeId”: “theme_abc123xyz”

Это изменение повышает стабильность API и позволяет точнее выбирать тему, но требует однократного обновления ваших воркфлоу.

Пошаговая миграция для пользователей n8n

Шаг 1. Откройте воркфлоу в n8n

Перейдите в свой экземпляр n8n и откройте воркфлоу, который использует API Gamma. Найдите узел HTTP Request, который обращается к API Gamma.

Шаг 2. Обновите URL API

В узле HTTP Request замените URL:

https://public-api.gamma.app/v0.2/generations

На:

https://public-api.gamma.app/v1.0/generations

Шаг 3. Получите идентификатор темы в Gamma

Это самый важный шаг. Вот как найти идентификатор темы:

1. Войдите в аккаунт Gamma на gamma.app
2. Нажмите значок палитры в панели навигации, чтобы открыть Design Library
3. Найдите тему, которую хотите использовать для презентаций
4. Нажмите три точки (⋯) рядом с названием темы
5. Выберите в меню «Copy theme ID for API»

Идентификатор темы будет скопирован в буфер обмена. Он выглядит примерно так: theme_12345abcde

Шаг 4. Обновите JSON-запрос

В узле HTTP Request n8n найдите раздел с телом JSON. Замените параметр themeName на themeId:

До:

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeName”: “Oasis”, “numCards”: 10 }

После:

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeId”: “theme_12345abcde”, “numCards”: 10 }

Шаг 5. Сохраните и проверьте

Сохраните обновлённый воркфлоу. Если вы используете n8n v2.0+, опубликуйте новую версию. Если у вас v1.x, активируйте воркфлоу.

Запустите тестовое выполнение, чтобы убедиться, что всё работает правильно с новой версией API.

Альтернатива: использовать тему Gamma по умолчанию

Если конкретная пользовательская тема вам не нужна, миграцию можно упростить, полностью убрав параметр темы. API v1.0 автоматически применит стандартную тему Gamma по умолчанию:

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “numCards”: 10 }

Что делать, если у меня несколько воркфлоу?

Если несколько воркфлоу n8n используют API Gamma, обновлять придётся каждый по отдельности. Процесс для каждого одинаков:

1. Обновите URL API до v1.0
2. Замените themeName на themeId
3. Используйте один и тот же идентификатор темы во всех воркфлоу (или получите разные идентификаторы, если хотите разные темы)

Рекомендуем записать идентификаторы тем в одном месте, чтобы их было удобно использовать при создании новых воркфлоу.

Дополнительные материалы

• Официальная документация Gamma API
• Справочный центр Gamma API

Нужна помощь?

Если при миграции возникли проблемы, ещё раз проверьте:

• Не изменился ли ваш ключ API (он должен остаться прежним)
• Скопировали ли вы идентификатор темы из Gamma полностью
• Используете ли вы правильный URL конечной точки v1.0
• Корректен ли синтаксис JSON (следите за пропущенными запятыми и кавычками)

Срок 31 января 2026 года стремительно приближается, поэтому обновите воркфлоу как можно скорее. Миграция несложная, и после её завершения автоматическое создание презентаций будет по-прежнему работать без сбоев с улучшенным API v1.0.