# Справка

# Начало работы

Раздел справки Строфи целиком, статьи в порядке чтения. Источник: https://strophe.app/docs/product/start

# Что такое Строфи

> Как устроен проект в Строфи — холст, блоки и соединения — и почему работа собирается цепочкой генераций, а не одним запросом.

Источник: https://strophe.app/docs/product/start/what-is-strophe
Обновлено: 2026-08-19

Строфи — платформа, где нейросети генерируют содержимое прямо на холсте проекта. Прежде чем разбираться в конкретных блоках и моделях, полезно увидеть общую картину: из каких частей состоит проект и как они связаны друг с другом. Это база, на которую опираются остальные статьи справки.

## Из чего состоит проект

Рабочая единица в Строфи — проект: его создают, переименовывают, копируют и хранят в общем списке проектов. Холст — рабочая область проекта: открыв проект, вы сразу оказываетесь на холсте и добавляете блоки прямо на него.

Блок — это одна единица содержимого или действия на холсте. Одни блоки хранят содержимое, их называют контентными: текст, изображение, видео, звук или 3D-модель. Другие — блоки генерации — создают содержимое по выбранной модели. Соединения между блоками указывают, из какого блока берутся данные и в какой блок передаётся готовый результат.

Генерацию запускают двумя путями. Блок генерации собирает её из соединений: берёт то, что подключено к его входам, отправляет запрос модели и передаёт результат в блок на другом конце соединения. У контентных блоков изображения, видео и текста есть собственная кнопка Сгенерировать: она открывает панель генерации прямо для этого блока, и результат приходит в него же.

Кнопки «Сохранить» в Строфи нет: проект сохраняется сам — как это устроено и когда правки всё же теряются, разобрано в статье [Автосохранение и синхронизация](https://strophe.app/docs/product/projects/autosave-and-sync).

Дальше про сами блоки — в статье [Какие бывают блоки](https://strophe.app/docs/product/canvas/block-types), про соединения между ними — в статье [Соединения между блоками](https://strophe.app/docs/product/canvas/connections).

## Почему это цепочка, а не отдельный запрос

Результат генерации в Строфи — не разовый вывод, который забирают и на этом заканчивают работу с ним, а содержимое блока на холсте. Это содержимое подключается как исходные данные к следующему блоку генерации: изображение — как основа для видео, текст одного блока — как промпт для другого, результат одной модели — как исходное изображение для другой.

Поэтому типичная работа в Строфи — это цепочка из нескольких соединённых блоков генерации, а не единственный запрос к одной модели. Чтобы получить сложный результат, на холсте выстраивают последовательность шагов, где каждый следующий блок опирается на готовое из предыдущего, а не описывают всё желаемое в одном промпте.

## Что можно генерировать

Строфи генерирует пять видов содержимого: текст, изображение, видео, звук и 3D-модель. Для каждого вида есть свой блок генерации — он читает промпт и, если модель это поддерживает, подключённые исходные файлы, и создаёт результат нужного вида.

Внутри каждого вида в каталоге собрано несколько моделей от разных провайдеров, а состав каталога пополняется по мере выхода новых моделей.

## Как оплачивается генерация и кто ещё может увидеть проект

Генерация в Строфи оплачивается кредитами: у большинства моделей стоимость запуска видна на блоке ещё до нажатия. Подробно о видах кредитов и порядке их списания — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

Проектом можно поделиться по публичной ссылке. Тот, кто откроет её, увидит холст и все блоки в режиме только для чтения — без возможности что-то изменить, соединить или запустить генерацию. Скопировать проект себе гость может, если вы это разрешили. Доступ выключается тем же переключателем, каким включался, и ссылка сразу перестаёт открывать проект — подробнее в статье [Публичная ссылка на проект](https://strophe.app/docs/product/projects/sharing).

---

# Первая генерация

> Пошаговый путь к первому изображению: добавить блок генерации, подать промпт из текстового блока, выбрать модель и запустить.

Источник: https://strophe.app/docs/product/start/first-generation
Обновлено: 2026-08-07

Первый результат отделяют от пустого холста два-три действия: добавить блок генерации, подать в него текстовое описание и нажать запуск. Ниже путь разобран на изображении — с текстом, видео, звуком и 3D-моделью он устроен так же, меняется только тип блока. За каждым шагом стоит отдельная статья, если захочется разобраться глубже.

## Что нужно перед стартом

На балансе должно быть достаточно кредитов: каждый запуск списывает кредиты, и при нулевом балансе кнопка запуска не сработает. При регистрации на аккаунт начисляются подарочные кредиты, так что для первой генерации обычно ничего докупать не нужно. Как устроено списание и что делать, если кредитов не хватает, — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

Больше ничего готовить не нужно: после входа вы сразу оказываетесь в проекте с пустым холстом.

## Шаг 1. Добавьте блок генерации изображения

Блок генерации — элемент холста, который превращает описание в готовый результат. Его добавляют из каталога блоков по сочетанию `Cmd/Ctrl + K`: в каталоге собраны все модели, и вы сразу выбираете нужную.

Кнопка изображения на верхней панели и клавиша `I` кладут на холст другой блок — пустой контентный блок изображения. Он тоже приводит к результату: у него есть кнопка Сгенерировать, которая открывает панель генерации с выбором модели. Все способы добавить блок — в статье [Как добавить блок на холст](https://strophe.app/docs/product/canvas/creating-blocks).

## Шаг 2. Подготовьте промпт

Промпт — это текстовое описание того, что вы хотите получить. В самом блоке генерации поля для текста нет: описание берётся из отдельного текстового блока, подключённого к точке входа Промпт. Собственное поле промпта есть только у панели генерации — её открывает кнопка Сгенерировать на контентном блоке.

Добавьте текстовый блок (кнопкой текста на панели или клавишей `T`), впишите в него описание будущего изображения и протяните соединение от текстового блока к входу Промпт блока генерации. В момент запуска Строфи прочитает текст из этого блока и отправит его в модель.

## Шаг 3. Запустите генерацию

Запуск — круглая кнопка со стрелкой в нижней части блока генерации. Рядом с ней показана стоимость запуска в кредитах: у большинства моделей она известна заранее, а там, где цена зависит от длины ответа или длительности исходного видео, окончательную сумму видно после генерации. Запустить можно и клавишей `Enter`, когда блок генерации выделен на холсте.

Строфи ставит задачу в очередь — пока модель работает, блок показывает, что генерация идёт.

## Куда приходит результат

Если выход блока генерации ни с чем не соединён, Строфи создаёт новый блок рядом и сразу подключает его — искать место на холсте вручную не нужно. Готовое изображение появится именно в нём.

Как устроен блок генерации внутри — входы, выбор варианта модели под тип входа, что показано до запуска и куда идёт результат при нескольких подключённых блоках — в статье [Как работает генерация](https://strophe.app/docs/product/generation/how-it-works).

## Что дальше

Первый результат можно сразу пустить в дело. Протяните соединение от блока с готовым изображением к входу нового блока генерации — и следующая модель будет отталкиваться от неё: доработает, изменит стиль или превратит в видео.

Так из отдельных блоков собирается цепочка, где результат одной генерации становится исходным материалом для следующей.

---

# Обзор редактора

> Карта редактора Строфи: верхняя панель с проектом и балансом, нижняя панель навигации, каталог блоков, панель генерации и настройки.

Источник: https://strophe.app/docs/product/start/interface-tour
Обновлено: 2026-08-19

Редактор — это экран открытого проекта: холст на весь экран, а вокруг него панели с инструментами. Эта статья показывает, где что находится, чтобы вы находили нужную кнопку сразу, а не искали её по всему экрану.

В центре — сам холст: на него добавляют блоки и соединяют их между собой, здесь идёт вся работа над проектом. По краям холст обрамляют верхняя панель, панель навигации снизу и панель генерации.

## Верхняя панель

Слева — логотип, он ведёт на сайт Строфи, и название текущего проекта. Рядом с названием прячется меню проекта: «Поделиться» открывает окно с настройками публичного показа, а рядом — скопировать ссылку, сделать копию проекта, переименовать или удалить.

По центру верхней панели стоят инструменты, которые добавляют на холст пустые блоки: текст, изображение, видео, аудио, 3D и стикер. Здесь же — загрузка файла с компьютера и кнопка «Все блоки», открывающая каталог. Как этими инструментами пользоваться — в статье [Как добавить блок на холст](https://strophe.app/docs/product/canvas/creating-blocks).

Справа — счётчик баланса кредитов и меню аккаунта. Когда генерации идут, рядом со счётчиком появляется число задач в очереди, а при наведении виден их список с состоянием и кнопкой отмены.

Меню аккаунта открывается кликом по фото профиля. Сверху видно ваше имя и адрес, под которым вы вошли, рядом — переключение между аккаунтами, а в самом меню:

- «Текущий план» — тариф, оплата и покупка кредитов;
- «Подарить подписку» — оплата подписки другому человеку;
- «Аналитика» — расход кредитов и список всех генераций;
- «Настройки» — профиль, оформление, управление холстом и эксперименты;
- «Помощь» — подпункты «Горячие клавиши», «Справка» и «Связаться с нами»;
- «Выйти» — выход из аккаунта.

## Нижняя панель навигации

Нижняя панель плавает по центру у нижнего края и отвечает за то, как вы двигаетесь по холсту и правите расположение блоков.

Слева на ней — два способа работы с холстом: «Выделение» (обычный курсор, которым вы выбираете и двигаете блоки) и «Перемещение» (рука, которая двигает вид по холсту). Правее — «Отменить» последнее действие и «Повторить», то есть вернуть то, что вы только что отменили.

Когда выделено несколько блоков, на панели дополнительно появляются группировка, выравнивание по краям и центру, распределение с равными промежутками и кнопка, которая скачивает все выбранные результаты разом.

В правом нижнем углу холста находится миникарта — уменьшённая схема всего проекта. Рядом с ней кнопки приближения и отдаления и текущий масштаб в процентах. Клик по проценту открывает меню, где кроме приближения и отдаления есть «Сбросить масштаб» и «Отобразить все» — последнее подгоняет вид так, чтобы уместился весь проект (`Shift + 1`). Как перемещаться по холсту мышью и трекпадом, приближать и отдалять вид — в статье [Навигация по холсту](https://strophe.app/docs/product/canvas/canvas-navigation).

## Каталог блоков

Каталог — это полный список моделей генерации и вспомогательных блоков. Он открывается кнопкой «Все блоки» в верхней панели или сочетанием `Cmd/Ctrl + K`. Пустые контентные блоки — текст, стикер, изображение, видео, 3D, аудио — в каталоге не перечислены: их добавляют кнопками верхней панели и клавишами-буквами. Что внутри и как искать — в статье [Как добавить блок на холст](https://strophe.app/docs/product/canvas/creating-blocks).

## Панель генерации

Как только вы выбираете блок изображения, видео или текста, у нижнего края холста разворачивается панель генерации. Это рабочее место одного блока: здесь вы задаёте, что и чем сгенерировать, и отсюда же запускаете. Панель растягивается по высоте за верхний край, когда запрос длинный и хочется видеть его целиком. Что в ней настраивается — в статье [Как работает генерация](https://strophe.app/docs/product/generation/how-it-works).

## Настройки

Настройки открываются из меню аккаунта в правом верхнем углу пунктом «Настройки». Они делятся на три раздела: «Основные» — оформление и поведение холста, «Профиль» — имя, никнейм и фото, «Эксперименты» — функции, которые ещё обкатываются. Что настраивается в каждом — в статье [Настройки](https://strophe.app/docs/product/account/settings).

---

# Что делать при ошибках

> Первые шаги, если генерация не запускается, правки не сохраняются или файл не загружается, и ссылки на подробный разбор каждой ситуации.

Источник: https://strophe.app/docs/product/start/troubleshooting
Обновлено: 2026-08-07

В этой статье разобраны три частых затруднения: генерация не запускается, правки не сохраняются, файл не загружается на холст. По каждому даны первые проверки и ссылка на подробный разбор. Начните с общих шагов ниже — они снимают большую часть затруднений.

## С чего начать при любой проблеме

Три проверки помогают в большинстве случаев, какой бы ни была ситуация.

- Обновите страницу. Строфи заново установит связь с сервером и подтянет актуальное состояние проекта — это снимает последствия оборванного соединения.
- Проверьте соединение с интернетом. Сохранение правок и запуск генерации идут через сервер; при обрыве соединения они не проходят.
- Проверьте баланс кредитов. Генерация резервирует кредиты ещё до старта и при нехватке не запускается.

## Не генерируется

Если после запуска генерации ничего не происходит или задача не доходит до результата, проверьте по порядку.

- Подключены обязательные входы, и в них есть содержимое. Многим моделям нужен текст запроса или исходное изображение; если обязательный вход не подключён или подключённый блок пуст, Строфи подсвечивает точку соединения и просит подключить недостающее.
- На балансе хватает кредитов. Строфи резервирует их до старта и показывает, сколько доступно и сколько нужно.
- Задача не стоит в очереди. Очередь генераций общая для всех, и в загруженные моменты блок какое-то время ждёт своей очереди, а не сбоит.

Как устроена очередь и когда задачу можно отменить — [Очередь, ожидание и отмена генерации](https://strophe.app/docs/product/generation/queue-and-status). Если Строфи показал уведомление с текстом ошибки, что оно означает — [Почему генерация не удалась](https://strophe.app/docs/product/generation/errors).

## Изменения не сохраняются

В Строфи нет кнопки «Сохранить»: правки уходят на сервер сами. Если кажется, что изменения пропадают, проверьте.

- Индикатор синхронизации рядом с названием проекта. Пока он виден, отправка ещё идёт — дайте ей закончиться, прежде чем закрывать вкладку.
- Уведомление «Изменения не сохранились». Оно появляется, когда Строфи исчерпал попытки отправки: часть правок потеряна. Перезагрузите страницу, посмотрите, что сохранилось на самом деле, и повторите недостающие действия.
- Соединение с интернетом. При обрыве неотправленные правки копятся в памяти вкладки и пропадут, если закрыть или перезагрузить её до восстановления соединения.
- Одновременную работу в нескольких вкладках. Правки из одной вкладки не появляются в другой без перезагрузки, а при параллельном изменении одного блока сохраняется то, что дошло до сервера последним.

Как работает сохранение и когда правки теряются — [Автосохранение и синхронизация](https://strophe.app/docs/product/projects/autosave-and-sync).

## Файл не загружается

Если файл не превращается в блок на холсте, дело чаще всего в формате, размере или пропорциях.

- Формат. Строфи принимает распространённые форматы изображений и видео, а 3D-модели — в GLB; файл другого типа отклоняется, и блок не создаётся.
- Размер. Предел — 25 МБ на файл, одинаково для всех типов и всех способов загрузки.
- Пропорции изображения. Соотношение длинной стороны к короткой не должно превышать 10 к 1: узкие кадры не принимает большинство моделей, поэтому Строфи отклоняет их сразу.

При перетаскивании и выборе через кнопку загрузки Строфи показывает причину отказа.

Полный список форматов и пределов — [Загрузка файлов на холст](https://strophe.app/docs/product/files/uploading).

---

# Холст и блоки

Раздел справки Строфи целиком, статьи в порядке чтения. Источник: https://strophe.app/docs/product/canvas

# Какие бывают блоки

> Обзор типов блоков в проекте Строфи — содержимое, генерация, вспомогательные блоки и группа — и как каждый из них добавить на холст.

Источник: https://strophe.app/docs/product/canvas/block-types
Обновлено: 2026-08-19

Проект в Строфи собирают из блоков на холсте: одни хранят содержимое — текст, изображение, видео, звук, 3D-модель, другие генерируют это содержимое, третьи помогают его обработать. Понимание, какой блок за что отвечает, помогает собрать цепочку из блоков и сразу находить на холсте нужную функцию.

## Какие блоки хранят содержимое

Текстовый блок и стикер оба хранят текст, но нужны для разного: текстовый блок участвует в генерации — из него берут промпт, в него же приходит ответ текстовой модели, — а стикер остаётся цветной заметкой на холсте и ни к чему не подключается.

Изображение и видео показывают результат генерации или загруженный файл. У обоих есть кнопка Сгенерировать, которая открывает панель выбора модели прямо для этого блока, и кнопка скачивания, когда результат готов. Блок хранит не только последний результат: все успешные запуски остаются в его истории, между ними переключаются, а любой вариант можно вынести отдельным блоком — об этом статья [Результаты и история генераций](https://strophe.app/docs/product/generation/generation-history).

3D-блок показывает загруженную или сгенерированную модель: можно вращать камеру, приближать и менять фокусное расстояние. Модели на него приходят из соответствующих блоков генерации или через прямую загрузку файла.

Аудио — блок для звукового файла: воспроизводит то, что загрузили или получили от блока генерации. Звук в Строфи генерируется наравне с остальным содержимым — аудио-модели собраны в каталоге в разделе «Аудио».

## Что делает блок генерации

Блок генерации — это блок с выбором модели и её параметров: соотношение сторон, длительность, стиль и другие настройки конкретной модели. Внутри блока есть круглая кнопка Запустить и точка выхода для результата.

Если блок генерации ни к чему не подключён, результат появляется в новом контентном блоке рядом с ним. Если его выход соединён с блоком изображения, видео, 3D-модели или текста — результат приходит именно туда.

## Какие блоки помогают обработать содержимое

Эти блоки ничего не генерируют — они берут готовое содержимое с холста и отдают результат обработки. В каталоге они собраны в разделе «Утилиты»:

- Сравнение — накладывает два изображения друг на друга с подвижной границей между ними, чтобы наглядно сопоставить результаты;
- Обрезка — принимает одно изображение и обрезает его по выделенной области;
- Объединение текста — собирает содержимое нескольких текстовых блоков в один, задавая порядок и способ соединения.

## Что такое группа

Группа — визуальный контейнер: в неё помещают несколько блоков, чтобы двигать, изменять размер и запускать их вместе.

Как собрать группу, по какому правилу блок в неё попадает и как запустить генерацию сразу для всей цепочки — в статье [Группы блоков](https://strophe.app/docs/product/canvas/groups).

## Как добавить блок на холст

Способов несколько: кнопки на верхней панели инструментов и клавиши-подсказки за ними, каталог блоков по `Cmd/Ctrl + K`, правый клик по пустому месту холста, перетаскивание файла с компьютера и отпускание соединения в пустом месте. Каждый добавляет блок в своё место — в центр экрана, под курсор или в точку клика.

Подробный разбор всех способов — в статье [Как добавить блок на холст](https://strophe.app/docs/product/canvas/creating-blocks).

---

# Как добавить блок на холст

> Все способы создать блок — панель инструментов, каталог, клавиша-подсказка, правый клик, отпускание соединения — и куда каждый из них добавляет новый блок.

Источник: https://strophe.app/docs/product/canvas/creating-blocks
Обновлено: 2026-08-07

Одну и ту же операцию — создать блок на холсте — можно выполнить несколькими способами, и каждый добавляет блок в своё место: в центр экрана, точно под курсор или туда, где вы кликнули. Если блок появляется не там, где вы ожидали, дело обычно в том, каким способом вы его создали.

## Кнопки на верхней панели инструментов

На панели инструментов есть отдельная кнопка для каждого контентного блока: Текст, Изображение, Видео, Аудио, 3D и Стикер.

Клик по кнопке добавляет новый блок в центр видимой области холста. Если вместо клика зажать кнопку мыши на иконке и потянуть, блок появляется прямо под курсором и добавляется туда, где вы отпустите мышь.

Рядом — кнопка Загрузить файл: она открывает системный диалог выбора файла и создаёт блок, соответствующий типу выбранного файла. Про форматы, ограничения по размеру и другие способы загрузки файла — в статье [Загрузка файлов на холст](https://strophe.app/docs/product/files/uploading).

## Клавиша-буква и предпросмотр под курсором

У каждого типа блока с панели инструментов есть своя клавиша:

- `T` — текст
- `I` — изображение
- `V` — видео
- `A` — аудио
- `D` — 3D-модель
- `S` — стикер

Клавиша работает иначе, чем клик по кнопке: она не добавляет блок в центр экрана, а создаёт его предпросмотр, который двигается вслед за курсором. Чтобы добавить блок, кликните в нужном месте холста — предпросмотр превратится в обычный блок именно там. `Esc` или повторное нажатие той же клавиши отменяет предпросмотр без создания блока. Если во время предпросмотра нажать другую клавишу из этого списка, тип предпросмотра переключится на новый — без подтверждения прежнего.

## Каталог блоков

Каталог открывается кнопкой Все блоки на панели инструментов или сочетанием `Cmd/Ctrl + K`.

В категориях «Изображения», «Видео», «Аудио», «3D» и «Текст» перечислены конкретные модели генерации, из которых можно сразу выбрать нужную. В категории «Утилиты» — вспомогательные блоки сравнения, обрезки и объединения текста, а также модели, которые дорабатывают уже готовый результат: удаление фона, увеличение разрешения изображения или видео, векторизация. Отдельно — список «Избранное»: в него попадают любые элементы каталога, отмеченные кнопкой В избранное.

В каталоге есть поиск по названию и описанию, а результаты можно отсортировать по популярности, по названию или сначала показать новые.

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

## Другие способы

Контентный блок добавляет и правый клик по пустому месту холста: пункт «Добавить» открывает список типов блоков.

Если потянуть соединение от блока генерации и отпустить его в пустом месте холста, а не на другом блоке, Строфи создаёт подходящий контентный блок сам и сразу подключает его. Подробно — в статье [Соединения между блоками](https://strophe.app/docs/product/canvas/connections).

Ещё один способ — перетащить файл с компьютера прямо на пустое место холста: Строфи определяет тип файла и создаёт блок сам, без диалога выбора. Подробности — в той же статье [Загрузка файлов на холст](https://strophe.app/docs/product/files/uploading).

Наконец, блок появляется при вставке из буфера обмена сочетанием `Cmd/Ctrl + V`: скопированное изображение превращается в блок изображения, а скопированные ранее блоки Строфи — в их копии. Об этом — в статье [Копирование и вставка блоков](https://strophe.app/docs/product/canvas/copy-paste).

---

# Соединения между блоками

> Как соединять блоки на холсте, что подать на вход блока генерации и что происходит, когда соединение отпускают в пустом месте.

Источник: https://strophe.app/docs/product/canvas/connections
Обновлено: 2026-08-19

Соединение указывает, из какого блока берутся данные и в какой блок передаётся результат — из этого складывается цепочка генерации на холсте.

## Как соединить два блока

Чтобы создать соединение, потяните за точку соединения одного блока и отпустите на любой области другого блока.

У контентных блоков — изображения, видео, текста, 3D-модели — принять соединение можно в любом месте блока, не только на отдельной точке. Начать новое соединение от такого блока можно с любой из четырёх его сторон — сверху, снизу, слева или справа.

У блока генерации и у вспомогательных блоков каждый вход — отдельная точка слева, а результат выходит из точки справа.

Соединение двух контентных блоков само по себе генерацию не запускает, но подключённое к блоку идёт в его генерацию: текст соседнего блока подставляется промптом, изображения — исходными файлами.

## Что можно подать на вход блока генерации

Набор входов у блока генерации зависит от выбранной модели, и у каждого входа свой предел подключений — что бывает на входах и сколько файлов они принимают, разобрано в статье [Что подавать на вход генерации](https://strophe.app/docs/product/generation/inputs-and-references).

С точки выхода соединение можно провести сразу к нескольким контентным блокам — предела здесь нет. Каждое такое соединение означает отдельную генерацию со своим списанием кредитов, а не копию одного результата: подробнее в статье [Как работает генерация](https://strophe.app/docs/product/generation/how-it-works).

## Что происходит, если отпустить соединение в пустом месте холста

Если потянуть соединение от блока и отпустить не на другом блоке, а в пустом месте холста, произойдёт разное — в зависимости от того, от какого блока вы тянули.

От блока генерации создаётся контентный блок нужного типа — изображение, видео, текст, звук или 3D-модель, — и он сразу соединяется с выходом.

От уже готового изображения или 3D-модели вместо нового блока открывается меню быстрых действий с операциями под этот тип содержимого — что в нём есть, перечислено в статье [Обработка готового содержимого](https://strophe.app/docs/product/generation/utilities).

Подробнее о самих типах блоков — в статье [Какие бывают блоки](https://strophe.app/docs/product/canvas/block-types).

---

# Текстовый блок и стикер

> Как работать с текстом на холсте — форматирование разметкой, замок от случайной правки и чем стикер отличается от текстового блока.

Источник: https://strophe.app/docs/product/canvas/text-blocks
Обновлено: 2026-08-07

Текст на холсте нужен для двух вещей: хранить промпты для генерации и оставлять заметки. Для первого служит текстовый блок — его содержимое уходит на вход генерации, а ещё он умеет генерировать текст сам, кнопкой Сгенерировать. Для второго есть стикер — цветная заметка, которая ни к чему не подключается. Набирают и форматируют текст в обоих одинаково, а различаются они тем, участвуют ли в генерации.

## Для чего нужен текстовый блок

Текстовый блок содержит текст, который можно форматировать. Чаще всего в нём хранят промпт: содержимое блока подают на вход генерации, а результат текстовой генерации получают обратно в такой же блок. Как соединять блоки и что подавать на вход, описано в статье [Соединения между блоками](https://strophe.app/docs/product/canvas/connections).

У выделенного блока сверху появляется панель с несколькими кнопками. Скопировать кладёт текст блока в буфер обмена. Заблокировать защищает текст от правки (об этом ниже). Сгенерировать — или клавиша `Enter` на выделенном блоке — открывает выбор модели и генерирует текст прямо в этот блок; как это устроено, в статье [Генерация текста](https://strophe.app/docs/product/generation/text-generation).

## Как форматировать текст

Форматирование задаётся разметкой прямо при наборе: вы печатаете служебные символы, и текст сразу превращается в оформленный.

| Наберите      | Получите                                        |
| ------------- | ----------------------------------------------- |
| `# Заголовок` | заголовок; `##` и `###` — подзаголовки помельче |
| `- пункт`     | маркированный список                            |
| `1. пункт`    | нумерованный список                             |
| `[ ] пункт`   | список с галочками                              |
| `**текст**`   | жирный                                          |
| `*текст*`     | курсив                                          |
| `~~текст~~`   | зачёркнутый                                     |
| `` `текст` `` | код внутри строки                               |
| `> текст`     | цитата                                          |
| `---`         | горизонтальная линия                            |

Кроме перечисленного блок понимает таблицы и блоки кода: тройные обратные кавычки перед фрагментом дают подсветку синтаксиса. Той же разметкой отвечают текстовые модели, поэтому результат генерации приходит в блок уже оформленным.

## Замок редактирования

Замок делает блок доступным только для чтения. Он нужен, чтобы не испортить готовый промпт или важную заметку случайным кликом.

Включается замок кнопкой на панели выделенного блока: она переключается между Заблокировать и Разблокировать. В заблокированном виде текст приглушается, а клик по блоку больше не открывает редактор — изменить содержимое нельзя, пока замок не снят.

Иногда замок появляется сам. Если на вход текстового блока подан блок «Объединение текста», блок становится зеркалом его результата: его содержимое собирается из подключённых источников, поэтому ручная правка запрещена, а кнопка замка на панели скрыта.

## Размер текстового блока

Блок подстраивается под содержимое: чем больше текста, тем он выше. Ширину и высоту можно задать вручную — потяните за уголок блока. Если после ручного изменения размер разошёлся с содержимым, двойной клик по тому же уголку подгоняет блок обратно под текст.

## Чем отличается стикер

Стикер — цветная заметка для пометок и комментариев прямо на холсте. Текст в нём форматируется той же разметкой, что и в текстовом блоке.

Цвет выбирают из палитры: она появляется на панели выделенного стикера.

Размер стикера меняется так же, как у текстового блока.

---

# Выделение и перемещение блоков

> Как выделять блоки одиночно и рамкой, перемещать и копировать их перетаскиванием, менять размер и выравнивать друг относительно друга.

Источник: https://strophe.app/docs/product/canvas/selection-and-move
Обновлено: 2026-08-07

Большую часть времени работы на холсте занимает не соединение блоков, а их расстановка: выделить нужные, подвинуть, поменять размер, выровнять друг относительно друга. Ниже — как это делать и куда смотреть, если холст ведёт себя не так, как ожидалось.

## Как выделить блоки

Клик по блоку выделяет только его, снимая прежнее выделение. Клик по пустому месту холста снимает выделение полностью.

`Shift` + клик добавляет блок к выделению или убирает из него, если блок уже был выделен.

Чтобы выделить несколько блоков рамкой, потяните за пустое место холста — рамка выделит все блоки, которых коснулась хотя бы частично. С зажатым `Shift` рамка добавляет новые блоки к уже выделенным, а не заменяет выделение.

`Esc` снимает выделение.

## Как переместить блок и скопировать его перетаскиванием

Перетащите блок за любую точку — он переместится. Если выделено несколько блоков, перетаскивание любого из них двигает всё выделение целиком.

Зажмите `Alt` до того, как начнёте тянуть блок, — вместо перемещения Строфи скопирует его. Связи между самими перетаскиваемыми блоками при этом сохраняются.

Если включена сетка, на холсте видны точки с шагом 36 пикселей, а положение блока после перемещения дополнительно подстраивается под более мелкий шаг — 12 пикселей. Если включены магнитные направляющие, при перетаскивании и изменении размера Строфи подсвечивает линию, когда край, центр или отступ блока совпадает с соседним. Обе настройки включены по умолчанию и выключаются в разделе «Основные» настроек — если ни точек, ни линий не видно, проверьте там.

## Как изменить размер блока

Наведите курсор на блок — в правом нижнем углу появится маркер изменения размера. Если у блока зафиксированы пропорции — обычно у сгенерированного изображения или видео с определённым соотношением сторон — они сохраняются автоматически при изменении размера.

Двойной клик по маркеру возвращает блоку правильные пропорции: по исходному изображению, если оно есть, или по модели, которой сгенерирован результат, — площадь блока при этом остаётся примерно той же. У группы двойной клик работает иначе: она плотно обхватывает по границам все блоки внутри себя, а не восстанавливает пропорции.

## Как выровнять и распределить блоки

Когда выделено два и более блоков, на нижней панели инструментов появляется кнопка Выравнивание. При наведении на неё раскрывается панель с шестью операциями: по левому краю, по горизонтали, по правому краю, по верхнему краю, по вертикали, по нижнему краю.

Выравнивание считается по общим границам выделения: «по левому краю» подводит блоки к крайнему левому краю выделения, «по горизонтали» и «по вертикали» ставят их по середине между крайними краями.

С трёх и более выделенных блоков в той же панели добавляются ещё два варианта — распределить равномерно по горизонтали и по вертикали. Крайние блоки остаются на месте, а расстояния между промежуточными выравниваются.

## Как отменить перемещение или удаление блоков

Перемещение, копирование, создание, удаление и группировку блоков можно откатить сочетанием `Cmd/Ctrl + Z`, а вернуть отменённое — `Shift + Cmd/Ctrl + Z`. Что именно попадает в историю, чего отмена не касается и почему запущенную генерацию вернуть нельзя — в статье [Отмена и повтор действий](https://strophe.app/docs/product/canvas/undo-redo).

---

# Группы блоков

> Как собрать блоки в группу, по какому правилу блок попадает в неё и выходит из неё и что даёт группа при работе с цепочкой.

Источник: https://strophe.app/docs/product/canvas/groups
Обновлено: 2026-08-07

Группа собирает несколько блоков в общий контейнер — например, все шаги одной сцены или черновики одного текста — и дальше вы работаете с ними как с одним объектом: двигаете, меняете размер, запускаете генерацию сразу для всех. Помогает, когда цепочка блоков разрослась и стало неудобно таскать каждый блок по отдельности.

## Как собрать группу и как её разгруппировать

Выделите два и более блоков, не входящих ни в одну группу.

Сгруппировать их можно тремя способами: сочетанием `Cmd/Ctrl + G`, кнопкой Группировать на нижней панели инструментов — она же переключается в Разгруппировать, когда выделена уже собранная группа, — или пунктом «Группировать» в меню по правому клику на выделении.

Группа охватывает выделенные блоки по их границам.

Разгруппировать группу можно сочетанием `Cmd/Ctrl + Shift + G`, той же переключающейся кнопкой на нижней панели или пунктом «Разгруппировать» в меню по правому клику на группе. Блоки при этом остаются на холсте на своих местах.

## По какому правилу блок входит в группу и выходит из неё

Состав группы меняется перемещением: перетащите блок внутрь границ группы — он станет её членом, вынесите наружу — выйдет. Блок считается внутри, когда внутри оказался его центр, а не весь блок целиком.

Группу нельзя поместить внутрь другой: вложенных групп в Строфи нет.

## Что происходит при перемещении, изменении размера и переименовании

Перетаскивание группы двигает вместе с ней все блоки внутри — на одно и то же расстояние.

Соединения от блоков внутри группы к блокам снаружи при этом не рвутся — они следуют за передвинутыми блоками.

Чтобы изменить размер группы, наведите курсор на её край или угол, зажмите левую кнопку мыши и потяните в нужную сторону.

Двойной клик по маркеру изменения размера подгоняет границы группы плотно под её текущих членов — с теми же отступами, что и при создании группы.

Название группы меняется двойным кликом по заголовку или пунктом «Переименовать» в меню по правому клику.

## Как запустить генерацию для всей группы

Если внутри группы есть хотя бы один блок генерации с уже выбранной моделью, при выделении группы над ней появляется кнопка Запустить. Тот же запуск можно вызвать клавишей `Enter`, когда группа выделена.

Блоки генерации запускаются не все разом вслепую, а по зависимостям между ними внутри группы: сначала те, что не ждут результата другого блока генерации этой же группы, затем — зависящие от них, и так далее по цепочке. Блоки одного уровня зависимостей запускаются одновременно.

На кнопке запуска показана суммарная стоимость всей цепочки — сколько кредитов уйдёт, если запустить группу целиком. Если цена части блоков заранее неизвестна — например, среди них есть [видео-модель с оплатой за секунду](https://strophe.app/docs/product/account/credits) — сумма показывается с пометкой «от»: это нижняя граница, итог будет больше.

## Что будет с блоками при удалении группы

Удаление выделенной группы стирает не только сам контейнер, но и все блоки внутри неё — вместе с соединениями, которые вели от них к блокам снаружи группы.

Если нужно оставить блоки на холсте, а убрать только группировку — разгруппируйте вместо удаления.

Копирование группы работает так же, как копирование остальных блоков, — подробно об этом в статье [Копирование и вставка блоков](https://strophe.app/docs/product/canvas/copy-paste).

---

# Навигация по холсту

> Как двигаться по холсту — перемещение вида, масштаб, «Отобразить все», миникарта и режимы управления мышью и трекпадом.

Источник: https://strophe.app/docs/product/canvas/canvas-navigation
Обновлено: 2026-08-07

Холст в Строфи бесконечный, и проект на нём может уйти далеко за пределы отображаемой области. Чтобы не терять блоки из виду и быстро возвращаться к нужному участку, есть несколько способов перемещаться по холсту и менять масштаб. Ниже — что и чем управляется, включая разницу между мышью и трекпадом.

## Как перемещаться по холсту

В обычном режиме курсора вид двигается перетаскиванием средней кнопки мыши — нажатием на колёсико.

Инструмент Перемещение — отдельный режим руки: включите его кнопкой на панели внизу или клавишей `H`. При включённом режиме перемещение по холсту выполняется зажатием левой кнопки мыши и движением в нужную сторону. Пока рука активна, блоки не перетаскиваются.

Тот же режим можно включить на секунду, не сбрасывая выделение: удерживайте `Space`. Пока клавиша зажата, курсор превращается в руку и перетаскивание левой кнопкой двигает вид; отпустили клавишу — вернулись к прежнему инструменту. Клавиша `Esc` возвращает обычный курсор и снимает выделение.

Если в настройках выбран трекпад, перемещаться по холсту можно и прокруткой двумя пальцами в любую сторону.

Перетаскивание самих блоков и выделение рамкой описаны отдельно — [Выделение и перемещение блоков](https://strophe.app/docs/product/canvas/selection-and-move).

## Как менять масштаб

Масштаб приближает и отдаляет вид. Прокрутка с зажатой `Cmd/Ctrl` меняет масштаб в любом режиме управления, и то же делает щипок на трекпаде. Если в настройках выбрана мышь, масштаб меняет и обычная прокрутка колеса без модификатора.

Клавиши `+` и `-` приближают и отдаляют вид вдвое за нажатие, удерживая центр экрана. То же делают кнопки в правом нижнем углу.

`Cmd/Ctrl + 0` возвращает стопроцентный масштаб.

Масштаб ограничен диапазоном от 5% до 400% — дальше приблизить или отдалить нельзя. Текущее значение показано числом в процентах в правом нижнем углу.

## Как показать все блоки сразу

Клавиша `Shift + 1` вписывает все блоки проекта в видимую область целиком. То же делает пункт «Отобразить все» в меню, которое открывается кликом по числу масштаба.

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

## Что такое миникарта

Миникарта — уменьшённая схема всего проекта в правом нижнем углу. На ней видно, где вы сейчас находитесь относительно остальных блоков.

Миникарта интерактивна: перетаскивание по ней перемещает вид к нужному участку, а прокрутка колесом мыши над ней меняет масштаб.

Показ миникарты включает и выключает переключатель «Миникарта» в настройках; по умолчанию она включена.

## Мышь или трекпад: какой режим выбрать

В настройках, пункт «Управление», выбирается режим под то, чем вы работаете: мышь или трекпад. По умолчанию стоит трекпад. От выбора зависит обычная прокрутка без модификаторов: у мыши она меняет масштаб, у трекпада двигает вид.

---

# Копирование и вставка блоков

> Как скопировать и продублировать блоки, что Строфи распознаёт при вставке извне и что получится, если вставить блок в другую программу.

Источник: https://strophe.app/docs/product/canvas/copy-paste
Обновлено: 2026-08-07

Собирать цепочку заново не нужно, если нужный набор блоков уже есть в другом проекте. Копирование переносит блоки вместе с их содержимым и настройками — внутри одного проекта, между проектами и между вкладками браузера это работает одинаково.

## Как скопировать и вставить блок внутри проекта

`Cmd/Ctrl + C` копирует выделенные блоки, `Cmd/Ctrl + V` вставляет их копию в видимую область холста. Вставить блок точно в нужном месте можно через правый клик по пустому месту холста — пункт «Вставить» добавляет копию туда, где вы кликнули.

## Как продублировать блок

Сочетание `Cmd/Ctrl + D` (или пункт «Дублировать» в контекстном меню) создаёт копию выделенных блоков. Копия появляется на ближайшем свободном месте справа от оригинала.

Ещё один способ — перемещение с зажатой клавишей `Alt`. Оригинал остаётся на месте со всеми своими соединениями, а перемещаемый блок становится самостоятельной копией. `Alt` нужно зажать до начала перемещения. Подробно про перемещение и работу с выделением — в статье [Выделение и перемещение блоков](https://strophe.app/docs/product/canvas/selection-and-move).

## Что Строфи распознаёт при вставке извне

Если в буфере обмена есть изображение — скриншот или файл, скопированный из другого приложения, — вставка на холст создаёт из неё новый блок изображения. То же происходит, если изображение вставляется не отдельным файлом, а частью форматированного содержимого — например, при вставке из Google Docs.

Обычный текст или ссылка, вставленные на пустое место холста (когда ничего не выделено и не открыто на редактирование), не создают блок — Строфи их не распознаёт. Чтобы вставить текст, откройте на редактирование уже существующий текстовый блок и вставляйте прямо в него.

## Что получится, если вставить блок Строфи в другую программу

Сторонние программы по-разному принимают вставляемое содержимое, поэтому ниже — то, что фактически попадает в буфер обмена, а не гарантия результата в конкретном приложении.

Вместе с блоками всегда копируется форматированное содержимое: текст текстовых блоков и содержимое блоков изображения (как встроенные изображения). Это то, что обычно распознают Word, Google Docs и подобные редакторы при вставке. Если среди скопированных блоков есть текстовый блок с текстом, дополнительно копируется его текст без форматирования — на случай, если принимающая программа форматирование не поддерживает.

Если вы копируете ровно один блок изображения, в буфер обмена дополнительно попадает само изображение отдельным файлом — это нужно программам вроде Figma, которые ожидают именно изображение, а не размеченный текст. Здесь многое зависит от браузера: Firefox изображение таким способом в буфер не кладёт, и при копировании из него доедет только форматированное содержимое.

У стикеров, видео, 3D-блоков, блоков генерации и групп нет представления для внешних программ: при вставке в другое приложение от них ничего не появится.

---

# Отмена и повтор действий

> Отмена (Cmd/Ctrl + Z) и повтор (Shift + Cmd/Ctrl + Z) откатывают правки на холсте — но запущенную генерацию отмена действия не останавливает.

Источник: https://strophe.app/docs/product/canvas/undo-redo
Обновлено: 2026-08-19

Почти любое действие на холсте — перемещение, удаление, группировку — можно откатить одним сочетанием клавиш: на один шаг или на несколько подряд. Отменённое при этом возвращается обратным сочетанием, поэтому варианты компоновки можно пробовать, не боясь испортить проект.

Но у отмены есть граница. Она возвращает правки расположения и содержимого, а не отменяет то, что уже ушло на сервер. Разберём, что именно откатывается, а что остаётся.

## Как отменить и повторить действие

Отмена последнего действия — `Cmd/Ctrl + Z`. Повтор отменённого действия — `Shift + Cmd/Ctrl + Z`.

Те же две команды продублированы кнопками со стрелками на нижней панели холста. Когда отменять или повторять нечего, кнопки неактивны.

После отмены вы можете вернуть шаг назад повтором. Но если сразу после отмены сделать любое новое действие, цепочка повторов очищается — вернуться к отменённому состоянию этим путём уже не выйдет.

## Что возвращает отмена

В историю попадают правки самого холста:

- создание и удаление блоков;
- перемещение блоков и целых групп;
- изменение размера блока и группы;
- объединение блоков в группу и разгруппировку;
- вставку и дублирование;
- смену модели генерации у блока;
- правку текста в текстовом блоке и на стикере.

Удаление тоже откатывается. Если вы убрали блок вместе с его соединениями, отмена вернёт и блок, и связи, которые тянулись к нему.

Пока вы печатаете внутри текстового блока, `Cmd/Ctrl + Z` отменяет набранный текст, а не действия на холсте.

## Что происходит, когда отменяешь блок с генерацией

Когда генерация автоматически создаёт блок с результатом, само создание этого блока попадает в историю. Отмена уберёт такой блок с холста.

Но она не отменяет саму генерацию: работа продолжается на сервере независимо от того, виден блок на холсте или нет. Отмена меняет только вид проекта.

Чтобы остановить саму задачу, её отменяют в списке задач по счётчику кредитов — как это устроено и что при этом происходит с кредитами, в статье [Очередь, ожидание и отмена генерации](https://strophe.app/docs/product/generation/queue-and-status).

## Сколько шагов помнит история и когда она сбрасывается

История хранит до 100 последних действий. Когда их становится больше, самые старые вытесняются, и до них отмена уже не дойдёт.

История живёт в рамках текущего сеанса редактирования в браузере. Когда вы переоткрываете проект или перезагружаете вкладку, отмена и повтор начинаются с чистого листа — действия из прошлого сеанса вернуть не выйдет.

Сама отмена или повтор — это тоже правка проекта. Она сохраняется и расходится по вашим открытым вкладкам так же, как любое другое изменение, — подробнее в статье [Автосохранение и синхронизация](https://strophe.app/docs/product/projects/autosave-and-sync).

---

# Просмотр 3D-модели

> Как осмотреть 3D-модель прямо в блоке — повернуть, приблизить и сдвинуть камеру, встать на нужную грань через виджет ориентации и сбросить ракурс.

Источник: https://strophe.app/docs/product/canvas/3d-viewer
Обновлено: 2026-08-19

Блок с моделью позволяет покрутить её со всех сторон прямо на холсте, не открывая отдельных окон. Так вы проверяете результат генерации перед тем, как вести цепочку дальше, и заодно выставляете тот ракурс, с которого потом снимете изображение.

Все жесты осмотра работают с зажатой `Alt`. Без неё те же движения мыши и колесо управляют холстом, а не моделью.

## Как двигать камеру

| Что нужно  | Как сделать                                                       |
| ---------- | ----------------------------------------------------------------- |
| Повернуть  | `Alt` + перетаскивание — камера облетает объект по кругу          |
| Приблизить | `Alt` + колесо мыши — камера придвигается к модели или отходит    |
| Сдвинуть   | `Shift` + `Alt` + перетаскивание — модель едет в плоскости экрана |

Средняя кнопка мыши делает то же самое без `Alt`: перетаскивание с зажатым колёсиком вращает камеру, а вместе с `Shift` — сдвигает.

Сдвиг выручает, когда нужная деталь ушла за край блока: двигается вид внутри блока, сам холст при этом стоит на месте.

## Что делает виджет ориентации

При наведении на блок в правом верхнем углу появляется небольшой кубик — виджет ориентации, как в инженерных редакторах. Он показывает, какой стороной модель повёрнута к вам.

Щёлкните по грани кубика — камера плавно встаёт на соответствующий вид: спереди, сзади, слева, справа, сверху или снизу. Щелчок по ребру или углу кубика даёт промежуточный ракурс между двумя-тремя гранями, включая изометрию с угла. Кубик можно и вращать перетаскиванием — модель поворачивается вслед за ним.

## Зачем менять фокусное расстояние

В правом нижнем углу блока есть регулятор фокусного расстояния — он показывает значение в миллиметрах, как объектив фотоаппарата. Тяните его вбок, чтобы сменить «объектив».

Он не приближает объект: размер модели в кадре сохраняется, меняется перспектива. Малое фокусное расстояние даёт широкоугольный, слегка «выпуклый» вид с подчёркнутой глубиной; большое — плоский, сжатый вид, как у телеобъектива. Этим вы подбираете, каким читается объём модели.

## Как сбросить камеру и сохраняется ли ракурс

Как только вы сдвинули камеру, при наведении на блок в левом нижнем углу появляется кнопка сброса. Она возвращает исходный вид, который Строфи подобрал автоматически при загрузке: ракурс, удаление, сдвиг и фокусное расстояние. Пока камеру не трогали, кнопки нет.

Выставленный ракурс привязан к блоку и восстанавливается, когда вы возвращаетесь к проекту позже. Снимок текущего вида модели берётся ровно с того ракурса, что вы выставили, — как получить из него обычное изображение, описывает [Обработка готового содержимого](https://strophe.app/docs/product/generation/utilities).

## Можно ли открыть в блоке свою модель

Да. Перетащите файл модели в формате GLB прямо на блок — он заменит содержимое, и осматривать его можно теми же жестами, что и сгенерированную модель. Файл другого формата модель не заменит, а создаст рядом новый блок под свой тип.

Как модель генерируется из изображения и что при этом настраивается — тема статьи [Генерация 3D-моделей](https://strophe.app/docs/product/generation/3d-specifics).

---

# Генерация

Раздел справки Строфи целиком, статьи в порядке чтения. Источник: https://strophe.app/docs/product/generation

# Как работает генерация

> Из чего состоит блок генерации, откуда он берёт промпт, какие параметры меняются и куда попадает готовый результат.

Источник: https://strophe.app/docs/product/generation/how-it-works
Обновлено: 2026-08-19

Блок генерации — элемент холста, в котором промпт и параметры превращаются в изображение, видео, звук, 3D-модель или текст. Он одинаково устроен для любой модели каталога, поэтому разобраться в нём один раз достаточно для работы со всеми моделями.

## Из чего состоит блок генерации

Сверху блока — название модели. Ниже — точки входа: Промпт и точки для файлов, которые принимает выбранная модель — Изображение, Видео, Первый кадр, Последний кадр, Аудио, 3D-модель.

Дальше идут параметры: часть видна сразу, часть скрыта под кнопкой «Дополнительные опции». Внизу — стоимость запуска, круглая кнопка Запустить и справа от неё точка выхода, через которую блок соединяется с блоком результата.

## Откуда берётся промпт

Промпт не печатается прямо в блоке генерации — поле для текста в нём не предусмотрено. Текст берётся из отдельного текстового блока, подключённого к точке входа Промпт. В момент запуска Строфи читает содержимое этого блока и использует его как промпт.

Промпт нужен не всякой модели: часть работает от одного изображения. Какие входы обязательны для выбранной модели, подсказывает сам блок — при попытке запуска он назовёт недостающие подключения.

Промпт уходит в модель ровно в том виде, в каком вы его написали. Как составить его так, чтобы модель поняла задачу, — в разделе [Промптинг](https://strophe.app/docs/product/prompting/how-to-write).

## Что меняет число подключённых файлов

Набор подключённых файлов меняет то, что модель сделает с ними и с промптом. Разбор по каждому случаю — в статье [Что подавать на вход генерации](https://strophe.app/docs/product/generation/inputs-and-references).

## Какие параметры можно менять

Параметры модели разделены на основные и дополнительные. Основные показаны прямо в блоке — это то, что обычно меняют: соотношение сторон, длительность, стиль. Дополнительные скрыты под кнопкой «Дополнительные опции» и раскрываются по клику.

Полный разбор параметров — в статье [Параметры генерации](https://strophe.app/docs/product/generation/parameters).

## Куда приходит результат генерации

Если блок генерации соединён точкой выхода с одним блоком, результат приходит в него. Если соединений нет, при запуске Строфи создаёт новый блок справа от блока генерации и сразу подключает его — искать место на холсте вручную не нужно.

Несколько блоков на выходе означают не копию одного результата, а несколько генераций: Строфи запускает по одной на каждый подключённый блок, и в каждый приходит свой результат. Кредиты списываются за каждую генерацию отдельно — блок с тремя блоками на выходе обойдётся втрое дороже.

## Что видно до запуска

Стоимость запуска в кредитах показана рядом с кнопкой ещё до нажатия и пересчитывается при смене параметров или модели. Что входит в эту сумму и почему у части моделей её не видно заранее — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

В шапке блока, рядом с названием модели, стоят её значки — те же, что в [каталоге](https://strophe.app/docs/product/generation/model-catalog). На запуск влияют два: у модели Только по подписке кнопка нажимается, но вместо генерации откроется окно оформления подписки, а у Временно недоступна она неактивна.

Запустить генерацию можно круглой кнопкой Запустить на блоке или клавишей `Enter`, если блок выделен на холсте.

## Панель генерации у контентного блока

У блоков изображения, видео и текста нет собственных настроек модели — их показывает панель у нижнего края холста. Она открывается кнопкой Сгенерировать на блоке, тем же пунктом контекстного меню или клавишей `Enter`, если такой блок выделен на холсте один.

В панели, в отличие от блока генерации, есть собственное поле для промпта: она пригодится, когда результат уже на холсте и нужно быстро сгенерировать вариант прямо в нём, не собирая цепочку из текстового блока и блока генерации. Результат запуска из панели приходит в тот же блок.

---

# Каталог моделей

> Где смотреть список моделей, чем каталог блоков отличается от окна выбора модели и что означают значки рядом с названием.

Источник: https://strophe.app/docs/product/generation/model-catalog
Обновлено: 2026-08-19

Модели для генерации собраны в общий каталог. Ниже — где его открыть, почему список в разных окнах отличается и что означают отметки рядом с названием модели.

## Как устроен каталог

Модели сгруппированы по тому, что они создают: текст, изображение, видео, звук и 3D-модель.

Отдельная группа — утилиты: они дорабатывают уже готовое содержимое, а не создают новое. Подробнее о них — в статье [Обработка готового содержимого](https://strophe.app/docs/product/generation/utilities).

В группе звука модели двух видов: одни пишут музыку, другие собирают звуковую сцену целиком — речь, шумы и эффекты. Отдельно от этого часть видео-моделей умеет добавлять звуковую дорожку к ролику, для этого у них есть свой параметр.

## Где виден список моделей и почему он может отличаться

Полный список — в каталоге блоков: кнопка Все блоки или `Cmd/Ctrl + K`. Как он устроен и что там ещё лежит кроме моделей — в статье [Как добавить блок на холст](https://strophe.app/docs/product/canvas/creating-blocks).

Короче список в окне выбора модели, которое открывается кнопкой Сгенерировать на контентном блоке. Модели, которым нужен особый набор входов, туда не попадают:

- Kling Motion Control — переносит движение с видео на изображение;
- модели с припиской Reference — Seedance 2.5 Reference, Veo 3.1 Reference, WAN 3.0 Reference и другие: они собирают видео сразу по нескольким изображениям-референсам.

Такую модель добавляют на холст отдельным блоком через каталог.

## Что видно о модели до того, как её выбрать

Рядом с названием показаны ориентировочное время генерации и минимальная стоимость запуска; точная стоимость зависит от выбранных параметров, подробнее — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits). Значками отмечено, какие входы модель принимает: промпт, изображение, видео, звук, 3D-модель.

Отдельные значки говорят о доступе и состоянии модели:

- Только по подписке — добавить или выбрать модель нельзя, вместо этого Строфи предложит оформить подписку;
- Временно недоступна — модель отключена и на холст не добавляется;
- Временно работает нестабильно — выбрать и запустить можно, но модель чаще обычного отвечает ошибкой;
- «Новинка» — модель появилась в каталоге недавно;
- «−20%» и подобное — временно пониженная стоимость запуска.

Доступность проверяется дважды: при добавлении модели на холст и отдельно при каждом запуске. Поэтому блок, добавленный когда подписка была активна, после её окончания останется на холсте, но перестанет запускаться — то же произойдёт, если модель тем временем отключили.

---

# Что подавать на вход генерации

> Какие входы бывают у блока генерации, сколько файлов принимает каждый, как задать первый и последний кадр видео и что происходит при нескольких текстовых блоках.

Источник: https://strophe.app/docs/product/generation/inputs-and-references
Обновлено: 2026-08-19

От того, что подключено к блоку генерации, зависит результат: один и тот же блок с одной моделью сгенерирует изображение по описанию, доработает подключённое изображение или соберёт результат сразу из нескольких. Достаточно подключить нужное — переключать для этого нечего.

## Какие входы бывают у блока генерации

Кроме Промпта, блок генерации умеет принимать изображение, несколько изображений, первый и последний кадр видео, видео как источник движения, несколько видео, 3D-модель, аудио как образец голоса и текст как содержимое для обработки — отдельно от промпта.

Какие именно точки входа появятся на блоке, решает выбранная модель.

## Сколько файлов принимает вход

Предел подключений написан у самой точки входа: счётчик показывает, сколько блоков подключено из скольких возможных. Если подключить файл сверх предела, соединение не создастся — Строфи покажет сообщение с текущим лимитом. Лишний файл не встаёт в очередь и не заменяет уже подключённый: сначала нужно отключить один из существующих.

Как ссылаться в промпте на несколько подключённых записей звука, разобрано в статье [Промпт для аудио](https://strophe.app/docs/product/prompting/audio).

## Как задать первый и последний кадр видео

Роль изображения определяет точка, к которой вы подвели соединение, а не порядок подключения. Изображение на входе Первый кадр станет началом ролика, изображение на входе Последний кадр — его концом.

Первый кадр обязателен, последний — нет: видео можно сгенерировать и от одного начального изображения.

## Как объединяются несколько подключённых текстовых блоков

Если к одному входу подключено несколько текстовых блоков, их содержимое склеивается в единый текст, а не выбирается по одному. Части разделяются пустой строкой, а порядок берётся по положению блоков на холсте — сверху вниз, независимо от того, какой из них вы подключили первым.

Если нужен другой разделитель или порядок, соберите текст блоком «Объединение текста» и подключите к генерации уже его.

## Из чего ещё складывается результат

Генерация 3D устроена иначе: изображение ей нужно всегда, сгенерировать модель по одному описанию нельзя — подробнее в статье [Генерация 3D-моделей](https://strophe.app/docs/product/generation/3d-specifics).

О том, как ведут себя соединения при смене модели, — в статье [Соединения между блоками](https://strophe.app/docs/product/canvas/connections).

---

# Параметры генерации

> Где меняются настройки модели, что задают соотношение сторон, разрешение, длительность и звук, и что происходит с параметрами при смене модели.

Источник: https://strophe.app/docs/product/generation/parameters
Обновлено: 2026-08-19

Набор параметров задаёт сама модель: Строфи показывает то, что модель умеет принимать, и ничего не добавляет от себя.

## Где менять параметры

Все параметры выбранной модели есть на блоке генерации. Основные показаны сразу, остальные скрыты под кнопкой «Дополнительные опции».

Панель генерации внизу холста показывает только списки выбора — соотношение сторон, разрешение, длительность, стиль. Числа, тумблеры и «Версия» меняются на самом блоке.

## Соотношение сторон

Список значений задаёт модель. У части видео-моделей есть значение «Авто»: модель сама определяет кадр, вместо того чтобы подгонять его под фиксированную пропорцию.

Если к генерации подключено исходное изображение, у части моделей параметр пропадает из настроек — такая модель берёт пропорции из исходника.

Пустой блок результата на выходе повторяет выбранное соотношение сторон и меняет форму вслед за параметром. Как только в блоке появляется готовый результат, форма берётся из самого файла.

## Разрешение, длительность и звук

Разрешение выбирается из списка: у изображений это ступени качества, у видео — значения от 480p до 4K. У моделей с фиксированным разрешением параметра нет.

Длительность видео выбирается из списка значений в секундах, произвольное число ввести нельзя.

Звук у видео-моделей включается тумблером «Аудио». Тумблер «Мульти-клип» собирает ролик из нескольких сцен вместо одного непрерывного плана.

## Стили и пресеты

У части моделей для изображений есть параметр «Стиль». Он открывается подборщиком, где стили сгруппированы по категориям. Там же можно создать свой стиль на основе собственных изображений и дальше выбирать его наравне со встроенными.

## Как параметры зависят друг от друга

Значения не всегда независимы: у части видео-моделей выбор более высокого разрешения убирает из списка самые долгие варианты длительности — такого сочетания модель не поддерживает.

## Что происходит при смене модели

Выбор другой модели сбрасывает параметры к значениям новой модели по умолчанию. Форма блока результата сохраняется, если она допустима для новой модели.

Переключение «Версии» внутри одной модели значения не сбрасывает, но набор параметров у версий разный — часть настроек после переключения появится или исчезнет.

---

# Результаты и история генераций

> Как Строфи хранит все результаты запуска блока, как переключаться между вариантами и выносить их на холст, и где смотреть подробности каждой генерации.

Источник: https://strophe.app/docs/product/generation/generation-history
Обновлено: 2026-08-19

Один блок редко ограничивается одним запуском: вы меняете промпт, пробуете другую модель или хотите ещё один вариант. Ниже — что происходит с прежними результатами, как получить несколько вариантов сразу и где смотреть сведения о конкретной генерации.

## Что сохраняется, когда вы запускаете блок повторно

Каждый повторный запуск добавляет новый результат к блоку, а не заменяет предыдущий — и с блока генерации, и из [панели генерации](https://strophe.app/docs/product/generation/how-it-works). Когда результатов больше одного, под блоком появляются их превью — история этого блока.

Клик по превью показывает этот результат на блоке. Он же останется на блоке при следующем открытии проекта, а пропорции блока подстроятся под выбранный результат.

История сохраняется у блоков изображения и видео.

## Как вынести вариант из истории отдельным блоком

Любой готовый результат из истории можно перетащить на свободное место холста — зажмите превью и отпустите за пределами панели. Строфи создаст для него отдельный блок.

## Как получить несколько вариантов одного промпта

Запустить блок нужное число раз: каждый запуск добавит свой результат в историю, и варианты можно будет сравнить.

Либо подключить к выходу блока генерации сразу несколько контентных блоков: один запуск выполнит столько генераций, сколько блоков подключено, и в каждый придёт свой вариант. Кредиты спишутся за каждую — подробнее в статье [Как работает генерация](https://strophe.app/docs/product/generation/how-it-works).

## Подробности о конкретном результате

У блока изображения или видео с результатом модели есть кнопка Инфо, тот же пункт есть в контекстном меню. Он показывает модель, размеры результата и пропорции, для видео — длительность, время самой генерации и промпт: по клику промпт копируется в буфер обмена.

## Список всех генераций за всё время

Полный список ваших генераций открывается пунктом «Аналитика» в меню аккаунта. Это хронологический список по всем проектам с превью, промптом, названием модели и стоимостью в кредитах — подробнее об их списании в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits). У каждой строки есть действия: скачать оригинал, скопировать промпт и «Найти в проекте» — последнее переносит прямо к этому блоку на холсте, если проект и блок ещё существуют.

Вы видите свои генерации с фильтром по проекту. Владельцу и администратору команды тот же экран показывает генерации всей команды с фильтром по участнику и отметкой, кто запустил каждую; рядовые участники видят только свои.

---

# Очередь, ожидание и отмена генерации

> Что происходит с задачей после запуска: очередь, ожидание, отмена и что при этом происходит с кредитами.

Источник: https://strophe.app/docs/product/generation/queue-and-status
Обновлено: 2026-08-19

Запуск [генерации](https://strophe.app/docs/product/generation/how-it-works) не даёт результат мгновенно — сначала Строфи резервирует кредиты и отправляет задачу в обработку. Что происходит дальше, как отменить задачу и что при этом будет с кредитами — по шагам ниже.

## Что происходит сразу после запуска генерации

Строфи резервирует нужное количество [кредитов](https://strophe.app/docs/product/account/credits) — удерживает их за этой задачей, но пока не списывает.

Дальше задача уходит в обработку: если есть свободное место, генерация стартует сразу, если мест нет — ждёт очереди, и на блоке в это время виден индикатор ожидания.

У каждого аккаунта есть предел числа одновременных генераций: даже если поставить сразу много задач, часть подождёт, пока не освободится место.

## Как отменить генерацию

Список задач открывается наведением на счётчик кредитов в шапке проекта. У каждой задачи есть кнопка «Отмена».

Что будет с кредитами, зависит от того, началась ли генерация:

- задача ещё в очереди — отмена происходит сразу, резерв возвращается на баланс;
- генерация уже идёт — Строфи предупредит, что кредиты не вернутся, и отменит после подтверждения. Запрос к этому моменту уже ушёл в сервис генерации и оплачен ему.

Удаление блока во время генерации работает так же: Строфи предупредит и отменит задачу вместе с блоком, а вернутся кредиты или нет — по тому же правилу.

## Что происходит с кредитами в конце

Кредиты списываются окончательно в момент успешного завершения. Если задача до него не дошла из-за ошибки, резерв возвращается на баланс. Почему генерация могла не удаться и что делать по каждому отказу — в статье [Почему генерация не удалась](https://strophe.app/docs/product/generation/errors).

---

# Почему генерация не удалась

> Частые причины отказа генерации — от модерации до перегрузки сервиса — и что сделать по каждой, чтобы получить результат.

Источник: https://strophe.app/docs/product/generation/errors
Обновлено: 2026-08-19

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

Как устроены очередь, ожидание и возврат кредитов — в статье [Очередь, ожидание и отмена генерации](https://strophe.app/docs/product/generation/queue-and-status). Кредиты за неудачную генерацию не списываются.

## Содержимое не прошло модерацию

Строфи и модели проверяют и запрос, и входные изображения, и готовый результат. Если что-то не проходит проверку, генерация останавливается с одним из сообщений:

- «Контент не прошёл модерацию, попробуйте другой промпт или изображение» — общий отказ модерации.
- «Изображение содержит лицо реального человека — модель не принимает такой ввод» — на входном изображении распознано лицо конкретного человека.
- «Изображение содержит запрещённый контент — попробуйте другое» — входное изображение отклонено как чувствительное.
- «Результат не прошёл модерацию, попробуйте другой промпт» — проверку не прошёл уже сгенерированный кадр.

Это отказ по сути запроса, поэтому повторять без изменений бесполезно. Измените формулировку промпта или замените изображение — уберите то, что могло вызвать срабатывание.

## Исходный файл не подошёл по параметрам

Здесь дело не в содержимом, а в характеристиках файла — разрешении, пропорциях, длительности. Большую часть таких несовпадений Строфи закрывает сам: перед отправкой файл приводится к тому виду, который принимает выбранная модель. Мы следим за отказами и переносим в эту подготовку каждый новый случай, поэтому до блока такие ошибки доходят редко.

Если ошибка всё же показана, сообщение указывает, что именно не так:

- «Изображение слишком маленькое, нужно минимум 512×512 пикселей» — возьмите файл большего разрешения.
- «Изображение слишком большое, попробуйте уменьшить размер» — уменьшите разрешение файла.
- «Не удалось загрузить изображение, попробуйте другой файл» и «Не удалось загрузить файл, проверьте что он доступен» — файл не открылся, попробуйте другой или пересохраните этот.
- «Слишком узкое соотношение сторон у входного изображения» — кадр слишком вытянут для этой модели, подойдёт более близкий к квадрату.
- «Входное видео слишком короткое — минимум 3 секунды» — возьмите ролик подлиннее.
- «Не удалось распознать персонажа на входном изображении или видео» — для переноса движения нужен один человек в кадре без смены ракурса.

Как подготовить вход заранее, чтобы не наткнуться на эти ограничения, — в статье [Что подавать на вход генерации](https://strophe.app/docs/product/generation/inputs-and-references).

## Сервис не справился прямо сейчас

Эти ошибки технические, они возникают на стороне сервиса генерации и обычно проходят при повторе:

- «Сервис генерации временно перегружен, попробуйте через минуту»
- «Сервис временно недоступен, попробуйте позже»
- «Внешний сервис вернул ошибку, попробуйте ещё раз»
- «Ошибка соединения с сервисом генерации, попробуйте ещё раз»
- «Произошла ошибка на сервере, попробуйте ещё раз»
- «Модель временно недоступна. Попробуйте позже или выберите другую модель»

Если ошибку не удалось распознать, Строфи показывает общее сообщение вроде «Что-то пошло не так, но мы уже чиним» — это тоже техническая заминка, повтор часто помогает.

Подождите минуту и запустите снова — обычно этого хватает. Если недоступна конкретная модель, выберите в блоке другую. Если ошибка повторяется, напишите нам на `hello@strophe.app` — так мы разберёмся быстрее и ответим, что с этим делать.

## Не хватило кредитов

Если на балансе не хватает средств на генерацию, Строфи сообщает о нехватке кредитов — чаще всего ещё до запуска, показывая, сколько доступно и сколько нужно. Пополните баланс или выберите модель подешевле. Как расходуются кредиты и от чего зависит стоимость генерации — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

---

# Редактирование части изображения

> Как изменить только выделенную область изображения: где открывается редактор, как работает кисть и какие модели это умеют.

Источник: https://strophe.app/docs/product/generation/image-editing
Обновлено: 2026-08-19

Иногда результат устраивает почти полностью, кроме одной детали: не тот цвет, лишний предмет в кадре или неверная надпись. Переделывать всё изображение заново не обязательно — Строфи умеет менять только выделенную область, оставляя остальное без изменений.

## Где открыть редактирование по маске

Выделите блок с готовым изображением на холсте: над ним появится панель с кнопками Сгенерировать и Редактировать. Тот же пункт есть в контекстном меню блока.

Неважно, как изображение попало в блок — сгенерировано моделью или загружено вами: редактирование по маске доступно в обоих случаях.

## Как закрасить область кистью

После открытия редактора курсор над изображением превращается в кружок размером с текущую кисть. Им закрашивают нужную область, зажав и протянув кнопку мыши по изображению. Закрашенное место подсвечивается полупрозрачным жёлтым цветом.

Размер кисти меняется ползунком в левом нижнем углу панели: зажмите его и потяните в стороны, текущее значение показано числом рядом (от 10 до 100, по умолчанию — 40). Быстрее то же самое можно сделать прямо над изображением — прокрутите колесо мыши, зажав `Alt`.

Кнопка Отменить снимает последний мазок, Повторить возвращает его обратно, «Очистить» убирает всю область целиком. Отмена и повтор работают и горячими клавишами — `Cmd/Ctrl + Z` и `Shift + Cmd/Ctrl + Z`.

В поле для текста под изображением опишите, что должно появиться на месте закрашенной области. Пока область не закрашена или поле пустое, кнопка запуска неактивна.

## Какие модели умеют такое редактирование

Редактирование по маске поддерживают Nano Banana, Nano Banana 2 и Nano Banana Pro. Список моделей в панели редактора сужается до них.

Модель выбирают там же, где обычно, — в списке в правом углу панели, рядом со стоимостью запуска.

## Что происходит с результатом

Готовый результат не заменяет изображение насовсем, а добавляется новым результатом в историю блока — так же, как при обычном повторном запуске. Подробнее — в статье [Результаты и история генераций](https://strophe.app/docs/product/generation/generation-history).

Если переключиться на другой результат из истории, пока редактор открыт, он начнёт работать с этим изображением, а нарисованная область очистится — маска не переносится с одного изображения на другое.

## Сколько это стоит

Редактирование по маске списывает кредиты так же, как обычная генерация: стоимость выбранной модели видна в панели редактора ещё до запуска. Подробнее — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

---

# Обработка готового содержимого

> Какие модели дорабатывают готовое изображение, видео или 3D-модель: увеличение разрешения, удаление фона, векторизация, смена ракурса, ретекстурирование, перенос движения.

Источник: https://strophe.app/docs/product/generation/utilities
Обновлено: 2026-08-19

Готовое изображение, видео или 3D-модель почти всегда можно доработать без повторной генерации. В Строфи для этого есть отдельные модели: они не создают содержимое заново, а меняют уже существующее.

## Что можно сделать с готовым изображением

| Модель                 | Что делает                                                                             |
| ---------------------- | -------------------------------------------------------------------------------------- |
| Recraft Upscaler       | Увеличивает разрешение — вариант Crisp повышает чёткость, Creative дорисовывает детали |
| Bria Background Remove | Убирает фон, оставляя объект на прозрачном слое                                        |
| Recraft Vectorizer     | Превращает растровое изображение в векторный SVG                                       |
| Qwen Multiple Angles   | Поворачивает объект в другую точку обзора                                              |

У Qwen Multiple Angles ракурс задаётся не ползунками, а объёмным элементом, который вращают мышью, — им же задают приближение.

## Что можно сделать с видео и 3D-моделью

| Модель                  | Что делает                                                |
| ----------------------- | --------------------------------------------------------- |
| ByteDance Video Upscale | Увеличивает разрешение видео до 4K и частоту кадров до 60 |
| Kling Motion Control    | Переносит движение с видео на изображение персонажа       |
| Meshy Retexture         | Меняет материал и текстуру 3D-модели, не трогая её форму  |

У Kling Motion Control длительность исходного видео принимается от 3 до 30 секунд, а тумблер «Оставить аудио» сохраняет звук исходника. У Meshy Retexture желаемый вид описывают текстом или прикладывают изображение-образец стиля, а тумблер «Реалистичные материалы» точнее передаёт отражение света.

## Как быстро вызвать эту обработку

Для готового изображения или 3D-модели быстрый способ — потянуть соединение от блока и отпустить в пустом месте холста: вместо нового блока откроется меню быстрых действий. Подробнее о самом соединении — в статье [Соединения между блоками](https://strophe.app/docs/product/canvas/connections).

Для изображения в меню собраны: «Описать» содержимое текстом, «Убрать фон», «Векторизовать» и группа «Улучшить качество» с тремя вариантами увеличения — «Увеличить до 4K (линейно)», «Увеличить до 2K (креативно)» и «Увеличить до 4K (креативно)». Стоимость в кредитах видна рядом с каждым пунктом.

Часть пунктов скрывается сама: векторизация и удаление фона — если файл уже в формате SVG, удаление фона — если оно уже было применено, а вся группа увеличения — если изображение уже не меньше 4K по одной из сторон.

Для 3D-модели в меню есть «Извлечь кадр» — снимок текущего вида модели становится новым изображением. Это единственная операция здесь, за которую не списываются кредиты: она делается на месте, без обращения к модели.

## Как добавить такой блок на холст вручную

Через каталог блоков — кнопку Все блоки или `Cmd/Ctrl + K`. Увеличение разрешения, векторизация, удаление фона, смена ракурса, апскейл видео и ретекстурирование собраны в категории «Утилиты», а Kling Motion Control лежит среди моделей видео.

В панели выбора модели, которая открывается кнопкой Сгенерировать на готовом блоке, этих операций нет — кроме ретекстурирования: оно появляется в списке моделей для блока с 3D-моделью наравне с обычными.

## Как отредактировать только часть изображения

Готовое изображение можно поправить точечно — закрасить кистью нужную область и описать, что там должно получиться. Это отдельный режим редактора, он описан в статье [Редактирование части изображения](https://strophe.app/docs/product/generation/image-editing).

---

# Генерация текста

> Как получить текст от модели, чем текстовая генерация отличается от генерации изображений и как использовать полученный текст дальше в цепочке.

Источник: https://strophe.app/docs/product/generation/text-generation
Обновлено: 2026-08-19

Генерация текста устроена как обычный блок генерации, но ведёт себя иначе на нескольких важных этапах: ответ приходит не сразу, стоимость заранее не показывается, а результат — это такой же текстовый блок, который можно сразу пустить дальше по проекту как промпт. Ниже — то, что отличает именно текст.

## Как собрать генерацию текста

В каталоге блоков, в категории «Текст», есть блок генерации текста. Модели он берёт из OpenRouter — от Claude и GPT до открытых моделей, — а выбирают их списком прямо в блоке. Подключите к входу Промпт текстовый блок с заданием, как для любой другой генерации.

Результат генерации приходит в обычный текстовый блок — так же, как и при любой другой генерации. Подробнее об устройстве блока генерации и о том, куда попадает результат, — в статье [Как работает генерация](https://strophe.app/docs/product/generation/how-it-works), о входах для примеров и содержимого — в статье [Что подавать на вход генерации](https://strophe.app/docs/product/generation/inputs-and-references).

## Текст приходит целиком или по частям

По умолчанию ответ появляется в блоке постепенно, по мере того как модель его формирует: пока запрос ещё не начал обрабатываться, на блоке крутится индикатор загрузки, а как только модель начинает отвечать — текст в блоке дописывается небольшими порциями, без индикатора.

Это поведение можно отключить: среди параметров блока есть переключатель «Стриминг», включённый по умолчанию. Если его выключить, блок останется с индикатором загрузки до самого конца и получит весь ответ одним куском, когда модель закончит генерировать.

## Можно ли остановить генерацию на середине

Да, тем же способом, что и любую другую, — через список задач по счётчику кредитов ([Очередь, ожидание и отмена генерации](https://strophe.app/docs/product/generation/queue-and-status)). Кнопки остановки на самом блоке нет.

## Может ли модель прочитать изображение

В каталоге есть текстовые модели, которые умеют распознавать содержимое изображений и учитывать его в ответе. Если вы выбрали такую модель, на блоке автоматически появляется дополнительная точка входа Изображения — к ней можно подключить до четырёх изображений одновременно, в дополнение к тексту. У моделей без такой возможности эта точка на блоке не отображается вовсе.

Учтите обратный ход: если переключиться с такой модели на ту, что изображения не принимает, точка входа исчезает вместе с подключёнными к ней соединениями — изображения придётся подключать заново, если вы вернётесь к прежней модели.

## Куда идёт результат и как он выглядит

Ответ модели приходит с сохранением разметки: если модель ответила заголовками, списком или выделила часть текста жирным, в блоке это отобразится так же — заголовками, списком и выделением, а не сплошным текстом со значками разметки. После генерации это обычный текстовый блок: его можно редактировать так же, как любой другой (подробнее в статье [Какие бывают блоки](https://strophe.app/docs/product/canvas/block-types)).

Поскольку это тот же тип блока, что и обычный текстовый блок с промптом, результат генерации можно сразу подключить к входу Промпт следующей генерации — изображения, видео или снова текста. Никаких дополнительных действий для этого не требуется.

## Сколько стоит генерация и есть ли предел на длину ответа

Стоимость генерации текста заранее не показывается: цена зависит от объёма поданного текста и от длины ответа, а она заранее не известна. Списание происходит после того, как генерация завершилась, — подробнее в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits). Ненулевой баланс при этом нужен и здесь: с пустым счётом запуск не пройдёт.

Максимальную длину ответа можно задать самостоятельно: в дополнительных параметрах блока есть значение «Макс. токенов» — по умолчанию 8192, его можно менять в пределах от 50 до 16384. Рядом лежит «Температура»: чем она выше, тем разнообразнее и неожиданнее ответы, чем ниже — тем ближе они к одному и тому же на повторный запрос.

---

# Генерация 3D-моделей

> 3D-модель генерируется только из изображения, не из текста; детализацию сетки задают параметром «Количество полигонов», результат — модель в формате GLB.

Источник: https://strophe.app/docs/product/generation/3d-specifics
Обновлено: 2026-08-19

Генерация 3D устроена не так, как создание изображений или видео. На вход всегда нужно изображение того, что вы хотите превратить в объём: модель достраивает по снимку объёмную геометрию, а промпт при этом не используется. Пока изображение не подключено, запуск не стартует.

Если вы начинаете с идеи в словах, сначала сгенерируйте по ней изображение, а уже его подайте на вход 3D-модели.

## Как выбрать между быстрым и более тщательным результатом

У части 3D-моделей есть два варианта — быстрый и более тщательный. Быстрый отдаёт результат заметно скорее и стоит дешевле, тщательный считает дольше и даёт более чистую геометрию.

Переключаются они выбором «Версии» на блоке. О том, что при этом происходит с настройками, — в статье [Параметры генерации](https://strophe.app/docs/product/generation/parameters).

## Как настроить детализацию модели

«Количество полигонов» в дополнительных параметрах задаёт плотность сетки — от 10 000 до 300 000 граней, по умолчанию 30 000. Чем плотнее сетка, тем глаже поверхность и мельче различимые детали. У части моделей плотность выше стандартной добавляет к стоимости запуска фиксированную надбавку.

Тумблер «Реалистичные материалы» точнее передаёт отражение света поверхностью.

## В каком виде приходит результат

Готовая 3D-модель появляется в блоке как объёмный объект в формате GLB — полноценная модель с текстурированной поверхностью, которую видно с любой стороны.

Рассматривать её — вращать, приближать, возвращать камеру в исходное положение — можно прямо на холсте. Как это делать, описано в статье [Просмотр 3D-модели](https://strophe.app/docs/product/canvas/3d-viewer).

Чтобы изменить внешний вид готовой модели — перекрасить поверхность или сделать материал реалистичнее, — есть отдельные действия над уже созданной моделью, они собраны в статье [Обработка готового содержимого](https://strophe.app/docs/product/generation/utilities).

---

# Промптинг

Раздел справки Строфи целиком, статьи в порядке чтения. Источник: https://strophe.app/docs/product/prompting

# Из чего состоит хороший промпт

> Универсальный порядок описания сцены, который понимают все модели каталога, и чем подробный промпт отличается от короткого.

Источник: https://strophe.app/docs/product/prompting/how-to-write
Обновлено: 2026-08-07

Промпт — это текст, который вы подаёте на вход блока генерации. Модель получает его ровно в том виде, в каком вы написали: ничего не дописывается и не переводится по дороге. Поэтому результат почти целиком зависит от того, насколько точно вы описали желаемое.

## Порядок описания

Официальные руководства всех крупных моделей — Google, ByteDance, Kuaishou, OpenAI — сходятся на одной последовательности. Она и есть основа:

**субъект → действие → окружение → свет и настроение → камера → стиль**

Не обязательно заполнять всё. Для предметной съёмки не нужно действие, для абстрактного фона не нужен субъект. Но если элемент важен, он должен стоять на своём месте — модели читают промпт последовательно и первым частям доверяют больше.

Пишите связными предложениями, а не перечнем через запятую. Это не стилистическая придирка: руководство Seedream прямо приводит перечисление как пример плохого промпта, и на остальных моделях каталога оно работает не лучше.

Плохо:

```
girl, parasol, tree-lined path, oil painting
```

Хорошо:

```
A girl in a lavish dress walking under a parasol along a tree-lined path,
in the style of a Monet oil painting.
```

## Конкретика важнее красивых слов

Разница между «фэнтезийные доспехи» и «изысканные эльфийские латы с гравировкой из серебряной фольги, высоким воротником и наплечниками в форме соколиных крыльев» — это разница между случайным результатом и тем, что вы задумали. Прилагательные общего смысла («красивый», «атмосферный», «качественный») модель почти не использует: они не сужают выбор.

Полезно называть назначение изображения, когда оно есть. «Сделай логотип для премиального минималистичного бренда ухода за кожей» даёт заметно лучший результат, чем «сделай логотип», — модель подбирает композицию и типографику под задачу, а не рисует абстрактную эмблему.

## Подробное описание работает как промпт

Если у вас уже есть изображение, которое хочется повторить или взять за образец, самый надёжный путь — описать его подробно, а не пересказать в двух словах. Топовые модели следуют длинному описанию довольно точно.

На этом же построено быстрое действие «Описать детально» у блока изображения: оно разбирает изображение и выдаёт развёрнутое описание, которое можно подать любой модели как промпт.

## Параметры — не часть промпта

Соотношение сторон, разрешение, длительность видео и стилевые пресеты задаются в самом блоке генерации, а не словами в тексте. Строка «16:9, 4K, 10 секунд» внутри промпта не изменит настройки блока, зато займёт внимание модели и может сбить композицию.

## Сколько писать

Единого ответа нет, и это главное различие между моделями. Одни модели выигрывают от максимальной плотности описания, другие от неё теряют детали. Подробнее — в статье [Почему один и тот же промпт работает по-разному](https://strophe.app/docs/product/prompting/model-differences).

---

# На каком языке писать промпт

> Почему тело промпта стоит писать по-английски, как оставить внутри него русский текст и что происходит с русской речью в видеомоделях.

Источник: https://strophe.app/docs/product/prompting/language
Обновлено: 2026-08-07

Промпт уходит в модель без перевода — в том виде, в каком вы его написали. Модели каталога обучены преимущественно на английских описаниях, поэтому английский промпт даёт более предсказуемый результат, чем тот же смысл по-русски.

## Тело промпта — по-английски

Это относится к описательной части: субъект, действие, окружение, свет, камера, стиль. Русский промпт чаще всего тоже сработает, но заметно хуже отражает нюансы — редкие термины, названия техник и материалов, устойчивые формулировки киноязыка.

Литературности от английского не требуется: модель читает описание, а не текст. Достаточно точных существительных и глаголов — что в кадре, что происходит, как снято.

## Какой текст не нужно переводить на английский

Из правила есть важное исключение. Всё, что должно быть **видно на изображении** или **прозвучать в видео**, остаётся на своём языке, прямо внутри английского промпта. Если перевести русскую вывеску на английский, модель нарисует английские буквы.

```
A morning street in an old town, a small bakery with a hand-painted wooden
sign above the entrance reading "Пекарня", soft low sunlight.
```

Язык надписи полезно называть явно, а сам текст — брать в кавычки. У Seedream двойные кавычки прямо предписаны руководством как способ отметить текст для отрисовки.

## Речь в видео: у моделей разные возможности

Здесь единого правила нет, и разница существенная: модель может озвучить реплику не на том языке, никак об этом не предупредив.

**Seedance 2.0 и 2.5** поддерживают произвольный язык реплики: язык называется явно, и модель озвучивает текст на нём. У версии 2.5 многоязычность заявлена отдельной возможностью — больше десяти языков нативно.

**Veo 3.1** официально проверен только на английском. Другие языки могут сработать, но результат нестабилен.

**Kling 3.0, 2.6 и 2.5 Turbo** синтезируют речь только на китайском, английском, японском, корейском и испанском. Реплику на любом другом языке модель **переводит на английский** — русский диалог на Kling получить нельзя.

Если в видео нужна русская речь, выбирайте Seedance. Ролик с репликой не на том языке — это успешная генерация, кредиты за неё спишутся, поэтому выбирать модель стоит до запуска, а не после.

## Кириллица на изображении

Насколько аккуратно модель нарисует русские буквы, зависит от модели и в официальных руководствах не описано. Лучше всего с типографикой справляются Nano Banana Pro и Seedream — с них и стоит начинать, если надпись важна. Подробнее — в статье [Надписи на изображении](https://strophe.app/docs/product/prompting/text-in-result).

---

# Надписи на изображении

> Как попросить модель нарисовать конкретный текст, какие модели делают это точнее других и почему у каждого свой способ отметить надпись.

Источник: https://strophe.app/docs/product/prompting/text-in-result
Обновлено: 2026-08-02

Текст на изображении — постер, вывеска, обложка, логотип с названием — модели рисуют как графику, а не набирают шрифтом. Поэтому надпись нужно отметить в промпте так, чтобы модель поняла: это буквы, которые должны появиться в кадре дословно.

## Общее правило

Заключите текст в кавычки и скажите, где он находится. Так надпись отделяется от описания сцены.

```
Design a poster for a jazz festival with the title "Ночь в городе" printed
across the top in bold condensed lettering.
```

Чем короче надпись, тем выше шанс, что она выйдет без ошибок. Длинные фразы, мелкий текст и абзацы модели искажают почти всегда.

## Различия между моделями

**Seedream** — двойные кавычки предписаны официальным руководством именно для этого случая. Это самый надёжный способ в этой модели.

**Nano Banana Pro и Nano Banana 2** аккуратно рисуют типографику, включая сложные композиции. Руководство Google советует приём в два шага: сначала определиться с точной формулировкой текста, а потом просить изображение уже с ней. Nano Banana Pro — сильнейшая модель каталога по части шрифтов и вёрстки.

**GPT Image 2** официально признаёт, что точность размещения и чёткость текста у него хромают. Если надпись — главное в задаче, возьмите другую модель.

**Nano Banana 2 Lite** не рассчитана на сложные задачи и работает только в 1K — для типографики не лучший выбор.

## Кириллица

Отдельного упоминания в руководствах вендоров русские буквы не получают, поэтому гарантий нет. На практике лучше всего справляются Nano Banana Pro и Seedream. Текст надписи всегда пишется по-русски прямо внутри английского промпта — переводить его не нужно, иначе в кадре появятся английские слова. Подробнее — в статье [На каком языке писать промпт](https://strophe.app/docs/product/prompting/language).

## Если буквы вышли с ошибками

Это обычное дело даже у сильных моделей. Что помогает:

- Сократить надпись. Одно-два слова выходят точнее фразы.
- Повторить генерацию: результат от запуска к запуску различается.
- Указать характер шрифта словами — «bold condensed sans-serif», «hand-painted serif».
- Взять готовое изображение и попросить исправить только текст, оставив остальное неизменным. Как формулировать такую правку — в статье [Промпт для правки готового изображения](https://strophe.app/docs/product/prompting/editing).

---

# Промпт для правки готового изображения

> Чем инструкция редактирования отличается от описания изображения, почему нужно называть неизменное и как указать модели место правки.

Источник: https://strophe.app/docs/product/prompting/editing
Обновлено: 2026-08-07

Подключённое изображение модель может использовать двояко: как исходник, который надо поправить, и как образец стиля или персонажа для нового изображения. Роль задаёт промпт. Эта статья — про первый случай: когда изображение правят. Тогда промпт перестаёт быть описанием изображения и становится инструкцией, что именно изменить, — описывать заново всю сцену не нужно, модель видит её сама. Про образцы и референсы — статья [Несколько изображений на входе](https://strophe.app/docs/product/prompting/references).

## Назовите цель правки и то, что остаётся

Модели «плывут» по всему, чего вы не назвали явно: меняется поза, выражение лица, свет, фон. Поэтому в промпте редактирования две обязательные части — что изменить и что оставить как есть.

```
Add matching silver earrings and a necklace to the woman, keeping her pose,
expression, hairstyle and the background unchanged.
```

Руководства Seedream и Google требуют этого одинаково. Чем важнее сохранить исходник, тем подробнее список неизменного.

## Без местоимений

«Убери это», «поменяй его цвет», «сделай ту штуку слева поменьше» — модель не понимает, о чём речь. Называйте объект: «убери шляпу», «поменяй цвет дивана на тёмно-зелёный».

Глаголы лучше брать прямые и однозначные: add, remove, replace, transform, dress, turn into.

## Одна правка за раз

Четыре изменения в одном предложении модель выполняет частично — что-то теряется. Если правок несколько, запускайте их последовательно, каждый раз подавая на вход результат предыдущего шага.

## Указание места

Некоторые модели понимают пометки прямо на входном изображении. Seedream официально поддерживает стрелки, рамки, обводки и цветные области: «поставь телевизор туда, где красная область, а диван — где синяя». Seedream 5.0 Pro заточен под такую работу отдельно.

У GPT Image маска работает иначе: она подсказывает область, но не задаёт её точную геометрию, и модель может выйти за контур. Если на вход подано несколько изображений, маска применяется к первому.

## Когда правка не выходит

Если модель упорно меняет то, что вы просили не трогать, чаще всего помогает не более сильная формулировка, а смена подхода: описать желаемый результат целиком и сгенерировать заново, взяв исходник как референс. Про подачу нескольких изображений — в статье [Несколько изображений на входе](https://strophe.app/docs/product/prompting/references).

---

# Несколько изображений на входе

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

Источник: https://strophe.app/docs/product/prompting/references
Обновлено: 2026-08-07

Когда на вход блока подано несколько изображений, модель должна понять, какую роль играет каждое: откуда взять человека, откуда одежду, откуда стиль. Само по себе это из изображений не следует — роли задаёт промпт. Что вообще принимают на вход разные модели, собрано в статье [Что подавать на вход генерации](https://strophe.app/docs/product/generation/inputs-and-references).

## Адресация по порядку

Изображения нумеруются в том порядке, в каком подключены к блоку. В промпте на них ссылаются по номеру:

```
Replace the subject in Image 1 with the subject from Image 2, keeping the
lighting and background of Image 1.
```

Порядок соединений и есть порядок референсов. Номера самих соединений в интерфейсе не подписаны — рядом со входом виден только счётчик подключённых изображений. Поэтому, если результат перепутал источники, надёжнее всего отключить входы и подключить их заново в нужной последовательности. Как устроены соединения, разобрано в статье [Соединения между блоками](https://strophe.app/docs/product/canvas/connections).

## Больше референсов не значит лучше

Ниже — рекомендации из руководств самих разработчиков моделей, а не пределы Строфи: сколько изображений примет конкретный блок, показывает счётчик рядом со входом. Почти везде рекомендуемое число заметно ниже технического максимума:

| Модель                 | Пределы                                                  |
| ---------------------- | -------------------------------------------------------- |
| Nano Banana Pro        | до 6 объектов, до 5 персонажей, до 3 стилевых референсов |
| Nano Banana 2          | до 10 объектов, до 4 персонажей                          |
| Nano Banana 2 Lite     | до 14 объектов, консистентность персонажа не поддержана  |
| Nano Banana            | лучше всего с тремя изображениями                        |
| Seedream               | до 14 (Seedream 5.0 Pro — до 10)                         |
| Veo 3.1                | до 3                                                     |
| Grok Imagine           | до 3 при редактировании                                  |
| Seedance 2.0 Reference | до 9 изображений и 3 роликов                             |
| Seedance 2.5 Reference | до 30 изображений, 10 роликов и 10 звуковых отрывков     |

Руководство Seedance прямо предупреждает: если забить лимит до отказа, модель перестаёт понимать приоритеты. Для Seedance 2.0 там же назван рекомендованный набор — четыре-пять материалов: одно-два изображения персонажа, одна сцена, одно видео с нужным движением камеры, одна звуковая дорожка.

У Seedance 2.5 рекомендации даны не по числу файлов, а по числу героев: до восьми, если герой задан изображением, и до пяти, если голосом или роликом. Дальше доходит и до двенадцати, но стабильность падает и попытку приходится повторять. Ролики и звуковые отрывки, с которых снимается образец, лучше держать в пределах пяти-десяти секунд — на длинных модель сбивается.

## Консистентность персонажа

Чтобы персонаж не менялся от кадра к кадру, дайте отдельный портрет крупным планом с нейтральным выражением и отдельный снимок в полный рост, а самый важный референс поставьте в промпте первым.

Разворотные листы персонажа — набор ракурсов на одном изображении — для Seedance 2.0 противопоказаны: модель принимает разные ракурсы за разных людей и может нарисовать в кадре двойника. Seedance 2.5 их принимает, но с оговоркой: до пяти героев одинаково работают и один ракурс, и несколько, а если героев больше — надёжнее по одному ракурсу на изображение, чем несколько ракурсов на одном. Остальное про описание движения и кадра — в статье [Промпт для видео](https://strophe.app/docs/product/prompting/video).

## Привязку пишут в промпте, а не на изображении

Подписать имя героя прямо поверх его изображения и дальше ссылаться на это имя в тексте — приём, который не работает: модель путает героев и рисует лишних. Связь «кто есть кто» задаётся только текстом промпта, по номерам входов.

Когда героев несколько, перечислите соответствия по одному, списком:

```
Images 1-2 are Character 1 and correspond to Audio 1;
Images 3-4 are Character 2 and correspond to Audio 2.
```

И скажите, что именно берётся с каждого материала: «Refer to Image 1 for lighting and filters», «Refer to the action of casting the spell in Video 1». Если материал сам по себе точен, пересказывать его содержание словами не нужно — достаточно сослаться и добавить, что порядок должен совпасть с исходником.

## Стиль отдельно от содержания

Если один референс задаёт содержание, а другой — манеру рисунка, скажите это прямо: «Apply the style of Image 2 to the scene in Image 1». Без такого указания модель смешает оба источника.

---

# Промпт для видео

> Чем описание движения отличается от описания изображения, как раскладывать сцену на кадры, что писать про камеру и звук и где модели расходятся сильнее всего.

Источник: https://strophe.app/docs/product/prompting/video
Обновлено: 2026-08-07

В видео к описанию кадра добавляется развитие во времени: что происходит, в каком порядке и как при этом ведёт себя камера. Обычно достаточно порядка событий; точные секунды понимают не все модели — об этом ниже. Промпт, который хорошо работает для изображения, для видео обычно недостаточен — он описывает состояние, а не изменение.

## Что добавить к описанию сцены

**Движение субъекта.** Не «человек идёт», а что именно и как: какой частью тела, с какой скоростью, с каким усилием. «Медленно поднимает руку», «резко поворачивает голову».

**Поведение камеры.** Стоит неподвижно, следует за героем, наезжает, отъезжает, облетает. Термины киноязыка модели понимают: medium shot, close-up, slow push-in, tracking shot, fixed shot.

**Развитие во времени.** Что в начале, что в середине, чем заканчивается.

**Звук**, если модель его генерирует: реплики, звуковые эффекты, фоновая среда.

## Раскадровка вместо прозы

Сложную сцену лучше разложить на кадры, а не описывать сплошным текстом. Формат понимают и Seedance 2.0, и Kling 3.0:

```
Shot 1, wide shot of a truck driver at dawn, cinematic handheld.
Shot 2, macro shot of hands on the steering wheel.
Shot 3, close-up of a weathered photograph on the passenger seat.
```

Одно движение камеры на кадр. Наезд, отъезд и панорама одновременно ломают стабильность изображения.

Seedance 2.5 понимает и второй способ разметки — по времени. Годятся интервалы (`0-3 seconds… 3-7 seconds…`), отдельные моменты («быстрый переход влево на пятой секунде») и относительные указания («через три секунды после того, как он замер»). Шаг разметки — целая секунда, доли модель не различает.

Два правила при разметке по времени. Интервалы идут подряд, без пропусков: дыра вида «0–3 с… 5–6 с» сбивает модель. И на каждый интервал приходится столько событий, сколько в него реально помещается — пустой интервал модель заполнит отсебятиной, переполненный нарежет лишними склейками или выбросит часть задуманного. Для частых повторяющихся движений разметка по времени не годится вовсе: «мотает головой три раза в секунду» не отрабатывается.

## Раскадровка на входе: лист или ключевые кадры

Раскадровку можно не описывать словами, а подать изображением. Seedance 2.5 Reference различает два способа, и строгость у них разная.

**Лист с раскадровкой** — несколько клеток на одном изображении. Модель читает его как общий план сюжета, а не как точный образец: композиция и детали кадров в результате будут своими. Годится до пятнадцати клеток, и лучше работает простой линейный набросок — без заливки, без подписей поверх изображения.

**Ключевые кадры** — каждый кадр отдельным изображением, поданным по порядку. Здесь совпадение с исходниками заметно строже. В промпте это открывается прямой фразой:

```
Use Images 1 to 7 in order as keyframes.
```

Если важно, чтобы кадр в результате действительно совпал с задуманным, выбирайте второй способ.

## Держите сцену выполнимой

Всё, что вы описали, должно уместиться в выбранную длительность. Сюжет на минуту, втиснутый в пять секунд, превращается в мельтешение. Плавные непрерывные движения выходят лучше резких: спринт, прыжки и кувырки моделям даются плохо.

Точное количество предметов и людей модели не удерживают — «десять щенков» превратятся в неопределённое количество. Сложная физика тоже: отскок мяча, траектория броска.

## Эмоция через физику

Абстракции вроде «грустная девушка» модель понимает слабо. Описывайте телом: опущенная голова, подрагивающие плечи, покрасневшие глаза, пальцы теребят край одежды.

## Где модели расходятся

**Точное время.** Kling 3.0 понимает указания вида «на четвёртой секунде» и «в последние три секунды» — они есть в примерах официального руководства. Seedance 2.0 от жёстких секунд наоборот плывёт: там работают только номера кадров, а ритм лучше оставить модели. Seedance 2.5 это различие снял — руководство прямо противопоставляет версии и разрешает разметку по целым секундам.

**Подробность движения.** Seedance 2.0 просит разбирать действие по частям тела, с амплитудой и скоростью. Seedance 2.5 просит обратного: общее описание («несколько подходов с высоким подъёмом колена», «обе стороны сходятся в ближнем бою»), а подробно — только два-три запоминающихся движения. Расписывать там каждое одинаково дотошно вредно.

**Плотность.** Kling 3.0 рассчитан на длинные подробные режиссёрские описания. Kling 2.6 и 2.5 Turbo — наоборот, на простые слова и короткие конструкции. Это разные требования у одного бренда, и версия здесь важнее названия.

**Люди в кадре.** Модерация Seedance часто отклоняет референсы с людьми. Для видео с реальными людьми надёжнее Kling 3.0.

## Речь

Реплики привязываются к персонажу. У Kling 3.0 — прямо в тексте:

```
Mom (softly, in a surprised tone): I didn't expect this at all.
```

У Veo 3.1 — с именем и ремаркой, реплика в кавычках. У Seedance 2.0 для реплик отведены фигурные скобки, а для субтитров — отдельные скобки, и язык реплики называется явно.

В примерах руководства Seedance 2.5 реплика написана иначе — простой строкой с именем говорящего: `Dialogue (elderly woman): "Fly safe, my child."`. При этом официальный навык ByteDance для 2.5 прежний набор скобок сохраняет, то есть работают оба способа. Скобки размечают тип содержимого — реплику, музыку, звуковой эффект, — а именованная строка удобнее, когда говорящих несколько.

Языки речи у моделей разные, и это единственное место, где ошибка не видна до конца генерации. Подробности — в статье [На каком языке писать промпт](https://strophe.app/docs/product/prompting/language).

## Незаказанные субтитры и логотипы

Видеомодели дорисовывают то, чего не просили: субтитры под репликой, логотип чужой платформы, вотермарку. Полностью это не отключается, но вероятность снижают три вещи, и руководство Seedance перечисляет их вместе:

- прямой запрет в промпте — `no subtitles`, `do not generate a watermark`, `do not generate a logo`. Это тот случай, когда отрицание работает лучше положительной формулировки;
- чистые входные материалы: если на референсе есть текст и он не нужен, уберите его заранее отдельной генерацией;
- горизонтальный кадр — в вертикальном субтитры появляются заметно чаще. Если формат позволяет, снимайте горизонтально и обрежьте потом.

У Seedance 2.5 запрет распространяется и на звук: `no BGM`, `no audio`, `only environmental sounds and action sounds` — документированные формулировки.

## Продление и склейка

Продлевают и склеивают ролики сами модели, а не Строфи: у части видео-моделей есть вариант, который принимает готовый ролик и дописывает продолжение. При продлении качество накапливает искажения: после нескольких итераций лица идут пятнами. Стык кадров даёт заметный рывок.

Сколько роликов принимает вход, зависит от версии: Seedance 2.0 Reference — три клипа общей длительностью до пятнадцати секунд, и это же её предел на склейку. Seedance 2.5 Reference принимает до десяти клипов и до тридцати секунд суммарно; отдельного предела именно на склейку её руководство не называет.

---

# Промпт для аудио

> Чем промпт для музыки отличается от промпта для озвучки, как описывать голос и звуковую сцену и зачем аудио на входе нужна ссылка в тексте промпта.

Источник: https://strophe.app/docs/product/prompting/audio
Обновлено: 2026-08-04

Аудио-модели решают две разные задачи. Одни пишут музыку — инструментал или трек с вокалом. Другие собирают звуковую сцену целиком: реплики персонажей, фоновые шумы, эффекты и музыку одним куском. Промпт для этих задач устроен по-разному, и текст, написанный под одну, на другой даст не тот результат. Какая модель что умеет, видно в каталоге — состав каталога меняется, приёмы ниже остаются.

## Промпт для музыки

Музыкальной модели нужно описание самой музыки, а не сюжета или изображения, под которое она пойдёт. Работает набор из пяти вещей: жанр, настроение, инструменты, темп и характер вокала.

```
An energetic electronic dance track with soaring synth leads, punchy
four-on-the-floor kick drums and a catchy female vocal hook. 128 BPM.
```

Темп можно задавать числом в BPM или словами — «slow ballad», «fast tempo». Вокал описывается так же прямо: «male vocals», «female soprano», «rap». Если вокал не нужен, это лучше сказать явно.

Голоса реальных исполнителей модель воспроизводить отказывается — запрос «спой голосом такого-то» отклоняется фильтром.

Язык вокала называйте в промпте явно. У каждой модели свой список заявленных языков — у Lyria 3 это английский, немецкий, испанский, французский, хинди, японский, корейский и португальский, — но списком дело не ограничивается: русский вокал она поёт, хотя в заявленных языках его нет.

## Промпт для звуковой сцены

Модель звуковой сцены читает промпт как короткий сценарий. Сильный промпт называет обстановку, вводит каждого говорящего с описанием голоса и подачи, а потом даёт саму реплику.

```
Inside a huge football stadium, with the deafening roar of tens of thousands
of fans in the background. The commentator (middle-aged male, British accent,
rich penetrating voice, extremely exhilarated) shouts: "OH, HE SCORES!"
```

Что стоит задать про каждый голос: пол, примерный возраст, акцент, тембр, эмоцию и темп речи. Чем конкретнее описание, тем меньше модель выбирает наугад.

Музыка и звуковые эффекты описываются в том же тексте обычными словами — отдельных полей для них нет. Один непрерывный фоновый слой плюс несколько точных эффектов работают лучше, чем десяток разных звуков подряд.

Скорость речи, громкость и высота тона — параметры блока, а не часть промпта. Писать их словами в текст не нужно.

## Аудио на входе — это образец голоса

Аудио, подключённое к блоку генерации звука, — это образец голоса: модель повторит его звучание в своей озвучке. Сколько записей принимает модель, показывает сам блок; у Seed Audio 1.0 их до трёх.

Само подключение файла ничего не значит — на образец надо сослаться в тексте промпта. У Seed Audio 1.0 ссылка выглядит как `@Audio1`, `@Audio2`, `@Audio3`, и номер соответствует порядку соединений: первый подключённый файл — `@Audio1`.

```
Dex (smooth warm confident broadcaster voice, voiced by @Audio1), relaxed
and amused, says: "Alright, what exactly did you do?"
```

Промпт без такой ссылки — самая частая ошибка с этой моделью: файл подключён, в тексте о нём ни слова, и озвучка приходит чужим голосом либо генерация обрывается ошибкой.

## Каким должен быть образец голоса

Требования к записи жёсткие, и модель отклоняет то, что им не соответствует:

- не длиннее 30 секунд;
- ровно один голос — второй говорящий на записи делает её непригодной;
- без музыки и с минимумом фонового шума;
- одна эмоция и один тембр на всю запись;
- ровный уровень записи, естественный темп речи.

Если модель отказалась брать запись, дело почти всегда в этом: в файле музыка, несколько голосов или шумный фон.

## Чего аудио на входе не делает

Это не референс стиля. Музыкальный отрывок, подключённый в надежде «сделай похоже по звучанию», задачу не решает: входа для образца музыкального стиля у аудио-моделей нет, стиль задаётся только словами в промпте.

Подключённая к Seed Audio 1.0 запись используется ещё и для работы с готовым звуком — продлить фрагмент, склеить два фрагмента, заменить реплику, сохранив голос и звучание помещения. Всё это тоже задаётся текстом промпта со ссылкой `@Audio1`.

## Изображение вместо аудио

Аудио-модели принимают на вход и изображение. Музыкальной модели изображение задаёт настроение и тему будущего трека — так работает Lyria 3. Модели звуковой сцены она подсказывает характер озвучки: у Seed Audio 1.0 в этом режиме в промпте оставляют только текст, который нужно произнести.

Изображение и аудио одновременно Seed Audio 1.0 не принимает — что-то одно.

---

# Почему один и тот же промпт работает по-разному

> Главное расхождение между моделями — насколько плотно писать, а также сильные и слабые стороны основных моделей каталога.

Источник: https://strophe.app/docs/product/prompting/model-differences
Обновлено: 2026-08-07

Универсальный каркас промпта общий для всех моделей, а вот требования к тому, насколько плотно его заполнять, у моделей разные — иногда противоположные. Промпт, отточенный под одну модель, на другой может дать результат заметно хуже.

## Главное различие — плотность

**Любят подробность.** Nano Banana, Seedance, Kling 3.0, Veo. Здесь длинное детальное описание выигрывает: чем больше вы задали, тем меньше модель додумывает.

**Любят краткость.** Seedream. Официальное руководство ставит предел в 600 английских слов и предупреждает, что нагромождение украшений размывает внимание и детали выпадают. Сложную сцену со многими требованиями описывать можно и нужно — но простыми словами, без пышности.

**Любят простоту.** Kling 2.6 и 2.5 Turbo: простые слова, короткие предложения.

Обратите внимание, что Kling попал сразу в две группы. Версия модели меняет правила сильнее, чем разница между вендорами.

## Сильные стороны моделей

**Nano Banana Pro** — сложный визуальный дизайн, точная типографика, лучшее знание мира, до 4K. Первый выбор, когда в кадре важен текст или нужна выверенная композиция.

**Nano Banana 2** — универсал с хорошим балансом цены и качества, надёжный рендер текста, 4K.

**Nano Banana 2 Lite** — только 1K, не рассчитана на несколько референсов и многошаговое редактирование. Для простых задач.

**Seedream** — образовательный контент: формулы, схемы, инфографика, техническая иллюстрация. Понимает язык фотографии: тип плёнки, объектив, диафрагму, характер света. Умеет серии — набор иконок, раскадровку, брендбук: достаточно попросить «a series» или «a set» либо назвать количество.

**GPT Image 2** — ровный универсал, но с официально признанными слабостями: точность размещения и чёткость текста, консистентность повторяющегося персонажа между генерациями, сложные layout-чувствительные композиции. Прозрачный фон не поддерживает.

**Kling 3.0** — видео с людьми, мультикадровые сцены, нативный звук, длительность от трёх до пятнадцати секунд.

**Seedance 2.0** — видео по нескольким референсам, произвольный язык реплик, тонкий контроль движения.

**Seedance 2.5** — ролик до тридцати секунд одним куском, до пятидесяти материалов на входе, речь больше чем на десяти языках. Разметку сцены по секундам, ключевые кадры и раскадровку листом понимает только эта версия.

**Veo 3.1** — кинематографичность, звук, интерполяция между первым и последним кадром, продление ролика.

**Lyria 3** — музыка, инструментальная или с вокалом. Промпт описывает жанр, настроение, инструменты и темп.

**Seed Audio 1.0** — озвучка и звуковые сцены: реплики персонажей, эффекты и фоновая музыка одним куском. Умеет повторить голос с приложенного образца.

## Как выбирать

Если задача про текст в кадре — Nano Banana Pro или Seedream. Если про схему или инфографику — Seedream. Если про видео с русской речью — Seedance. Если про видео с людьми — Kling 3.0. Если про музыку — Lyria 3, а если про озвучку и звуковую сцену — Seed Audio 1.0; как писать промпт для обеих, разобрано в статье [Промпт для аудио](https://strophe.app/docs/product/prompting/audio).

Полный список моделей с ценами и возможностями — в статье [Каталог моделей](https://strophe.app/docs/product/generation/model-catalog).

---

# Что в промпте не работает

> Приёмы из Stable Diffusion и Midjourney, которые в Строфи не действуют, и привычные формулировки, которые вредят результату.

Источник: https://strophe.app/docs/product/prompting/antipatterns
Обновлено: 2026-08-07

Часть приёмов, привычных по другим генераторам, здесь не просто бесполезна — она ухудшает результат, потому что занимает внимание модели ничего не значащим текстом.

## Перечисление через запятую

Тег-стиль, принятый в Stable Diffusion и Midjourney, для моделей каталога — антипаттерн. Руководство Seedream приводит его как пример плохого промпта явным образом. Пишите предложениями.

## Веса и служебные флаги

Конструкции вида `(detailed face:1.4)`, `[background:0.5]` и флаги вроде `--ar 16:9`, `--v 6`, `--style raw` в Строфи не поддерживаются. Модель получит их как обычный текст и попытается осмыслить. Соотношение сторон и прочие настройки задаются параметрами блока.

## Слова-заклинания качества

`masterpiece`, `best quality`, `8k`, `ultra realistic`, `highly detailed`, `trending on artstation` — наследие моделей прошлого поколения. Современные модели и без них выдают максимальное качество, а место в промпте эти слова занимают.

Если нужен конкретный визуальный характер, называйте его предметно: тип плёнки, объектив, схему света, художественную технику.

## Отрицания в лоб

«Без машин» модель понимает плохо: упоминание машин повышает вероятность, что они появятся. Google рекомендует формулировать через положительное описание — говорить, что в кадре есть, а не чего в нём нет: «пустая улица ранним утром, чистый асфальт, длинные тени».

Исключение — технический мусор и звук. Незаказанные субтитры, вотермарки и логотипы чужих платформ в видео убираются именно прямым запретом, и руководство Seedance это предписывает. У Seedance 2.5 к ним добавлен звук: `no BGM`, `no audio`, `only environmental sounds` — документированные формулировки. Что ещё снижает вероятность незаказанных субтитров — в статье [Промпт для видео](https://strophe.app/docs/product/prompting/video).

## Параметры словами

Разрешение, длительность, соотношение сторон и номер сида внутри текста промпта ни на что не влияют. Это настройки блока.

## Слишком много референсов

Заполнять лимит входных изображений до отказа вредно: модель перестаёт понимать, что важнее. Подробнее — в статье [Несколько изображений на входе](https://strophe.app/docs/product/prompting/references).

## Разворотные листы персонажа для видео

Изображение с несколькими ракурсами одного героя Seedance 2.0 читает как нескольких разных людей — в кадре появляются двойники. Подавайте отдельные снимки. Seedance 2.5 разворотные листы принимает; оговорки собраны в статье [Несколько изображений на входе](https://strophe.app/docs/product/prompting/references).

## Сценарий целиком вместо промпта

Полный текст сценария со всеми репликами и ремарками модель не отрабатывает: она теряет приоритеты и путает персонажей. Разложите замысел на кадры — как в статье [Промпт для видео](https://strophe.app/docs/product/prompting/video).

---

# Файлы

Раздел справки Строфи целиком, статьи в порядке чтения. Источник: https://strophe.app/docs/product/files

# Загрузка файлов на холст

> Какие форматы файлов принимает Строфи, каковы пределы размера и пропорций и какими способами файл попадает на холст.

Источник: https://strophe.app/docs/product/files/uploading
Обновлено: 2026-08-07

Многие проекты в Строфи начинаются не с чистого холста, а с готового изображения, видео или 3D-модели, которую нужно доработать. Прежде чем добавлять файл на холст, полезно знать, какие форматы и размеры Строфи принимает — иначе загрузка не сработает, и придётся разбираться почему.

## Какие форматы файлов принимает Строфи

Для изображений: JPEG, PNG, GIF, WebP, SVG, а также HEIC и HEIF — форматы, в которых iPhone сохраняет фотографии по умолчанию.

Для видео: MP4, MOV и WebM.

Для 3D-моделей — только один формат, GLB. Другие форматы 3D (OBJ, FBX, STL и подобные) Строфи не принимает.

Для аудио: MP3, WAV, FLAC, AAC, OGG и M4A.

Любой другой формат Строфи отклоняет — блок не создаётся. При перетаскивании файла и при выборе через кнопку загрузки вы увидите сообщение о неподдерживаемом типе. При вставке из буфера обмена неподходящий файл пропускается молча, без сообщения, — если после `Cmd/Ctrl + V` на холсте ничего не появилось, дело чаще всего в формате.

## Что происходит со снимком в формате HEIC с iPhone

HEIC и HEIF Строфи принимает как есть, без предварительной конвертации на вашей стороне. Формат распознаётся не только по расширению файла, но и по содержимому — это работает, даже если файл был переименован и получил, например, расширение .jpg.

После загрузки на сервер Строфи автоматически конвертирует такой файл в JPEG, прежде чем он попадёт в блок на холсте. Специально готовить снимки с iPhone заранее не нужно. Что ещё происходит с файлом после загрузки, разобрано в [отдельной статье](https://strophe.app/docs/product/files/after-upload).

## Какой предел размера файла

Максимальный размер одного файла — 25 МБ; остальные пределы платформы собраны в статье [Ограничения и лимиты](https://strophe.app/docs/product/reference/limits-reference). Это правило одно для всех типов файлов — изображений, видео, 3D-моделей и аудио — и одинаково действует при любом способе загрузки: перетаскивании с компьютера, вставке из буфера обмена, кнопке загрузки на панели инструментов и перетаскивании в уже существующий блок.

Если файл превышает предел, блок не создаётся, а Строфи показывает сообщение о слишком большом файле. Подробность сообщения зависит от способа загрузки: при перетаскивании на холст в нём есть и название файла, и его фактический размер, при замене содержимого блока — только допустимый максимум.

## Какое соотношение сторон допустимо у изображения

Ограничение на пропорции действует только для изображений — у видео и 3D-моделей его нет.

Соотношение длинной стороны к короткой не должно превышать 10 к 1. Это относится к вытянутым как по горизонтали, так и по вертикали изображениям: длинная панорама или очень высокий скриншот с соотношением сторон более 10:1 будут отклонены.

Если файл не соответствует этим требованиям, блок не создаётся, а Строфи показывает подсказку о слишком узком соотношении сторон изображения.

## Какими способами можно добавить файл на холст

Перетащите файл с компьютера на пустое место холста — блок появится там, куда вы его отпустили.

Вставьте файл из буфера обмена сочетанием `Cmd/Ctrl + V`, если фокус не находится в текстовом поле. Так же работает вставка скриншота или изображения, скопированного из веб-страницы или документа — например, из Google Docs.

Нажмите на кнопку загрузки файла на панели инструментов — откроется системный диалог выбора файла, в котором можно выбрать сразу несколько файлов.

Перетащите файл на уже существующий на холсте [блок](https://strophe.app/docs/product/canvas/block-types) нужного типа — содержимое блока заменится новым файлом, даже если в блоке уже что-то было. Если тип файла не подходит блоку, вместо замены создаётся новый блок в точке, где вы отпустили файл, — он может лечь поверх прежнего.

При переносе файлов на занятый блок система обрабатывает только первый элемент из группы: остальные файлы игнорируются без уведомлений. Для массовой загрузки выделите несколько файлов и отпустите их на свободной области холста.

## Что происходит при перетаскивании нескольких файлов сразу

Ограничения на количество файлов за один раз нет. Каждый файл становится отдельным блоком: первый занимает точку, куда вы перетащили или вставили файлы, следующие блоки Строфи расставляет рядом с ним по очереди, не давая им пересекаться.

Если среди перетащенных файлов часть не проходит проверку — по формату, размеру или пропорциям — Строфи создаёт блоки только для подходящих файлов, а для каждого отклонённого показывает отдельное сообщение с причиной. При вставке из буфера обмена отклонённые файлы пропускаются молча.

Сами файлы передаются на сервер не одновременно, а один за другим по очереди — блок при этом появляется на холсте сразу, не дожидаясь окончания загрузки.

---

# Что происходит с файлом после загрузки

> Почему блок появляется раньше изображения, чем облегчённая версия для холста отличается от оригинала и что означает индикатор обработки.

Источник: https://strophe.app/docs/product/files/after-upload
Обновлено: 2026-08-07

Блок на холсте появляется сразу, но финальный вид — через пару секунд. За это время сервер сохраняет файл, создаёт облегчённую версию для показа и проверяет, что всё прошло без сбоев. Как отличить обычную задержку от ошибки — читайте ниже.

## Что видно на холсте, пока файл ещё не готов

Блок появляется на холсте в момент, когда вы отпустили файл или выбрали его в диалоге, — раньше, чем что-либо успело уйти на сервер. Сначала в блоке нет ни изображения, ни размытого наброска, только индикатор загрузки: в этот момент файл ещё передаётся с вашего устройства.

Как только файл целиком загрузился на сервер, вся дальнейшая подготовка происходит уже там и не зависит от браузера. Можно закрыть вкладку или уйти со страницы сразу после этого — обработка продолжится, а готовый блок вы увидите при следующем открытии проекта. Прерваться может только сама передача файла: если закрыть вкладку в первые мгновения, пока файл ещё не загрузился на сервер, загрузка не завершится.

## Как Строфи готовит изображение

Для изображения Строфи сохраняет исходный файл и отдельно создаёт компактную копию в формате WebP — именно её показывает блок на холсте, чтобы страница не грузила тяжёлые файлы. Крупное изображение в этой копии уменьшается по размеру, сам исходник остаётся как есть. Прозрачность копия сохраняет — это важно, например, для изображений с удалённым фоном; у непрозрачных изображений фон копии заливается белым.

Если в файле есть данные о повороте камеры (частый случай для снимков со смартфона), Строфи разворачивает изображение правильной стороной ещё на этом шаге. Снимок в формате HEIC на этом же шаге превращается в JPEG — подробнее об этом в статье [Загрузка файлов на холст](https://strophe.app/docs/product/files/uploading). Слишком маленькое изображение Строфи слегка увеличивает — это касается и компактной копии, и самого исходника, иначе платформе не с чем работать дальше. Для SVG отдельная компактная копия не создаётся: векторный файл и так лёгкий, показывается как есть.

## Как Строфи готовит видео

С видео Строфи сначала считывает длительность, разрешение и другие технические параметры, затем снимает первый кадр — статичное изображение, которую блок показывает вместо самого видео, пока вы не нажали воспроизведение. Из этого же кадра строится размытый набросок для первых секунд показа.

Компактную копию для холста Строфи создаёт только для видео высокого разрешения; для видео стандартного или небольшого размера отдельная копия не создаётся — на холсте показывается сам исходник. В любом случае исходный файл сохраняется без изменений и остаётся доступен для скачивания отдельно от того, что показано на холсте.

## Обрабатываются ли 3D-модели

Для 3D-моделей отдельная лёгкая версия не создаётся. Тот же файл, который вы загрузили, используется и для показа на холсте, и для скачивания. Поэтому у 3D-блока нет размытого наброска, который обычно предшествует появлению превью у изображений и видео, — как только файл загрузился на сервер и сохранился, блок готов к показу.

## Что если обработка не удалась

Если подготовка файла на сервере не завершилась успешно, Строфи не показывает отдельного сообщения — блок продолжает показывать индикатор загрузки. Само содержимое при этом не сохраняется: сбой на подготовке означает, что файл не загрузился в постоянное хранилище, и загрузку придётся повторить.

Здесь есть тонкость, о которой стоит знать. При каждом открытии проекта Строфи сверяет незавершённые операции и помечает как неудачные все, что остались в состоянии обработки. Загрузка файла в эту сверку попадает наравне с генерацией, а времени с момента загрузки она не учитывает: если переоткрыть проект в те несколько секунд, пока файл ещё готовится, блок окажется помечен как неудавшийся, хотя обработка на сервере в этот момент идёт нормально. Выглядит это как пустой блок без сообщения об ошибке — от только что созданного пустого блока он неотличим.

Если с блоком что-то не так, попробуйте добавить файл повторно: перетащите его поверх того же блока — содержимое заменится, и подготовка начнётся заново.

## Можно ли работать с блоком, пока он готовится

Пока файл обрабатывается, блок можно свободно перемещать по холсту и соединять с другими блоками — на этом этапе Строфи не проверяет готовность. Ограничение появляется только при попытке запустить генерацию: если такой блок стоит на входе, Строфи считает вход пустым и не даст начать генерацию, пока подготовка не завершится и превью не появится.

На вход генерации по умолчанию попадает не исходный файл, а та самая компактная версия, что показана на холсте, — для большинства моделей этого хватает. Часть моделей, чувствительных к сжатию — например, точечное редактирование или удаление фона, — запрашивает вместо этого настоящий исходник; Строфи учитывает это автоматически, без дополнительных действий с вашей стороны.

Подробнее о том, что ещё можно подавать на вход генерации, — в статье [Что подавать на вход генерации](https://strophe.app/docs/product/generation/inputs-and-references).

---

# Скачивание результатов

> Как скачать один или несколько файлов, пределы пакетного скачивания, отличие копирования в буфер от скачивания и кому принадлежит результат.

Источник: https://strophe.app/docs/product/files/downloading
Обновлено: 2026-08-07

Результат генерации живёт внутри проекта, но иногда файл нужен отдельно: приложить к письму, отдать заказчику, открыть в другой программе. Ниже — как скачать один результат или сразу несколько, что попадает в файл на самом деле и чем скачивание отличается от копирования в буфер обмена.

## Как скачать один файл из блока

У блока изображения или видео с готовым результатом есть кнопка «Скачать» — она появляется в панели над блоком, когда вы его выделяете, и такой же пункт «Скачать» есть в контекстном меню блока по правому клику. У блока с 3D-моделью кнопки на самом блоке нет — скачать её можно только через контекстное меню.

Скачивается всегда исходный файл, а не облегчённая версия, которую Строфи готовит для показа на холсте. Это важно для изображений и видео: на холсте вы видите сжатую копию, а на диск попадает оригинал. У 3D-моделей облегчённой версии нет вовсе — файл на холсте и файл на диске один и тот же. Если у блока в истории несколько результатов, скачивается тот, что сейчас показан на блоке, а не все сразу — чтобы скачать другой вариант, сначала переключитесь на него (подробнее в статье [Результаты и история генераций](https://strophe.app/docs/product/generation/generation-history)).

Изображение сохраняется в исходном формате, если это PNG, JPEG или SVG. Остальные форматы — WebP, HEIC, BMP, GIF — при поштучном скачивании конвертируются в PNG, чтобы файл открывался в любой программе. Это касается в первую очередь загруженных вами файлов: модели каталога отдают результат в PNG или JPEG. У загруженного анимированного GIF при конвертации остаётся только первый кадр; чтобы забрать анимацию целиком, скачивайте его в составе архива (о нём ниже) — там GIF сохраняется как есть.

Если вы сами загрузили файл, а не сгенерировали его, скачивается он под тем именем, с которым был загружен.

## Как скачать сразу несколько файлов и какие есть пределы у пакета

Выделите на холсте два и более блока изображений или видео — в нижней панели инструментов появится кнопка «Скачать» с числом файлов. При наведении на неё Строфи подсвечивает на холсте только те выделенные блоки, что реально попадут в скачивание: пустые блоки, блоки без готового результата и другие типы блоков (текст, 3D-модель) в пакет не входят.

Способ скачивания Строфи выбирает сам, вмешаться в него нельзя. До пяти файлов общим весом меньше 30 МБ скачиваются по одному, один за другим. Как только файлов больше пяти или суммарный вес переваливает за 30 МБ, вместо этого собирается один ZIP-архив, и скачивается уже он.

У пакетного скачивания есть два предела: не больше 50 файлов за один раз и не больше 200 МБ суммарного веса исходных файлов. Если превышен предел по объёму, Строфи показывает точный вес подборки и просит выбрать меньше файлов — ничего при этом не скачивается. Если превышено количество файлов, скачивание тоже не выполняется, но сообщение будет общим, без указания причины: увидев его на большой подборке, снимите часть блоков с выделения и повторите.

Обратите внимание: контекстное меню по правому клику на нескольких выделенных блоках пункта «Скачать» не содержит — пакетное скачивание запускается только кнопкой в нижней панели.

## Как называются скачанные файлы

Файл, сгенерированный AI, получает имя вида `strophe_название-модели_дата_время` — с датой и временем запуска генерации. Загруженный вами файл сохраняет своё исходное имя.

Если в одном архиве двум файлам досталось бы одинаковое имя, Строфи добавляет к имени порядковый номер, чтобы они не перезаписали друг друга. При поштучном скачивании небольшой подборки такой защиты нет: одноимённые файлы попадут в папку загрузок так, как это разрешит браузер.

## Чем копирование в буфер обмена отличается от скачивания

У блока изображения в контекстном меню помимо «Скачать» есть отдельный пункт «Копировать в буфер». Обычно он предлагает два варианта: «Оптимизированное» — та версия, что показана на холсте, и «Оригинал» — исходный файл. Если отдельного оригинала у изображения нет (так бывает, например, у векторных файлов), остаётся один вариант. В отличие от скачивания, ничего не сохраняется на диск: изображение сразу попадает в системный буфер обмена, откуда его можно вставить в другую программу — например, в Figma, документ или чат.

Копирование всегда кладёт в буфер PNG, независимо от исходного формата — так требует буфер обмена браузера. Для видео и 3D-моделей такого пункта нет: их можно только скачать.

## Кому принадлежит результат

Права на то, что вы сгенерировали в Строфи, остаются за вами: результат можно использовать в своей работе, в том числе передавать заказчику. Точные формулировки — в [Условиях использования](https://strophe.app/docs/terms).

## Как скачать генерацию из общего списка «Аналитика»

Полный список генераций (открывается пунктом «Аналитика» в меню аккаунта) тоже даёт скачать результат — действие «Скачать оригинал» есть у каждой строки с изображением или видео. Если строка объединяет сразу несколько результатов одного запуска, одно нажатие скачивает все — по тем же правилам и пределам, что и пакетное скачивание с холста.

Владелец или администратор команды может также скачать результат из строки любого участника, а не только своих генераций.

---

# Проекты

Раздел справки Строфи целиком, статьи в порядке чтения. Источник: https://strophe.app/docs/product/projects

# Проекты и папки

> Как создать, переименовать, продублировать и удалить проект, как разложить проекты по папкам и быстро найти нужный.

Источник: https://strophe.app/docs/product/projects/projects-and-folders
Обновлено: 2026-08-07

Проекты в Строфи хранятся не только на холсте, где вы их редактируете, — у них есть общий список, куда можно вернуться в любой момент. Список принадлежит только вашему аккаунту: даже в [команде](https://strophe.app/docs/product/account/teams) на общем тарифе участники делят с вами кредиты и подписку, но не видят ваш список проектов и не могут переименовать или удалить чужой проект. Ниже — как создавать, переименовывать, дублировать и удалять проекты, а также как раскладывать их по папкам.

## Как открыть список и создать проект

Список проектов открывается кнопкой с названием текущего проекта в левом верхнем углу редактора либо сочетанием `Cmd/Ctrl + P` (остальные сочетания — в статье [Горячие клавиши](https://strophe.app/docs/product/reference/hotkeys)). Внизу списка — кнопка «Создать проект».

При создании проекта Строфи просит ввести название длиной до 32 символов. Если оставить поле пустым, проект получит название «Новый проект». Новый проект открывается с пустым холстом, без единого блока.

Если перед созданием вы уже находились в конкретной папке списка, новый проект попадёт сразу в неё. Если открыт раздел «Все проекты», проект создаётся вне папок.

## Как переименовать проект

Переименовать проект можно двумя способами. В списке проектов — через значок с тремя точками рядом с нужным проектом, пункт «Переименовать». В открытом проекте — через такой же значок в заголовке редактора, рядом с названием проекта.

В обоих случаях открывается окно с полем ввода: название, как и при создании, ограничено 32 символами и не может быть пустым.

## Что происходит при дублировании

Пункт «Дублировать» находится там же, где «Переименовать», — в меню проекта в списке и в меню заголовка редактора. Дублирование создаёт независимый проект: у копии свой идентификатор, и удаление или переименование одного из проектов не затрагивает другой. К названию копии добавляется пометка «(Копия)».

Копируются все блоки в точности такими, какими они были в исходном проекте, включая полную историю генераций каждого блока — не только текущий результат, но и все предыдущие варианты. Файлы при этом не копируются физически: копия ссылается на те же изображения, видео и другие файлы, что и исходный проект.

Если исходный проект лежал в папке, копия окажется в той же папке. Доступ по [публичной ссылке](https://strophe.app/docs/product/projects/sharing) копии не передаётся: даже если исходный проект опубликован, дубликат создаётся закрытым.

## Что происходит при удалении

Пункт «Удалить» в том же меню запрашивает подтверждение во всплывающем окне. Удаление необратимо: восстановить проект после него нельзя, корзины или архива удалённых проектов в Строфи нет.

Если вы удаляете проект, который сейчас открыт, а в списке остаются другие проекты, Строфи переключает вас на один из них. Если удаляемый проект был единственным, вместо него автоматически создаётся новый — пустой.

Если проект был опубликован по ссылке, после удаления ссылка перестаёт работать: она вела на данные, которые исчезли вместе с проектом.

## Как разложить проекты по папкам

Папка создаётся кнопкой «Новая папка» внизу левого меню в списке проектов; название папки — до 24 символов. Вложить папку в папку нельзя — все папки находятся на одном уровне, без вложенности.

Чтобы переместить проект в папку, перетащите его на нужную папку в левом меню. Чтобы убрать проект из папки — перетащите его на «Все проекты» либо выберите «Убрать из папки» в меню самого проекта.

Переименовать или удалить папку можно через значок с тремя точками на самой папке. При удалении папки проекты внутри неё не удаляются: они теряют привязку к папке и возвращаются в общий вид «Все проекты». Порядок папок в левом меню можно менять перетаскиванием.

## Поиск, сортировка и вид списка

Поиск в списке фильтрует проекты только по названию: он не заглядывает внутрь холста и не ищет по содержимому блоков. Поиск не ограничен открытой папкой — он ищет по всем вашим проектам сразу, даже если перед этим вы находились в конкретной папке.

Сортировать список можно тремя способами: «Недавние» — по времени последнего изменения, это порядок по умолчанию; «Сначала новые» — по времени создания; «По названию» — по алфавиту. Выбранные порядок сортировки и вид списка запоминаются в этом браузере и применяются при следующем открытии.

Вид списка переключается между «Сеткой» — плитками с превью содержимого — и «Списком» — компактными строками с той же информацией. Переключатель находится в правом верхнем углу списка проектов.

---

# Автосохранение и синхронизация

> Как правки на холсте попадают на сервер, что означают состояния индикатора синхронизации и в каких случаях изменения можно потерять.

Источник: https://strophe.app/docs/product/projects/autosave-and-sync
Обновлено: 2026-08-07

На холсте Строфи нет кнопки «Сохранить» — любое действие сразу уходит на сервер через отдельный канал связи. Пока соединение работает, вы этого не замечаете. Но если соединение пропадает или вкладку закрывают слишком быстро, часть правок может не сохраниться на сервере.

## Что считается правкой и когда она уходит на сервер

Правкой считается любое действие на холсте: создание и удаление блока, установка и разрыв [соединения](https://strophe.app/docs/product/canvas/connections), перемещение блока, изменение текста или параметров блока. Каждое такое действие Строфи отправляет на сервер сам, без вашего участия.

Скорость отправки зависит от типа действия. Создание, удаление и перемещение блоков, установка и разрыв соединения уходят на сервер практически сразу. Изменения текста и параметров блока Строфи ненадолго придерживает и отправляет через короткую паузу: так правки от быстрого набора текста объединяются в одну отправку вместо запроса на каждую букву. Дольше всего откладывается сохранение позиции и масштаба самого холста — это единственное, что можно немного не успеть сохранить без риска для содержимого проекта.

## Что означают сообщения о синхронизации

Пока идёт активная отправка правок, рядом с названием проекта в верхней части редактора появляется небольшой индикатор загрузки; как только всё отправлено, он пропадает.

Отдельно Строфи короткими уведомлениями сообщает о ситуациях с соединением: о пропавшем подключении к интернету, о его восстановлении, об ошибке синхронизации во время попытки переподключиться и о том, что восстановить соединение не получилось. Это уведомления о процессе — сами по себе они не всегда означают, что что-то потеряно.

Отдельное сообщение — «Изменения не сохранились» — означает именно потерю: часть правок так и не попала на сервер после нескольких попыток. Оно держится на экране дольше остальных и не исчезает при следующей успешной отправке, чтобы вы точно его заметили.

Важная оговорка: это сообщение появляется не при любой потере. Его показывают, когда не дошли действия со структурой проекта — создание, удаление, перемещение блока, соединение. Если же не дошли правки текста, параметров блока или положения холста, Строфи ограничивается обычным сообщением об ошибке соединения, которое ничем не отличается от промежуточных. Поэтому после долгого сбоя связи проект стоит сверить, даже если сообщения о потере не было.

## Что происходит при обрыве связи

Если пропадает интернет, Строфи не блокирует работу: вы продолжаете создавать и двигать блоки как обычно, а неотправленные правки копятся в памяти открытой вкладки. Как только соединение появляется снова, все накопленные правки уходят на сервер сами.

Если отправка не проходит по другой причине — например, временно недоступен сервер, а не интернет, — Строфи повторяет попытку с растущей паузой между повторами. Но попытки переподключиться не бесконечны: если связь долго не восстанавливается, Строфи в какой-то момент перестаёт пытаться сам, и для продолжения работы вкладку нужно перезагрузить.

## Когда правки действительно теряются, и что делать

Очередь неотправленных правок существует только в памяти открытой вкладки — на диск она не сохраняется. Если закрыть вкладку, закрыть браузер или перезагрузить страницу до того, как правки ушли на сервер, они пропадают безвозвратно. При этом браузер не показывает привычное предупреждение «есть несохранённые изменения» — ничего не мешает закрыть вкладку в этот момент.

Второй случай потери — когда Строфи уже несколько раз пытался отправить правки и не смог: тогда она прекращает попытки и отбрасывает их. Часть недавних действий на сервере в этот момент нет, а на холсте они держатся только локально, пока вкладка открыта. О потере структурных действий Строфи сообщит отдельно, о потере правок текста и параметров — нет.

Если соединение пропало, страницу лучше не перезагружать: накопленные правки живут в открытой вкладке и уйдут на сервер сами, как только связь восстановится. Проверьте соединение и дождитесь, пока оно вернётся.

Перезагружать имеет смысл в другом случае: соединение уже в порядке, а сообщение о несохранённых изменениях осталось — значит, Строфи прекратил попытки и правки потеряны. Тогда перезагрузите страницу, посмотрите, в каком состоянии проект сохранён на самом деле, и повторите недостающие действия; общий разбор сбоев собран в статье [Что делать при ошибках](https://strophe.app/docs/product/start/troubleshooting). Полагаться на то, что видно на холсте прямо сейчас, в этот момент не стоит: экран показывает вашу локальную версию, а не обязательно то, что уже сохранено на сервере.

## Работа в нескольких вкладках или на нескольких устройствах

Открыть один и тот же проект в двух вкладках или на двух устройствах одновременно можно — Строфи это не блокирует и не предупреждает, что проект уже открыт где-то ещё.

Правки холста — создание, перемещение, изменение блоков и соединений, — сделанные в одной вкладке, не появляются в реальном времени в другой: чтобы их увидеть, вторую вкладку нужно перезагрузить. Если один и тот же блок в это время редактируют в обоих местах, побеждает изменение, которое дошло до сервера последним, — Строфи не сравнивает версии и не предупреждает о конфликте.

Исключение — генерация: её запуск и результат видны сразу во всех открытых вкладках проекта, для этого работает отдельный канал реального времени. Что при этом происходит с самой задачей, описано в статье [Очередь, ожидание и отмена генерации](https://strophe.app/docs/product/generation/queue-and-status). Если вы работаете над одним проектом в двух местах одновременно, безопаснее не редактировать один и тот же блок параллельно.

## Что будет с результатами генераций, если правки не сохранились

Сами результаты сохранятся. Как только генерация завершается, сервер записывает результат в проект сам, не дожидаясь вашей вкладки: этот шаг не зависит от очереди правок и переживает и потерю соединения, и закрытие вкладки.

Через вкладку проходит только доводка результата — облегчённая версия для холста, размеры и уменьшенная копия для показа. Эти данные идут тем же путём, что и обычные правки, но Строфи относит их к структурным, поэтому при неудаче вы увидите сообщение о несохранённых изменениях, а не тихую потерю; сам результат генерации при этом останется в проекте.

Под риском в такой ситуации остаются другие, не связанные с генерацией правки, которые вы вносили примерно в то же время: перемещение блоков, правка текста, изменение параметров.

---

# Обложка проекта

> Как проект показывается в списке — схемой расположения блоков по умолчанию и изображением, которое вы назначаете обложкой вручную.

Источник: https://strophe.app/docs/product/projects/cover-image
Обновлено: 2026-07-24

Обложка — это изображение, которым проект показывается в общем списке. Когда проектов много, по обложке вы находите нужный глазами, не вчитываясь в названия. Обложка бывает двух видов: схема расположения блоков, которую Строфи собирает сам, и изображение из проекта, которое вы назначаете обложкой вручную.

## Как обложка собирается сама

Пока вы не назначили обложку вручную, проект показывается схемой холста. Это не сами изображения, а расположение блоков: каждый блок рисуется прямоугольником в том месте и того размера, где он стоит на холсте. По такой схеме узнаётся форма проекта — где густо, где пусто, крупные блоки или мелкие.

Схема пересобирается сама, как только меняется состав или расположение блоков: вы добавили блок, передвинули, изменили размер или удалили. Отдельно её обновлять не нужно — она всегда отражает текущий холст.

## Как назначить обложку вручную

Чтобы поставить на обложку конкретное изображение, нажмите правой кнопкой на блок с готовым изображением и выберите «Сделать обложкой». Обложкой становится это изображение, и в списке проект показывается им вместо схемы.

Обложку можно взять с любого блока-изображения в проекте — сгенерированного или загруженного, лишь бы изображение было готово. Любой другой блок — видео, 3D-модель, текст, звук — обложкой сделать нельзя.

Назначенная вручную обложка держится, даже если вы потом двигаете и меняете блоки на холсте. Схема под ней продолжает обновляться, но в списке её не видно, пока стоит ручная обложка.

## Как убрать обложку

Чтобы вернуть проект к автоматической схеме, откройте меню проекта в списке (кнопка с тремя точками на плитке или в строке) и выберите «Убрать обложку». Выбранное изображение снимается, и проект снова показывается схемой холста.

Пункт «Убрать обложку» появляется в меню только у проектов, которым обложка назначена вручную.

## Где обложка видна и что с пустым проектом

Обложка показывается в списке проектов — и в виде плиток, и в виде строк. Управление самим списком описано в статье [Проекты и папки](https://strophe.app/docs/product/projects/projects-and-folders).

У пустого проекта, где ещё нет ни одного блока, обложки нет — на её месте нейтральная плашка. Как только на холсте появляется первый блок, собирается схема, и проект перестаёт выглядеть пустым.

---

# Публичная ссылка на проект

> Как открыть проект по ссылке, что видит и что может делать гость, как разрешить копирование и подпись автора, что показывают счётчики и как закрыть доступ.

Источник: https://strophe.app/docs/product/projects/sharing
Обновлено: 2026-08-19

Публичная ссылка открывает проект человеку без аккаунта в Строфи — заказчику, коллеге, тому, кому вы хотите показать результат. Он смотрит холст прямо в браузере и, если вы это разрешили, может скопировать проект себе, чтобы продолжить работу самостоятельно. Ниже — что именно видно по ссылке, чем управляют настройки показа, что происходит с копией и как закрыть доступ.

## Как включить доступ по ссылке

Доступ настраивается в окне «Поделиться проектом». Оно открывается из меню проекта — значок с тремя точками рядом с названием проекта в заголовке холста, пункт «Поделиться». Тот же пункт есть в меню проекта в общем списке проектов.

Показ включает первый переключатель, «Доступ по ссылке». Как только вы его включаете, Строфи выдаёт проекту адрес и сразу копирует его в буфер обмена. Ниже переключателей появляется поле с самим адресом и кнопка «Скопировать» рядом — скопировать ссылку можно в любой момент, пока показ включён. Тем же занят пункт «Скопировать ссылку» в меню проекта: он появляется рядом с «Поделиться», когда показ включён.

В общем списке ваших проектов проект с включённым доступом по ссылке помечен значком — по нему видно, какие проекты открыты по ссылке.

## Что настраивается в окне показа

Кроме самого доступа окно управляет двумя разрешениями. Каждое из них уезжает на сервер сразу, отдельной кнопки сохранения здесь нет.

| Переключатель           | Что делает                                           | По умолчанию |
| ----------------------- | ---------------------------------------------------- | ------------ |
| «Доступ по ссылке»      | Открывает проект всем, у кого есть адрес             | Выключен     |
| «Разрешить копирование» | Даёт гостю скопировать проект себе                   | Включено     |
| «Показывать авторство»  | Подписывает проект вашим именем или никнеймом с фото | Выключено    |

Оба разрешения показываются, только пока включён сам доступ: у закрытого проекта настраивать нечего.

Подпись автора берётся из профиля: заданное имя, а если его нет — никнейм с собачкой. Строка в окне показывает ровно то, что увидит гость. Если ни имени, ни никнейма нет, переключателя не будет вовсе — вместо него кнопка «Настроить», которая открывает раздел «Профиль» в настройках. Как заполнить профиль — в статье [Настройки](https://strophe.app/docs/product/account/settings).

## Что показывают счётчики

Под ссылкой стоят два числа: сколько раз проект посмотрели и сколько раз его скопировали себе.

Просмотры считаются по людям, а не по открытиям страницы: один и тот же человек за сутки добавляет к счётчику единицу, сколько бы раз он ни обновил вкладку. Ваши собственные заходы и заходы участников вашей команды не считаются — иначе счётчик накручивал бы сам себя. Роботы поисковиков и предпросмотр ссылки в мессенджере тоже не считаются.

Копии считаются по людям точно так же: человек, скопировавший проект трижды, добавляет к счётчику единицу.

## Что видит гость по ссылке

Открыть ссылку может кто угодно — регистрация или вход в Строфи для этого не нужны.

По ссылке открывается весь холст целиком, а не сокращённая версия: тот же набор блоков, их расположение и соединения между ними, что и в проекте у вас. В каждом блоке гость видит тот результат, который показан на нём сейчас, — полосы с историей генераций и панели с настройками в режиме просмотра нет, переключиться на прежние варианты гость не может.

При этом Строфи не вырезает содержимое проекта для гостя: промпты и названия моделей приходят вместе с остальным содержимым. Кнопки с подробностями о генерации и кнопки скачивания файла в режиме просмотра нет, но считать, что промпт скрыт от гостя, не стоит — он станет доступен, как только гость скопирует проект себе.

Если включена подпись авторства, в шапке рядом с кнопкой копирования гость видит ваше фото и подпись; на узком экране она стоит строкой под названием проекта.

## Что гость может делать на холсте, а что нет

Гость видит холст, но не может его редактировать: перетаскивание блоков, создание и разрыв соединений, выделение элементов — всё это в режиме просмотра отключено. Доступны только масштабирование и перемещение по холсту — смотреть можно, менять нельзя.

Запустить генерацию из блока тоже нельзя: в этом режиме для неё нет ни кнопки, ни панели. Чтобы что-то изменить в проекте или сгенерировать заново, его нужно сначала скопировать себе — это единственный способ получить над ним контроль.

## Как гость копирует проект себе

Пока разрешено копирование, в шапке открытой по ссылке страницы у вошедшего гостя есть кнопка «Скопировать проект». После копирования в его собственном списке проектов появляется независимый проект — с закрытым доступом, который можно редактировать как любой обычный проект.

Гость, не вошедший в аккаунт, видит на этом месте кнопку «Войти»: копия создаётся в чьём-то списке проектов, поэтому без аккаунта её сделать не из чего.

Выключенное копирование убирает кнопку, и запретом это и остаётся: скопировать проект не выйдет и в обход интерфейса. Уже сделанные копии выключение не отменяет — они независимы от исходного проекта.

Блоки копии не получают собственных файлов: они ссылаются на изображения и видео, которые хранятся в аккаунте владельца исходного проекта. На работу копии это не влияет — даже если владелец потом удалит свой проект, файлы останутся на месте и копия продолжит открываться как обычно.

О том, как устроено дублирование внутри вашего собственного списка проектов — в статье [Проекты и папки](https://strophe.app/docs/product/projects/projects-and-folders).

## Как закрыть доступ по ссылке

Доступ выключается тем же переключателем «Доступ по ссылке». Как только вы его выключаете, ссылка сразу перестаёт открывать проект — это коснётся даже того, у кого страница уже была открыта: при её обновлении он попадёт на страницу «Страница не найдена».

Адрес закрепляется за проектом навсегда: если вы включите показ заново, ссылка окажется прежней, и разосланная раньше снова заработает. Счётчики просмотров и копий при этом продолжаются с того же места, а не начинаются заново.

На уже сделанные гостями копии выключение и повторное включение доступа не влияют никак: это независимые проекты, и они продолжают существовать и открываться, что бы дальше ни происходило с исходным проектом.

## Спишутся ли ваши кредиты, если гость запустит генерацию

Нет, и не сможет, даже случайно. В режиме просмотра по ссылке нет ни кнопки Сгенерировать, ни панели для запуска генерации — интерфейс их не показывает. Кредиты списываются с баланса того аккаунта, которому принадлежит проект, а гость проектом не владеет, поэтому списывать не с чего.

Единственный способ гостя сгенерировать что-то на основе вашего проекта — сначала скопировать его себе. После этого генерация запускается уже в его собственном проекте и тратит кредиты с его баланса, а не с вашего.

---

# Размер проекта и его пределы

> Что ограничивает размер одного проекта, за счёт чего он растёт со временем и как его уменьшить, если работать стало тяжело.

Источник: https://strophe.app/docs/product/projects/limits
Обновлено: 2026-08-07

По мере работы проект разрастается: в нём накапливаются блоки, соединения и вся история генераций — не только текущий результат каждого блока, но и все предыдущие варианты. Ниже — что при этом упирается в границы, а что нет, и что делать с проектом, который стал слишком большим.

## Есть ли предел числа блоков и соединений

Жёсткого предела, в который вы упрётесь во время работы, нет. Строфи не запретит добавить очередной блок и не покажет сообщение о том, что проект переполнен: блоки и соединения создаются без проверки количества.

Это не значит, что размер не важен. Чем больше блоков и чем длиннее история генераций в них, тем дольше проект открывается и тем тяжелее холст ведёт себя при перемещении и масштабировании. Практическая граница здесь — не число, а ощущение от работы: если проект стал медленно открываться, его пора разгружать.

## За счёт чего растёт вес проекта

Вес самих изображений, видео и 3D-моделей в проект не входит. Файлы Строфи хранит отдельно, а внутри проекта остаётся ссылка на файл и его техническая информация: размеры, уменьшенная копия для показа, длительность для видео. Поэтому даже большая история вариантов у блока с изображениями увеличивает проект незначительно.

Иначе устроен текст. Результат генерации текста хранится в проекте целиком, а не ссылкой. Если в проекте много текстовых блоков с длинными ответами и накопленной историей вариантов, именно они, а не изображения и видео, делают проект тяжёлым.

## Сколько символов допустимо в названии проекта

Название — и при создании, и при переименовании — ограничено 32 символами. Строфи показывает счётчик оставшихся символов прямо в окне ввода, а поле не примет больше ни при наборе, ни при вставке из буфера обмена.

## Сколько может быть проектов и папок

Ограничения на число проектов у аккаунта нет, на число папок — тоже. Папки при этом плоские: вложить одну в другую нельзя, подробнее об этом — в статье [Проекты и папки](https://strophe.app/docs/product/projects/projects-and-folders).

## Как уменьшить проект, если он стал большим

Удалите ненужные блоки. Удаление блока убирает из проекта не только сам блок, но и всю его историю генераций целиком: все прежние варианты результата, а не только текущий.

Если удалять жалко, разведите работу по нескольким проектам: перенесите часть блоков в новый проект копированием и удалите их из исходного. Как переносить блоки между проектами, описано в статье [Копирование и вставка блоков](https://strophe.app/docs/product/canvas/copy-paste).

Дублирование проекта вес не уменьшает: копия получает все блоки и всю историю в точности такими же, как в исходном проекте.

---

# AI-агент

Раздел справки Строфи целиком, статьи в порядке чтения. Источник: https://strophe.app/docs/product/agent

# Что такое агент

> Что такое AI-агент Строфи, где находится панель чата, чем отличаются плавающий и закреплённый режимы и почему диалог свой у каждого проекта.

Источник: https://strophe.app/docs/product/agent/overview
Обновлено: 2026-08-27

Агент — это помощник в чате, который работает на холсте вместо вас. Вы пишете обычными словами, что нужно сделать, — он создаёт и настраивает блоки. Так можно собрать или поправить проект, не расставляя блоки и соединения руками.

## Что он делает

Работает с холстом текущего проекта: создаёт блоки, меняет их настройки и соединяет между собой. Вы описываете задачу — например, «добавь генерацию видео из этой картинки», — а он выполняет её на холсте.

Полный список возможностей и границ — в статье [Что агент умеет](https://strophe.app/docs/product/agent/what-agent-can-do). Если работать нужно с конкретными блоками, их можно выделить и передать в диалог — об этом [Выделение блоков в диалоге с агентом](https://strophe.app/docs/product/agent/selection-context).

## Где найти чат

Панель открывается справа от холста — плавающей кнопкой с иконкой чата в рабочей области или сочетанием `Cmd/Ctrl + /`. Тем же сочетанием закрывается.

Чат открыт на всех тарифах, включая бесплатный. Тарифы различаются не доступом, а потолком расхода — о нём статья [Лимиты расхода и настройки агента](https://strophe.app/docs/product/agent/limits-and-settings).

## Плавающее окно и закреплённая колонка

У панели два режима. По умолчанию это плавающее окно поверх холста: его верхний край можно тянуть, меняя высоту. Второй режим — закреплённая колонка справа во всю высоту экрана; она ужимает холст, освобождая себе место.

Режим переключает кнопка в шапке панели: Закрепить справа у плавающего окна, Открепить у закреплённого. Выбранный режим запоминается и применяется при следующем открытии.

## Почему у каждого проекта свой диалог

Диалог привязан к проекту. Переходите в другой проект — открывается его собственный разговор, а не общий на все сразу. Так ответы касаются того проекта, который у вас открыт, и не путают его с соседним.

История хранится на сервере, поэтому переписка сохраняется между сессиями: вернувшись к проекту позже или с другого устройства, вы увидите её целиком. Как сжать разросшийся диалог или очистить историю — в статье [Контекст диалога, история и оценка ответов](https://strophe.app/docs/product/agent/context-and-history).

## Списываются ли кредиты за чат

Нет. Кредиты уходят только на саму генерацию контента, которую вы запускаете на холсте.

Но переписка не безгранична: у расхода есть суточный и месячный потолок, свой на каждом тарифе. Где его видно и что происходит при исчерпании — в статье [Лимиты расхода и настройки агента](https://strophe.app/docs/product/agent/limits-and-settings).

---

# Что агент умеет

> Что агент делает с холстом по текстовому запросу — создаёт, правит, соединяет и группирует блоки, собирает цепочки, видит изображения — и чего он не делает.

Источник: https://strophe.app/docs/product/agent/what-agent-can-do
Обновлено: 2026-08-27

Вы описываете задачу словами — блоки собираются и настраиваются за вас. Это избавляет от ручной расстановки, когда проект большой или вы ещё не знаете, из каких блоков его составить. Ниже — что делается само и где проходит граница.

## Что делается с блоками

Работа идёт прямо на холсте, а не подсказками, куда нажать. По вашему запросу агент:

- создаёт блоки — текст, стикер, блоки изображения и видео, а также блоки генерации под выбранную модель, в том числе для звука и 3D;
- меняет содержимое блока — текст, тему стикера, настройки блока генерации;
- меняет модель у готового блока генерации, сохраняя его место на холсте; соединения остаются, если новая модель принимает такой же вход, а несовместимые отсоединяются;
- перемещает блоки, в том числе целые группы, и расставляет их так, чтобы они не накладывались друг на друга;
- соединяет блоки между собой и удаляет соединения;
- удаляет и дублирует блоки;
- группирует блоки и разбивает группы обратно;
- выделяет блоки на холсте, когда нужно показать, о каких идёт речь.

Чтобы действовать осмысленно, агент читает холст — что где стоит и какие между блоками соединения, — сверяется с каталогом моделей и подстраивает вид под те блоки, с которыми работает.

Одним запросом собирается и целая цепочка блоков сразу — за это отвечает отдельный навык, о нём [Навыки и слеш-команды](https://strophe.app/docs/product/agent/skills).

## Зрение

Агенту видны и результаты генерации, и загруженные вами изображения; для видео он смотрит на первый кадр. На это он опирается, когда описывает изображение словами, предлагает правку промпта или учитывает уже полученное, прежде чем менять блоки.

Чтобы указать на конкретное изображение, выделите его блок перед сообщением. Как выделение попадает в диалог — в статье [Выделение блоков в диалоге с агентом](https://strophe.app/docs/product/agent/selection-context).

## Как видно, чем он занят

Каждое действие подписывается в ленте диалога короткой строкой — «Создаю блок», «Соединяю блоки». Видно и то, что происходит прямо сейчас, и весь ряд шагов от запроса до результата.

## Чего он не делает

Граница жёсткая: за ней агент не действует, даже если попросить.

Не запускает генерацию. Собирает и настраивает блоки генерации и целые цепочки, но кнопку запуска нажимаете вы — об этом [Как работает генерация](https://strophe.app/docs/product/generation/how-it-works).

Не создаёт, не удаляет и не переключает проекты — работает только внутри открытого.

Не платит, не меняет тариф и не трогает баланс и настройки аккаунта.

За один запрос делается ограниченное число шагов. На очень крупный разовый заказ одного прохода может не хватить — тогда попросите продолжить, и цепочка дойдёт до конца.

---

# Выделение блоков в диалоге с агентом

> Как выделенные на холсте блоки попадают в диалог с агентом, что он о них узнаёт и как понять, о каком блоке идёт речь в его ответе.

Источник: https://strophe.app/docs/product/agent/selection-context
Обновлено: 2026-08-27

Выделение — это способ показать: работай вот с этим. Выделенные на холсте блоки попадают в диалог сами, и описывать их словами не нужно.

## Как выделенные блоки попадают в диалог

Над полем ввода появляются карточки выделенных блоков. У изображения или видео с готовым результатом на карточке миниатюра, у текстового блока, группы и медиа-блока без результата — значок его типа.

Карточек в ряду помещается до семи. Если выделено больше, последняя превращается в счётчик вида «+3» — столько блоков не уместилось в ряд, но в диалог они всё равно уходят.

Крестик на карточке снимает выделение с этого блока. Карточки отражают текущее выделение холста: что вы видите над полем ввода, то и уйдёт в запрос.

## Что агент узнаёт о выделенном блоке

По каждому блоку приходят его тип и содержимое. Для текстового блока это сам текст. Для изображения или видео — само изображение (у видео берётся первый кадр), если результат уже сгенерирован. Если результата ещё нет, приходит пометка, что содержимое не видно, — и агент честно об этом говорит, а не выдумывает.

Снимок выделения фиксируется в момент отправки сообщения: в работу уходит ровно то, что было выделено при нажатии «Отправить». Сменили выделение потом — на уже отправленный запрос это не повлияет.

Зрение как возможность описано в статье [Что агент умеет](https://strophe.app/docs/product/agent/what-agent-can-do).

## Как задать работу с выделением

Выделите один или несколько блоков и напишите запрос обычными словами. О каких блоках речь, понятно по выделению:

- «перепиши промпт в этом блоке короче»
- «опиши, что на этой картинке»
- «свяжи эти два блока»

Правила той модели, которая стоит в блоке, агент знает и пишет промпт под неё: как это устроено — в разделе [Промптинг](https://strophe.app/docs/product/prompting/how-to-write).

## Как понять, о каком блоке идёт речь

В ответе блоки помечены кликабельными метками со значком типа. По метке видно, о каком именно блоке или соединении речь, даже если на холсте их десятки.

Клик по метке центрирует холст на этом блоке, наведение — подсвечивает его, не сдвигая вид.

---

# Навыки и слеш-команды

> Что такое навыки агента и слеш-команды, как вызвать навык вручную и зачем нужны навыки сборки цепочки, написания промпта и работы с Seedance.

Источник: https://strophe.app/docs/product/agent/skills
Обновлено: 2026-08-27

Навыки делают агента точнее в определённом типе задач. Обычно он подбирает нужный навык под запрос сам, но включить навык можно и вручную — слеш-командой.

## Что такое навык

Навык — это заготовленный набор инструкций под конкретный тип задач: порядок шагов, правила, типовые приёмы. Без навыка агент работает по своим общим знаниям, с навыком — по его точным инструкциям.

Поэтому навыки помогают там, где задача сложная и многошаговая, а цена ошибки высокая. Для короткой правки на холсте навык не нужен.

## Два способа включить навык

Первый — агент подключает подходящий навык сам, когда запрос совпадает с тем, для чего навык предназначен. В ленте чата это видно строкой действия «Изучаю навык».

Второй — вы вызываете навык слеш-командой, когда заранее знаете, какой подходит.

## Как вызвать навык слеш-командой

В поле ввода наберите `/` — откроется список доступных навыков с описаниями. По мере набора список сужается до тех, чьё имя начинается с введённых букв.

По списку двигайтесь стрелками `↑` и `↓`. Выбор — `Enter` или `Tab`, закрыть список — `Esc`.

Выбор подставляет в поле команду с именем навыка. Дальше вы дописываете саму задачу обычными словами и отправляете сообщение, как всегда.

## /pipeline-builder

По описанию задачи собирает на холсте целую цепочку разом: блоки с текстом запроса, блоки генерации, места под будущий результат и соединения между ними. Вместо расстановки блоков по одному вся конструкция строится одним действием и сама раскладывается.

Смысл навыка — надёжность: сложную цепочку агент собрал бы и без него, но с большей вероятностью перепутать вход генерации или порядок шагов.

Что за цепочки получаются и как их запускать — в статье [Что агент умеет](https://strophe.app/docs/product/agent/what-agent-can-do).

## /prompt-writer

Навык нужен там, где текст запроса пишется или переписывается всерьёз: с нуля, целиком заново или с перестройкой структуры.

Модели расходятся в том, какой промпт понимают лучше, а написанное уходит к модели дословно. Поэтому навык сначала определяет, какая модель будет выполнять запрос, и только потом пишет текст под неё. На короткой правке готового промпта модель заново не выбирается: правка вносится в том же стиле, в котором промпт уже написан.

Как написать промпт самому — в статье [Из чего состоит хороший промпт](https://strophe.app/docs/product/prompting/how-to-write), а почему один и тот же текст даёт у разных моделей разный результат — в статье [Почему один и тот же промпт работает по-разному](https://strophe.app/docs/product/prompting/model-differences).

## /seedance

Навык покрывает все четыре модели: Seedance 2.0 и 2.5, обычные и Reference.

Отдельный навык нужен потому, что Seedance принимает много материалов сразу — 2.5 до пятидесяти, — и результат зависит от того, насколько точно расписаны их роли, сильнее, чем от красоты описания сцены. Вторая причина — версии расходятся между собой, местами противоположно, и правило одной не переносится на другую.

Про сами модели и их пределы — в статье [Промпт для видео](https://strophe.app/docs/product/prompting/video).

---

# Контекст диалога, история и оценка ответов

> Индикатор заполнения контекста, сжатие и очистка истории диалога с агентом и оценка его ответов.

Источник: https://strophe.app/docs/product/agent/context-and-history
Обновлено: 2026-08-27

Чем дольше идёт разговор, тем больше переписки агент держит одновременно. У этой памяти есть предел, и от того, насколько она заполнена, зависит, сохранится ли нить разговора. Здесь — как следить за заполнением, как сжимать и очищать историю и как оценивать ответы.

## Что показывает индикатор контекста

Слева от кнопки отправки стоит небольшая кнопка с круговым индикатором: он показывает, насколько заполнено окно контекста текущего диалога. Пока места много, кольцо спокойное; ближе к пределу оно подсвечивается жёлтым, у самого предела — красным.

Клик открывает разбивку: из чего сложился контекст. Отдельными строками идут «Инструкции», «Инструменты», «История», а когда они есть — «Выделение» и «Изображения», каждая с примерным размером. Над ними — общая строка заполнения в процентах.

Кольцо и разбивка — только про память диалога, а не про деньги: переписка кредиты не тратит. Сколько её ещё осталось по тарифу, показывают лимиты расхода — о них статья [Лимиты расхода и настройки агента](https://strophe.app/docs/product/agent/limits-and-settings).

## Сжатие истории

Когда контекст подходит к пределу, давняя часть переписки сворачивается в короткую сводку — так разговор продолжается, не теряя сути ранних сообщений. Обычно это происходит само, в начале нового запроса.

Запустить сжатие вручную можно кнопкой Сжать историю в той же разбивке контекста.

Лента переписки на экране при этом не укорачивается — вы по-прежнему видите все сообщения. Сводка влияет на то, что уходит агенту, а не на то, что показано вам.

## Очистка истории

Рядом со «Сжать историю» есть кнопка Очистить историю. Она стирает весь диалог этого проекта — и сами сообщения, и накопленные сводки сжатия, — и спрашивает подтверждение, потому что восстановить переписку нельзя.

## Оценка ответов

Под каждым ответом есть строка действий: ответ можно скопировать целиком, а можно оценить — Хороший ответ или Плохой ответ. Оценки помогают команде Строфи понять, где агент отвечает хорошо, а где ошибается.

---

# Лимиты расхода и настройки агента

> Сколько можно переписываться с агентом на своём тарифе, где видно заполнение лимитов и когда они обновляются, что делать при исчерпании, а также облик агента и собственные инструкции для него.

Источник: https://strophe.app/docs/product/agent/limits-and-settings
Обновлено: 2026-08-27

Переписка не тратит кредиты, но и не бесконечна: у каждого тарифа свой потолок расхода. Здесь — где видно, сколько израсходовано, когда счётчики обнуляются и что ещё настраивается.

## Где смотреть расход

Настройки → раздел «Агент», подраздел «Лимиты расхода». Расход показан двумя полосами:

- **Сегодня** — суточный потолок.
- **В этом периоде** — месячный потолок. Он отсчитывается от даты оплаты подписки: заплатили 20-го — обновится 20-го, а не первого числа.

Каждая полоса показывает процент заполнения и момент обновления — «Сбросится завтра в 03:00» и подобное.

## Что происходит, когда лимит исчерпан

Поле ввода в чате закрывается с подписью «Лимит агента исчерпан», а на экране появляется уведомление с моментом обновления и кнопкой Посмотреть — она ведёт в тот же раздел настроек.

Исчерпать можно любой из двух потолков: суточный обновляется на следующий день, месячный — в конце периода. Дождитесь обновления счётчика или перейдите на тариф с большим потолком; про тарифы — статья [Тарифы и подписка](https://strophe.app/docs/product/account/plans).

Когда месяц заполнен заметно, под полосами появляется блок «Есть куда расти»: он показывает, какую долю следующего тарифа занял бы тот же расход. Это сравнение, а не ограничение.

## Облик и дополнительные инструкции

В том же разделе настроек выбирается, как агент выглядит на холсте: «Утка» или «Робот». Выбор только про внешний вид.

Строка «Дополнительные инструкции» открывает окно, куда можно записать то, что нужно учитывать в каждом диалоге: как оформлять работу, что предполагать по умолчанию, каким тоном отвечать. Например: «я снимаю рекламу косметики, предпочитаю вертикальные кадры 9:16 и мягкий свет».

Длина — до 2000 символов. Инструкции общие для всех проектов и применяются с ближайшего сообщения; диалог при этом не сбрасывается.

---

# Аккаунт и оплата

Раздел справки Строфи целиком, статьи в порядке чтения. Источник: https://strophe.app/docs/product/account

# Вход в аккаунт

> Как войти в Строфи по коду на почту или через Яндекс, почему адрес аккаунта не меняется, как держать два аккаунта и переключаться между ними и как выйти.

Источник: https://strophe.app/docs/product/account/sign-in
Обновлено: 2026-08-07

Вход открывает доступ к вашим [проектам](https://strophe.app/docs/product/projects/projects-and-folders), [кредитам](https://strophe.app/docs/product/account/credits) и истории генераций. Войти в Строфи можно двумя путями: по коду, который приходит на почту, или через аккаунт Яндекса. Пароль заводить не нужно.

## Как войти по коду на почту

Вход по коду проходит в два шага.

На первом шаге введите адрес в поле «Email» и отметьте согласие с лицензионным соглашением и обработкой персональных данных. Пока согласие не отмечено, вход не продолжается. Нажмите «Продолжить».

На почту приходит код из шести цифр. Введите его на шаге «Введите код» в поле «Код из почты». Как только вы вводите шестую цифру, код уходит на проверку автоматически — отдельную кнопку нажимать не нужно. После проверки вы попадаете в рабочую область.

## Что делать, если код не пришёл или истёк

Код действует десять минут. Если он истёк, запросите новый — старый уже не подойдёт.

Повторная отправка открывается через минуту после предыдущей. Кнопка «Отправить код повторно» до этого момента показывает обратный отсчёт, а когда время выйдет — становится активной. Нажмите её, и на почту придёт свежий код.

Если вы ошиблись в адресе или хотите войти под другим, нажмите «Вернуться назад» — это вернёт вас к вводу email.

## Как войти через Яндекс

На странице входа есть кнопка «Войти через Яндекс». Она входит в Строфи через ваш аккаунт Яндекса, без кода на почту.

Как и при входе по коду, сначала нужно отметить согласие с лицензионным соглашением и обработкой персональных данных — без этого вход через Яндекс не продолжается. После нажатия открывается страница Яндекса, где вы подтверждаете вход, и возвращаетесь в рабочую область.

## Можно ли сменить адрес почты у аккаунта

Нет. Адрес задаётся при первом входе и остаётся у аккаунта навсегда: в Строфи нет ни настройки, ни другого способа его поменять. Если адрес нужно сменить — например, вы уходите с рабочей почты на личную, — напишите в поддержку.

Добавление второго аккаунта эту задачу не решает: это отдельный аккаунт со своими проектами, кредитами и [подпиской](https://strophe.app/docs/product/account/plans), а не переименование текущего. Если проекты нужно перенести на другой аккаунт, откройте на них [публичную ссылку](https://strophe.app/docs/product/projects/sharing) и скопируйте их себе, войдя под новым адресом.

## Как держать два аккаунта и переключаться между ними

Строфи держит одновременно не больше двух аккаунтов: к текущему можно добавить один дополнительный. Это удобно, если у вас есть личный и рабочий адреса.

Чтобы добавить второй аккаунт, откройте меню аккаунта в шапке, раскройте строку с вашим адресом почты — она разворачивается по значку рядом — и выберите «Добавить аккаунт». Откроется вход для нового аккаунта по коду на почту.

Переключение между аккаунтами — там же: в развёрнутой строке перечислены оба, выберите нужный, и Строфи перезагрузит рабочую область под него.

Если оба места уже заняты и вы пытаетесь добавить ещё один, Строфи покажет сообщение «Можно добавить только один дополнительный аккаунт».

## Как выйти из аккаунта

Откройте меню аккаунта в шапке и выберите «Выйти». Строфи попросит подтверждение: в окне «Выход из аккаунта» с вопросом «Вы действительно хотите выйти из аккаунта?» нажмите «Выйти», чтобы завершить вход, или «Отмена», чтобы остаться.

Выход касается активного аккаунта. Если у вас добавлен второй, Строфи переключит вас на него и оставит в рабочей области. Если аккаунт был единственным, откроется страница входа.

---

# Кредиты и их списание

> Три вида кредитов, порядок их списания, что происходит с ними при продлении подписки и как поступить, если кредитов не хватает для генерации.

Источник: https://strophe.app/docs/product/account/credits
Обновлено: 2026-08-07

Кредиты — валюта, которой в Строфи оплачивается генерация текста, изображения, видео, звука и 3D-модели. Баланс складывается из нескольких источников с разными правилами, и то, что происходит с кредитами до, во время и после генерации, не всегда очевидно. Разбираемся, как это устроено и что делать, если кредитов не хватает.

## Какие бывают кредиты и в каком порядке они списываются

Баланс в Строфи состоит из трёх источников:

- подписочные — начисляются на весь период вместе с активной подпиской;
- дополнительные — куплены отдельным пакетом, без срока действия;
- бонусные — начислены, например, по реферальной программе, тоже без срока действия.

Строфи списывает их в фиксированном порядке: сначала подписочные, затем дополнительные, и только когда оба источника обнулились — бонусные. Кредиты с ограниченным сроком действия тратятся первыми, а дополнительные и бонусные остаются про запас на будущее.

## Почему во время генерации доступный баланс может быть меньше показанного

Когда вы запускаете генерацию, Строфи сначала резервирует нужное количество кредитов — временно закрепляет их за этой задачей, а не списывает сразу. Если генерация завершается успешно, резерв подтверждается и кредиты списываются окончательно. Если она не удалась — ошибка сервиса, отмена, зависшая задача, — резерв автоматически снимается, и кредиты возвращаются в доступный баланс полностью, будто их и не трогали.

Пока задача выполняется, зарезервированные кредиты недоступны для новой генерации. Если запустить несколько генераций подряд, часть уже показанного баланса на время может оказаться недоступной — пока хотя бы одна из них не завершится.

Исключение — [генерация текста](https://strophe.app/docs/product/generation/text-generation): она не резервирует кредиты заранее. Её стоимость зависит от объёма фактически сгенерированного текста и списывается уже после того, как ответ получен.

## Что происходит с подписочными кредитами при продлении и смене тарифа

При продлении подписки — по расписанию или вручную — неиспользованный остаток подписочных кредитов сгорает и не переходит на новый период. Взамен начисляется полный объём кредитов, положенный по тарифу на новый период.

При смене тарифа — переходе на другой план прямо во время действия текущей подписки — поведение другое: новый объём кредитов добавляется к тому, что уже есть на балансе, а не заменяет его. Период подписки при этом сразу начинается заново — с момента смены тарифа.

Дополнительные и бонусные кредиты этих изменений не касаются: они не сгорают и переживают и продление, и смену тарифа, и даже отмену подписки.

## Где видно стоимость генерации до запуска

Строфи показывает стоимость в кредитах прямо в блоке генерации — до того, как вы запустили генерацию. Цена пересчитывается автоматически при смене модели или [параметров](https://strophe.app/docs/product/generation/parameters): разрешения, длительности, числа кадров и других настроек, влияющих на объём работы модели.

Показана полная сумма списания, а не цена одной генерации. Блок с несколькими блоками на выходе запускает по генерации на каждый из них, и цена учитывает их число: у блока за 8 кредитов с тремя блоками на выходе будет показано 24. Подробнее — в статье [Как работает генерация](https://strophe.app/docs/product/generation/how-it-works).

Два исключения, когда цену нельзя показать заранее. Генерация текста: её стоимость зависит от того, сколько текста в итоге вернёт модель, поэтому сумма определяется и списывается только после того, как ответ получен. Видео-модели с оплатой за секунду: пока к блоку не подключено входное видео, длительность результата неизвестна, и вместо стоимости показан тариф за секунду.

## Что делать, если кредитов не хватает

Если баланса недостаточно для генерации, Строфи не запускает задачу и сообщает об этом: для личного аккаунта — предложением пополнить баланс или оформить подписку. То же происходит, если выбранная модель доступна только по подписке или только на плане «Команда», — Строфи покажет, чего не хватает, ещё до попытки списания. Что даёт каждый план, перечислено в статье [Тарифы и подписка](https://strophe.app/docs/product/account/plans).

Купить пакет дополнительных кредитов можно только при активной подписке. Без подписки доступно оформление самой подписки — она сразу начисляет подписочные кредиты.

Участники [команды](https://strophe.app/docs/product/account/teams) не покупают кредиты и подписку лично — расходы команды идут отдельным договором через владельца. Если у команды закончились кредиты, участнику предлагают обратиться к администратору команды, а владельцу — в Строфи, чтобы пополнить общий пул.

---

# Тарифы и подписка

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

Источник: https://strophe.app/docs/product/account/plans
Обновлено: 2026-07-24

Тариф определяет, какие модели вам доступны и сколько кредитов приходит каждый месяц. Кредиты списываются за каждую генерацию, а от плана зависит и набор моделей: часть из них работает только по подписке.

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

## Какие есть тарифы

В Строфи четыре тарифа.

«Бесплатный» — стартовый тариф без оплаты. Даёт 100 стартовых кредитов и ограниченный набор моделей, чтобы попробовать генерацию.

«Базовый» — 1190 ₽ в месяц, 1000 кредитов ежемесячно и доступ ко всем моделям, кроме тех, что открыты только на тарифе «Команда».

«Про» — 4990 ₽ в месяц, 5000 кредитов ежемесячно. Подходит, когда вы работаете с генерацией каждый день и объёма «Базового» не хватает.

«Команда» — тариф для организаций от 5 человек на индивидуальных условиях. Его не оформляют самостоятельно: нажмите «Связаться», и команда Строфи подберёт условия.

Часть моделей доступна только при активной подписке, отдельные — только на тарифе «Команда». Какие именно — видно в каталоге моделей: недоступные для вашего тарифа помечены и стоят в конце списка.

## Как докупить кредиты

Когда кредиты кончаются до конца месяца, их можно докупить пакетом. Пакеты доступны только при активной подписке — на бесплатном тарифе их нет.

| Пакет          | Кредиты | Цена   |
| -------------- | ------- | ------ |
| «Стартовый»    | 500     | 750 ₽  |
| «Стандартный»  | 1000    | 1400 ₽ |
| «Расширенный»  | 1500    | 1950 ₽ |
| «Максимальный» | 3000    | 3600 ₽ |

Докупленные кредиты не сгорают в конце срока подписки — они остаются на балансе, пока вы их не потратите.

## Как сменить тариф

Тариф меняют в разделе подписки.

С «Базового» на «Про» — кнопка «Перейти на Про». Обратно, с «Про» на «Базовый», — кнопка «Сменить план».

При смене новый объём кредитов добавляется к текущему балансу, а срок подписки отсчитывается заново от даты смены. Как это влияет на баланс и списание — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

## Как отменить и возобновить подписку

Чтобы отключить автопродление, нажмите «Отменить подписку». Доступ и кредиты сохранятся до конца оплаченного периода — подписка не прервётся сразу.

Вернуть подписку можно кнопкой «Возобновить». Если подписка ещё действует, кнопка снова включит автопродление. Если срок уже закончился, «Возобновить» оформит оплату и вернёт доступ. Как проходит оплата — в статье [Оплата](https://strophe.app/docs/product/account/payments).

---

# Оплата

> Чем оплачивается подписка и кредиты в Строфи, где взять чек, как сменить карту, что происходит при неудачном платеже и как оформить возврат.

Источник: https://strophe.app/docs/product/account/payments
Обновлено: 2026-08-07

Оплата в Строфи держится на одной банковской карте, привязанной к вашему аккаунту: с неё списывается подписка, с неё же оплачиваются докупленные кредиты, смена плана и подарки. Эта статья — про саму механику оплаты: чем вы платите, где взять чек, как сменить карту, что происходит при неудачном списании и как вернуть деньги. Про состав тарифов — в статье [Тарифы и подписка](https://strophe.app/docs/product/account/plans), про виды кредитов и их списание — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

## Чем вы платите

Оплата проходит банковской картой через Т-Банк. В форме оплаты этот способ так и называется — «Т-Банк», с пометкой «Карта РФ».

Перед первой оплатой вы принимаете соглашение об использовании платной подписки и даёте согласие на сохранение данных карты для будущих списаний. Согласие нужно, чтобы подписка продлевалась автоматически и чтобы кредиты можно было докупать без повторного ввода реквизитов.

После подтверждения Строфи перенаправляет вас на форму оплаты Т-Банка. Реквизиты карты вы вводите там, а не в самом приложении.

## Где взять чек

После каждой успешной оплаты Т-Банк формирует фискальный чек и отправляет его на почту вашего аккаунта — тот адрес, под которым вы вошли в Строфи.

Отдельной кнопки, чтобы скачать чек, в приложении нет: чек приходит письмом. Если письмо не пришло, проверьте папку со спамом и убедитесь, что почта аккаунта указана верно.

## Как сменить карту

Сменить карту, с которой идут списания, можно в разделе с подпиской — кнопкой «Сменить карту».

Чтобы подтвердить, что новая карта рабочая, с неё списывается 1 ₽. После проверки карта привязывается, и все следующие списания идут уже с неё.

## Что происходит, если платёж не прошёл

Если автопродление не прошло — например, на карте не хватило средств, — подписка получает статус «Проблема с оплатой», а Строфи начинает повторять списание. Попыток до трёх, примерно раз в сутки.

Ждать автоматических повторов не обязательно. В разделе с подпиской появляется кнопка «Оплатить сейчас» — она пробует списание сразу.

Рядом с подпиской показываются подсказки о том, что делать:

- «На карте не хватило средств. Пополните или смените карту» — пополните счёт либо привяжите другую карту.
- «Следующая попытка …. Пополните карту или привяжите другую» — когда назначено следующее автоматическое списание.
- «Последний раз тоже не вышло. Без новой карты подписка отменится» — это была последняя попытка. Если карту не сменить, подписка отменяется.

## История платежей

Все операции собраны в разделе «История платежей». По каждой строке видно дату, сумму, статус и тип операции.

Статусы бывают четырёх видов: «Успешно», «Ошибка», «Отменён», «Возвращён».

Тип показывает, за что была операция, — например «Подписка», «Автопродление», «Покупка кредитов», «Смена карты», «Повышение плана», «Понижение плана», «Активация подарка», «Покупка подарка» или «Возврат».

## Как вернуть деньги

Кнопки возврата в Строфи нет. Если нужен возврат, напишите в поддержку. После того как возврат проведён, он появляется в истории платежей строкой со статусом «Возвращён».

Вернуть можно только неизрасходованное: за кредиты, которые уже потрачены на генерации, деньги не возвращаются — оплата ушла сервисам генерации в момент запуска.

---

# Промокоды и подарочные подписки

> Как применить промокод в Строфи и как подарить подписку другому человеку или активировать полученный подарок.

Источник: https://strophe.app/docs/product/account/promo-and-gifts
Обновлено: 2026-07-24

Промокод даёт скидку на подписку или на покупку кредитов. Подарочная подписка — это способ оплатить доступ к Строфи другому человеку или получить такой доступ от кого-то. И промокод, и подарочный код вводятся в одном и том же окне, поэтому обе темы собраны здесь.

## Как применить промокод

Промокод вводится на экране оформления подписки. Там есть ссылка «Есть промокод или подарок?» — она открывает окно «Активация кода».

В окне одно поле, подписанное «Промокод или подарочный код», и кнопка «Активировать». Введите код и нажмите кнопку.

Если у вас уже есть действующая подписка, поле подписано иначе — «Введите промокод». В этом случае активировать через него можно только промокод: подарочную подписку поверх действующей Строфи не примет.

Когда промокод принят, вы видите строку «Промокод … применён» — с самим кодом. Если код даёт скидку, появляется сообщение вида «Промокод применён! Скидка N%», и цена в окне оплаты пересчитывается. Отменить применённый промокод можно кнопкой «Отменить» рядом с этой строкой.

Если код не подошёл, Строфи покажет причину: код не найден, не работает, не подходит к этой покупке или уже был использован.

## Как подарить подписку

Кнопка «Подарить подписку» открывает окно оформления подарка. Подарить можно тариф «Базовый» или «Про» — тариф «Команда» в подарок не оформляется.

В окне вы выбираете план и указываете email получателя. Под полем адреса Строфи напоминает: «На него будет отправлен подарочный код и инструкция по активации». Дальше идёт подтверждение и переход к оплате — как проходит сама оплата, описано в статье [Оплата](https://strophe.app/docs/product/account/payments).

После оплаты получателю на почту приходит письмо с подарочным кодом и инструкцией по активации. Код можно и скопировать прямо на экране успешной оплаты, чтобы передать человеку самому — на случай, если письмо не дойдёт.

Состав тарифов «Базовый» и «Про» описан в статье [Тарифы и подписка](https://strophe.app/docs/product/account/plans).

## Как активировать подарок

Получатель активирует подарок тем же путём, что и промокод: открывает окно «Активация кода» через ссылку «Есть промокод или подарок?», вводит подарочный код и нажимает «Активировать». Подписка включается сразу.

У подарочного кода есть срок — 180 дней с момента покупки. Если за это время его не активировать, код сгорает, и подписку по нему уже не включить.

Подарок нельзя активировать поверх действующей подписки. Если она у вас уже есть, Строфи ответит: «У вас уже есть подписка — подарочную активировать нельзя». Дождитесь окончания текущей подписки или используйте код на другом аккаунте.

Подарочная подписка помечается в интерфейсе словом «Подарок». Когда её срок заканчивается, продлить её нельзя — Строфи предложит оформить обычную подписку: «Подарочную подписку нельзя возобновить — оформите новую подписку».

---

# Приглашение друзей

> Как работает реферальная программа Строфи — где взять ссылку-приглашение, что получает приглашённый, когда приходят бонусные кредиты и в каких случаях приглашение не засчитается.

Источник: https://strophe.app/docs/product/account/referrals
Обновлено: 2026-08-26

У каждого аккаунта в Строфи есть своя ссылка-приглашение. Тот, кто пришёл по ней, получает скидку на первую подписку, а вы — бонусные кредиты, когда он её оплатит. Программа живёт в окне оплаты, отдельно включать её не нужно.

## Где взять ссылку

Откройте окно оплаты и найдите раздел «Приглашайте друзей» — там лежит адрес вида `strophe.app/?ref=КОД` и кнопка «Скопировать». Человек переходит по ссылке, регистрируется, и скидка подставится сама, когда он будет оплачивать первую подписку.

Кнопка «Как это работает» открывает окно с действующими условиями: размер скидки и количество кредитов зависят от тарифа, который выберет приглашённый, поэтому точные значения всегда смотрите там — они могут меняться.

Там же лежит семизначный код — та же часть, что стоит в конце ссылки. Он нужен, если ссылка не сыграла: приглашённый открыл её на телефоне, а платит с компьютера, или чистит cookie. Такой код вводится вручную в окне «Активация кода» при оплате подписки.

## Когда приходят кредиты

Кредиты начисляются не в момент перехода по ссылке и не после регистрации, а только когда приглашённый оплатил подписку. До этого момента приглашение нигде не отображается — Строфи не показывает, что кто-то перешёл по ссылке, но ещё не заплатил.

Бонусные кредиты попадают на ваш баланс отдельным видом: они не сгорают и тратятся последними, после подписочных и дополнительных. Подробнее об этом — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

Каждое начисление видно в окне оплаты, в «Истории операций»: строка стоит вместе с платежами и показывает почту приглашённого частично скрытой.

Начисление приходит один раз за каждого приглашённого — за его первую оплаченную подписку. Продления подписки приглашённого новых кредитов не приносят.

## Когда код не сработает

Код рассчитан на новых пользователей, поэтому он не применится в нескольких случаях:

- приглашённый уже платил в Строфи: покупал кредиты, оформлял подписку или подписан сейчас;
- человек пытается применить собственный код;
- код используется на покупку кредитов, а не подписки — скидка действует только на подписку;
- Строфи распознал попытку накрутки: если приглашённый заходит с того же устройства или адреса, что и владелец кода, приглашение не засчитывается.

Ссылка помнит код 30 дней. Если приглашённый перешёл по ней, но оформил подписку позже — в пределах этого срока скидка всё равно применится. Если за это время он перешёл по чужой ссылке ещё раз, засчитается та, по которой он пришёл первым.

Число приглашённых не ограничено: сколько человек оплатит подписку по вашему коду, столько начислений вы и получите.

---

# Команда

> Как устроен командный тариф Строфи — роли, добавление участников, лимиты кредитов на участника и общий баланс команды.

Источник: https://strophe.app/docs/product/account/teams
Обновлено: 2026-08-13

Командный тариф объединяет несколько человек под одним балансом кредитов. Договор один, пул общий на всех, а расход каждого участника виден владельцу и администратору команды, и его можно ограничить. Такой формат нужен организациям, где над проектами работает группа людей, а оплата идёт централизованно.

## Что такое команда и как её подключить

Команда — это корпоративный тариф «Команда» с общим балансом кредитов на всех участников. Генерации всех членов команды списываются из этого баланса.

Подключить команду кнопкой в приложении нельзя: в окне тарифов карточка «Команда» ведёт не к оплате, а к кнопке «Связаться». Состав команды и её баланс настраивает Строфи при заключении договора.

Условия оформления описаны в статье [Тарифы и подписка](https://strophe.app/docs/product/account/plans).

## Роли участников

В команде три роли: «Владелец», «Админ» и «Участник».

«Владелец» — тот, на кого оформлен договор. Он распоряжается балансом и составом команды. Владельца нельзя удалить из команды, но он может передать свою роль другому участнику — действием «Передать владение». После передачи бывший владелец становится админом.

«Админ» помогает управлять командой — добавляет и удаляет людей, настраивает лимиты. «Участник» — рядовой член команды, который генерирует за счёт общего баланса (в рамках лимита, если администратор его задал).

Роль участника можно повысить — «Назначить админом» — и вернуть обратно — «Снять админа». Это делают владелец и админ. Передать владение может только текущий владелец.

## Как добавить или удалить участника

Новых людей добавляют кнопкой «Добавить участника». В открывшемся окне вводят email человека.

Это не приглашение постороннего по ссылке. Добавить можно только того, у кого уже есть аккаунт в Строфи — на это указывает подсказка в окне: «Введите email пользователя, который зарегистрирован в Строфи». Новый человек входит в команду с ролью «Участник».

Добавлять и удалять участников могут владелец и админ. Удаление скрыто за действием «Удалить из команды» и требует подтверждения.

## Лимиты кредитов и общий баланс

У команды один общий пул — «Общий баланс команды» (или «Безлимит на команду», если пул не ограничен). Любая генерация участника списывается из этого пула.

Чтобы один человек не израсходовал весь баланс, ему задают «Лимит на месяц» — сколько кредитов он может потратить за календарный месяц. Лимиты настраивают владелец и админ; рядовой участник свой лимит не меняет. Пустое значение означает работу без ограничения: в окне об этом сказано «Оставьте пустым для безлимита», а в таблице такой участник помечен как «Безлимит». Сколько кто потратил за месяц, видно в столбце «Использовано».

Личный лимит не открывает отдельного кошелька: даже в его пределах участник не потратит больше, чем осталось на общем балансе команды.

Участник не покупает подписку и кредиты лично — расходы идут через владельца по договору. Про виды кредитов и порядок списания — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

Когда баланс команды заканчивается или истекает срок договора, участники видят предложение обратиться к администратору команды. За пополнением баланса и продлением договора владелец обращается в Строфи.

## Что будет, если добавить человека с личной подпиской

Членство в команде перекрывает личный баланс. Пока человек в команде, его генерации списываются из пула команды, а личные кредиты — и купленные, и начисленные подпиской — остаются нетронутыми и не расходуются. Когда срок договора команды истекает, доступные кредиты обнуляются, даже если на личном счёте что-то есть.

Личную подписку команда при этом не отменяет и о ней не знает: она продолжает продлеваться и списывать деньги с карты в обычном порядке. Если человек переходит на командный тариф надолго, подписку имеет смысл отменить самому — как это сделать, описано в статье [Тарифы и подписка](https://strophe.app/docs/product/account/plans).

Из этого правила есть одно исключение — личный безлимитный доступ. Он сильнее команды: такой аккаунт генерирует по своему безлимиту, а пул команды не трогает.

---

# Настройки

> Что настраивается в Строфи — имя, никнейм и фото профиля, тема оформления, способ управления холстом, сетка, направляющие, миникарта, проверка орфографии и экспериментальные функции.

Источник: https://strophe.app/docs/product/account/settings
Обновлено: 2026-08-19

В настройках собрано всё, что отвечает за ваш профиль и за поведение интерфейса Строфи: имя и фото, оформление, способ навигации по холсту и вспомогательные слои. Здесь же находятся экспериментальные функции, которые ещё проходят обкатку. Оплата, тарифы и кредиты вынесены в отдельные разделы — их в этом окне нет.

## Где открываются настройки

Настройки открываются из меню аккаунта пунктом «Настройки». Появляется окно с заголовком «Настройки», слева в нём разделы: «Основные», «Профиль» и «Эксперименты».

Раздел переключается щелчком по его названию, содержимое меняется справа. В «Основных» и «Экспериментах» кнопки сохранения нет — изменение применяется сразу; в «Профиле» имя и никнейм сохраняются кнопкой, а фото — сразу после выбора файла.

## Что настраивается в разделе «Основные»

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

| Настройка             | Что переключает                                           | По умолчанию |
| --------------------- | --------------------------------------------------------- | ------------ |
| «Тема»                | Цветовую схему интерфейса: «Авто», «Светлая» или «Тёмная» | «Авто»       |
| «Язык»                | Язык интерфейса: «Русский» или «English»                  | «Русский»    |
| «Управление»          | Способ перемещения по проекту: «Мышь» или «Трекпад»       | «Трекпад»    |
| «Сетка»               | Привязку и отображение сетки на холсте                    | Включена     |
| «Направляющие»        | Магнитную привязку к соседним блокам                      | Включены     |
| «Проверка орфографии» | Подчёркивание опечаток в текстах и промптах               | Включена     |
| «Миникарта»           | Отображение миникарты для навигации по проекту            | Включена     |

При теме «Авто» оформление следует за системным: тёмное у тех, у кого тёмная тема в системе, светлое — у остальных.

Пункт «Язык» доступен у части аккаунтов. Если его в разделе нет — язык у вас пока не переключается из настроек.

## Как работает проверка орфографии

Опечатки подчёркивает браузер — теми же словарями, которыми проверяет текст на любом другом сайте. Поэтому двуязычный текст проверяется по всем языкам, которые включены словарями в браузере, а установить или убрать словарь можно только в его настройках.

Подчёркивания появляются в стикерах, текстовых блоках и полях промпта. В стикере и текстовом блоке они видны, пока текст открыт на редактирование: на холсте с закрытым текстом подчёркиваний нет, чтобы проект не рябил красным.

Чтобы исправить слово, щёлкните по подчёркнутому правой кнопкой — откроется меню браузера с вариантами замены и пунктом добавления слова в словарь. Пока проверка включена, в редактируемом тексте правая кнопка вызывает именно это меню, а не меню блока: чтобы попасть в меню блока, закройте редактирование или щёлкните по блоку вне текста.

Выключенная настройка убирает подчёркивания и в текстах, и в промптах, а правой кнопке возвращает меню блока.

## Что настраивается в разделе «Профиль»

Профиль отвечает за то, как вас видят другие: в меню аккаунта, в списке участников команды и подписью автора на проекте, которым вы поделились по ссылке.

| Поле      | Что задаёт                                        |
| --------- | ------------------------------------------------- |
| «Имя»     | Как вас называть. До 64 символов, на любом языке  |
| «Никнейм» | Короткое имя латиницей, уникальное на весь сервис |
| Фото      | Картинку вместо буквы-заглушки                    |

Никнейм состоит из латинских букв и цифр, между ними может стоять точка или подчёркивание, всего от 3 до 30 символов. Занятый кем-то никнейм поле подсветит, пока вы печатаете, ещё до сохранения. Написание сохраняется таким, каким вы его задали, но два никнейма, различающиеся только регистром, считаются одним.

Заданный никнейм можно сменить, но не убрать: по нему вас узнают там, куда ссылка уже разошлась. Прежний никнейм после смены остаётся за вами — занять его никто другой не сможет, а вы в любой момент вернётесь к нему обратно.

Фото загружается кнопкой «Загрузить фото»: подойдёт JPEG, PNG или WebP до 8 МБ, лучше всего — квадратное от 512 px по стороне. Неквадратное обрежется по центру, слишком большое уменьшится. Кнопка «Удалить» возвращает букву-заглушку: её берут от имени, а если имя не задано — от никнейма или адреса почты.

Ни одно поле профиля заполнять не обязательно. Незаполненный профиль показывается адресом почты — но только вам и вашей команде: наружу почта не уходит. Поэтому проект, которым вы поделились по ссылке, подписать нечем, пока не задано имя или никнейм: подпись берёт имя, а если его нет — никнейм с собачкой, например `@ilya`. Как включить подпись — в статье [Публичная ссылка на проект](https://strophe.app/docs/product/projects/sharing).

## Что настраивается в разделе «Эксперименты»

Раздел «Эксперименты» собирает функции, которые ещё дорабатываются. Каждую из них вы включаете и выключаете сами.

«Индикация прогресса» показывает на блоке во время генерации таймер обратного отсчёта и ход выполнения. По умолчанию выключена. Как это выглядит, пока блок считается, — в статье [Очередь, ожидание и отмена генерации](https://strophe.app/docs/product/generation/queue-and-status).

Индикацию прогресса видит каждый, поэтому раздел «Эксперименты» есть у всех аккаунтов.

---

# Интеграции

Раздел справки Строфи целиком, статьи в порядке чтения. Источник: https://strophe.app/docs/product/integrations

# Подключение по MCP

> Что даёт подключение внешнего AI-агента к генерации Строфи по протоколу MCP — для кого оно, на чьи кредиты работает и чем отличается от встроенного агента редактора.

Источник: https://strophe.app/docs/product/integrations/overview
Обновлено: 2026-08-27

MCP (Model Context Protocol) — способ подключить внешнего AI-агента к генерации Строфи. Claude, ChatGPT и им подобные получают доступ к тем же моделям, что и редактор, и запускают генерацию по вашей просьбе прямо в переписке — не открывая холст. Готовый результат приходит файлом.

## Для кого это

Подключение работает на платных тарифах. Доступ есть, если у вас активная подписка (в том числе отменённая, но ещё оплаченная до конца периода, и подарочная), вы состоите в непросроченной команде или вам выдан персональный безлимит. Как устроены тарифы и подписка — в статье [Тарифы и подписка](https://strophe.app/docs/product/account/plans).

## На чьи кредиты работает

Каждая генерация списывает кредиты с вашего баланса — ровно так же, как если бы вы запустили её сами в редакторе. Подробнее о списании — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

Подключённому приложению вы разрешаете тратить ваши кредиты от вашего имени, поэтому подключайте только те, которым доверяете; как выдать и отозвать доступ — в статье [Как подключить агента](https://strophe.app/docs/product/integrations/connect).

## Что можно генерировать

Изображения, видео, звук и 3D — те же типы, что и на холсте. Полный перечень возможностей и границ — в статье [Что агент умеет через MCP](https://strophe.app/docs/product/integrations/capabilities).

## Где видно эти генерации

Запуски из MCP не появляются в проектах и ни к каким блокам не привязаны. Но они попадают в общий список ваших генераций — раздел «Аналитика» в меню профиля — с пометкой «Через MCP», чтобы отличать их от запусков с холста. Оттуда результат можно скачать и посмотреть, какой моделью и с какими параметрами он сделан. Как устроен этот список — в статье [Результаты и история генераций](https://strophe.app/docs/product/generation/generation-history).

## Чем это отличается от программного доступа

MCP рассчитан на готового агента: он читает описания моделей словами и решает сам. Если генерацию запускает ваша собственная программа, ей удобнее REST API — тот же каталог и тот же счёт, но машинным JSON и с кодами вместо объяснений. Он описан в разделе [Разработчикам](https://strophe.app/docs/product/developers/overview) и открыт участникам команды.

## Чем это отличается от встроенного агента

В редакторе есть свой AI-агент: он собирает блоки и цепочки прямо на холсте и работает внутри проекта — про него отдельная статья [AI-агент в редакторе](https://strophe.app/docs/product/agent/overview). По MCP подключается внешнее приложение, для которого Строфи — источник генерации: холст оно не редактирует и проект не ведёт, а только запускает генерацию и забирает результат.

---

# Как подключить агента

> Три способа дать внешнему AI-агенту доступ к генерации Строфи — попросить его самого, добавить адрес сервера в настройках агента или выпустить API-токен — и как отозвать доступ.

Источник: https://strophe.app/docs/product/integrations/connect
Обновлено: 2026-08-27

Адрес сервера один на всех: `https://strophe.app/api/mcp`. Различается только то, как этот адрес попадёт в ваше приложение.

## Попросить самого агента

У разных приложений подключение устроено по-своему, но выяснять это не обязательно: современный агент разбирается сам. Скопируйте текст ниже и отправьте ему.

```
Добавь MCP-сервер Строфи: https://strophe.app/api/mcp
Через него ты сможешь генерировать изображения, видео, звук и 3D-модели.
Если добавить сервер сам не умеешь — подскажи, где это включается у тебя.
Когда подключишься, покажи каталог: что в нём есть и от скольки кредитов.
Запускать пока ничего не надо.
```

Дальше он либо добавит сервер сам, либо продиктует шаги для своего интерфейса. При первом обращении откроется страница Строфи с запросом доступа — её нужно подтвердить.

## Добавить адрес сервера вручную

Так подключаются приложения, которые умеют добавлять внешние сервисы, но не станут делать это по просьбе.

1. Найдите в настройках приложения добавление внешнего сервиса. Называется оно везде по-разному — ищите разделы «Плагины», «Коннекторы» или «MCP».
2. Название задайте любое, а адресом сервера укажите `https://strophe.app/api/mcp`. Дополнительные поля, если приложение их спрашивает, оставьте пустыми.
3. Откроется страница Строфи с запросом доступа: на ней видно, какое приложение подключается и что оно запрашивает — генерацию от вашего имени и списание кредитов с вашего баланса. Нажмите «Разрешить».
4. После согласия приложение вернётся к себе и будет готово запускать генерацию.

Подключённое приложение появляется в настройках, в разделе «Интеграции» → «Подключённые приложения», с датой подключения. Кнопка «Отключить» рядом с ним мгновенно закрывает доступ.

## Выпустить API-токен

Так подключаются клиенты, которые не умеют подтверждать доступ в браузере и ждут готовый ключ.

1. Откройте настройки → «Интеграции» → «API-токены» и нажмите «Добавить».
2. Задайте название, отметьте право «MCP» и, если нужно, поставьте потолки трат — в сутки и на одну генерацию. Потолки ограничивают токен, а не весь баланс.
3. Секрет показывается один раз — скопируйте и сохраните его сразу. Позже увидеть его снова нельзя.
4. В своём клиенте укажите адрес сервера `https://strophe.app/api/mcp` и вставьте токен как ключ доступа.

Список выпущенных токенов лежит там же: у каждого видно права, потраченное за сутки, дату последнего использования и срок. Права и потолки меняются кнопкой «Изменить права». Кнопка «Отозвать» выключает токен; вместе с ним перестают работать и все ссылки на результаты, которые были по нему выданы.

## Безопасность доступа

Токен и подключённое приложение действуют от вашего имени и тратят ваши кредиты, поэтому обращайтесь с ними как с паролем:

- Не передавайте секрет токена третьим лицам — кто угодно с этим токеном может запускать генерацию за ваш счёт.
- Разрешайте подключение только тогда, когда сами его начали. Если страница запроса доступа открылась без ваших действий — отклоните её.
- Ненужные токены и приложения отзывайте: доступ закрывается сразу, а вместе с ним и выданные ссылки на файлы.

---

# Что агент умеет через MCP

> Полный список инструментов, которые Строфи даёт внешнему AI-агенту по MCP — каталог моделей, оценка стоимости, запуск и отмена генерации, входные файлы, баланс — и что через MCP недоступно.

Источник: https://strophe.app/docs/product/integrations/capabilities
Обновлено: 2026-08-27

Задачу вы формулируете словами, а дальше всё делает подключённое приложение: выбирает модель, готовит входные файлы, запускает генерацию. Ниже — инструменты, которые оно для этого получает, и границы того, что через MCP можно.

## Инструменты

Инструментов девять, и вызываются они сами — называть их в запросе не нужно.

| Инструмент          | Что делает                                                                                 |
| ------------------- | ------------------------------------------------------------------------------------------ |
| `list_families`     | Каталог моделей: что умеет каждая, цена от, обычное время работы, сколько входов принимает |
| `get_family_schema` | Параметры и входы выбранных моделей — сразу для нескольких                                 |
| `estimate_cost`     | Стоимость нескольких вариантов запуска за один вызов                                       |
| `generate`          | Запуск генерации; единственный инструмент, который тратит кредиты                          |
| `get_generation`    | Состояние и результат: ссылка на готовый файл                                              |
| `cancel_generation` | Отмена запущенной генерации                                                                |
| `list_generations`  | История генераций, запущенных через MCP                                                    |
| `get_balance`       | Сколько кредитов доступно прямо сейчас                                                     |
| `upload_media`      | Загрузка входного файла — картинки, видео, звука или 3D                                    |

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

## Каталог моделей

Через MCP виден тот же каталог, что и в редакторе, и модель под запрос подбирается сама. Про устройство каталога — в статье [Каталог моделей](https://strophe.app/docs/product/generation/model-catalog).

## Генерация

Запуск идёт без холста.

Результат приходит ссылкой на готовый файл: она действует не меньше суток, работает без пароля и не меняется при повторных обращениях в пределах часа. Отзыв токена или подключённого приложения гасит все выданные ссылки, не дожидаясь их срока.

Вы можете назвать предел расхода — генерация дороже этого числа не начнётся вовсе.

## Оценка стоимости и баланс

До запуска стоимость можно оценить, причём сразу у нескольких моделей — чтобы сравнить их по цене и выбрать. Рядом видно и остаток баланса. Как формируется стоимость — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

## Входные файлы

Многим моделям нужен исходный файл. Подать его можно тремя способами:

- сослаться на результат прошлой генерации, сделанной через MCP;
- загрузить файл напрямую в запросе;
- дать ссылку на файл в интернете.

Как загрузка устроена в редакторе — в статье [Загрузка файлов на холст](https://strophe.app/docs/product/files/uploading).

## Отмена

Запущенную генерацию можно отменить. Деньги зависят от момента: пока задача не ушла модели, удержанные кредиты возвращаются полностью; после того как модель взялась за работу, генерация останавливается, но кредиты списываются — работа уже началась.

Генерации, запущенные на холсте, через MCP не отменяются и в списке MCP не показываются.

## Чего через MCP нельзя

- Генерировать текст — для этого у вашего приложения есть собственные возможности.
- Работать с холстом и проектами: создавать блоки, соединять их, вести проект. Для этого есть [AI-агент в редакторе](https://strophe.app/docs/product/agent/overview).
- Управлять аккаунтом — менять тариф, покупать кредиты, трогать настройки и команду.

---

# Разработчикам

Раздел справки Строфи целиком, статьи в порядке чтения. Источник: https://strophe.app/docs/product/developers

# REST API Строфи

> Программный доступ к генерации Строфи по HTTP: кому он открыт, из чего состоит, чем отличается от подключения агента по MCP и с чего начать интеграцию.

Источник: https://strophe.app/docs/product/developers/overview
Обновлено: 2026-08-26

REST API даёт вашей программе тот же каталог моделей и тот же счёт кредитов, что и редактор. Запрос уходит по HTTP, генерация встаёт в общую очередь, результат забирается ссылкой — холст при этом не участвует.

## Кому открыт

Доступ идёт вместе с командным планом, и распоряжается им владелец команды или её администратор: ключ работает от лица всей команды и тратит общий пул, поэтому выпускать его и подписываться на события вправе тот, кто за этот пул отвечает. Рядовому участнику остаётся подключение агента по MCP — оно открыто любой действующей подписке и тратит личный баланс. Как устроены команды и роли в них, описано в статье [Команда](https://strophe.app/docs/product/account/teams).

## Чем это отличается от подключения агента

Подключение по MCP рассчитано на чужого AI-агента: он читает описания моделей словами, сам выбирает подходящую и запускает генерацию по вашей просьбе в переписке. REST рассчитан на программу: тот же каталог отдаётся машинным JSON, выбор модели делаете вы, а ответ построен на кодах, а не на объяснениях.

Оба пути ведут к одному каталогу и к одному счёту. Генерации, запущенные через REST, видны в истории вместе с теми, что запустил агент.

## Из чего состоит

Базовый адрес — `https://strophe.app/api/v1`. Все запросы идут под ключом в заголовке `Authorization`, ответы всегда в JSON.

Ручек шесть групп:

- каталог моделей — `GET /families` и `GET /families/{id}`;
- генерации — запуск, состояние, история, отмена, предварительная оценка стоимости;
- файлы — `POST /files` превращает ваш файл в идентификатор входа;
- счёт — `GET /account` отвечает, сколько можно потратить прямо сейчас;
- вебхуки — уведомление о завершении генерации приходит на ваш адрес;
- машинное описание — `GET /openapi.json` отдаёт спеку OpenAPI, тоже под ключом.

## Порядок работы

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

1. [Ключ и права](https://strophe.app/docs/product/developers/authentication) — выпуск ключа, права, потолки траты.
2. [Запуск генерации](https://strophe.app/docs/product/developers/generation) — каталог, оценка, запуск, ожидание, результат.
3. [Вебхуки](https://strophe.app/docs/product/developers/webhooks) — исход приходит сам, без опроса.
4. [Ошибки и лимиты](https://strophe.app/docs/product/developers/errors-and-limits) — коды отказа, частота запросов, потолки размеров.

## Версия и совместимость

Версия стоит в пути: `/api/v1`. Внутри версии контракт не ломается — поля добавляются, но не исчезают и не меняют смысл, а набор кодов ошибок пополняется только новыми значениями. Ломающая правка означала бы `/api/v2`, и первая версия продолжила бы работать рядом.

Отсюда практическое правило для клиента: незнакомое поле в ответе игнорируется, незнакомый код ошибки обрабатывается как отказ своего класса — по числовому статусу HTTP и признаку `retryable`.

---

# Ключ и права

> Выпуск ключа для REST API Строфи, набор прав, потолки траты на ключ, передача ключа в запросе, отзыв и проверка состояния счёта.

Источник: https://strophe.app/docs/product/developers/authentication
Обновлено: 2026-08-02

Каждый запрос к API предъявляет ключ. Ключ выпускается в настройках, живёт до отзыва и несёт при себе набор прав и потолки траты — то есть определяет не только «можно ли», но и «на сколько».

## Выпуск ключа

Ключи лежат в настройках, раздел «Интеграции». Как открыть настройки, описано в статье [Настройки](https://strophe.app/docs/product/account/settings).

При выпуске задаются три вещи:

- **Название** — по нему ключ отличают в списке. В запросах не участвует.
- **Права** — что этим ключом разрешено делать.
- **Потолки траты** — сколько кредитов ключ вправе потратить.

Полное значение ключа показывается один раз, сразу после выпуска. Дальше в списке видна только начальная часть — по ней ключ узнают, но восстановить из неё ничего нельзя. Потеряли — выпускайте новый и отзывайте старый.

## Права

Право выдаётся под задачу, а не «на всё»: ключ витрины, показывающей баланс, не должен уметь тратить деньги.

- `catalog:read` — читать каталог моделей и машинную спеку.
- `generations:read` — смотреть состояние генерации, историю и предварительную оценку стоимости.
- `generations:write` — запускать и отменять генерации.
- `files:write` — загружать входные файлы.
- `account:read` — читать состояние счёта.
- `mcp` — подключение агента по протоколу MCP. К REST отношения не имеет и его ручек не открывает.

Запрос с ключом, у которого нужного права нет, получает отказ `insufficient_scope` со статусом 403. Права ключа видны в ответе `GET /api/v1/account`.

## Потолки траты

У ключа два независимых потолка, оба необязательные.

**Суточный** ограничивает трату за календарные сутки по UTC. Счётчик считает и уже списанное, и то, что удерживают идущие генерации; обнуляется он сам.

**Разовый** ограничивает стоимость одной генерации. Он отсекает не расход за день, а ошибку в параметрах: запрос дороже этого числа не начинается вовсе.

Оба потолка меняются в настройках ключа. Запрос, упёршийся в потолок, получает отказ `spend_limit_exceeded`; поле `details.limitKind` называет, какой именно потолок задет, а у суточного там же лежит момент обнуления.

Потолки — не то же самое, что баланс. Их назначение — ограничить ущерб от ключа, отданного чужой программе: без них ошибка в её коде стоит ровно столько, сколько лежит на счету.

## Передача ключа

Ключ передаётся заголовком `Authorization` в схеме Bearer:

```bash
curl https://strophe.app/api/v1/families \
  -H "Authorization: Bearer <ваш ключ>"
```

Ключ — это пароль к вашему счёту. Он не должен попадать в клиентский код, в адресную строку, в логи и в репозиторий: любой, кто его прочитал, тратит ваши кредиты.

Запрос без ключа получает 401 `unauthorized`, с отозванным или несуществующим — 401 `invalid_token`. В обоих случаях в ответе есть заголовок `WWW-Authenticate` — по нему клиент понимает, что чинить нужно именно учётные данные, а не запрос.

## Состояние счёта

Сколько можно потратить прямо сейчас, отвечает `GET /api/v1/account` под правом `account:read`:

```bash
curl https://strophe.app/api/v1/account \
  -H "Authorization: Bearer <ваш ключ>"
```

В ответе — доступные кредиты, состояние команды и потолки предъявленного ключа вместе с потраченным за текущие сутки. Именно предъявленного: у каждого ключа потолки свои, и программа видит те, под которыми работает сама.

Отдельного «баланса» в ответе нет намеренно. Полностью занятый идущими генерациями счёт выглядел бы полным, и программа запустила бы работу, которой не на что выполниться.

## Отзыв

Ключ отзывается в том же разделе настроек. Отзыв мгновенный: следующий запрос с этим ключом получит 401.

Отзыв не отменяет уже запущенные генерации — они дойдут до конца и спишут кредиты. Чтобы остановить работу, генерации отменяют отдельно, до отзыва ключа.

Ссылки на результаты, выданные этим ключом, перестают работать вместе с ним. Это относится и к ссылкам, полученным раньше: они живут ровно столько, сколько живёт ключ, которым были выданы.

---

# Запуск генерации

> Полный путь через REST API Строфи: каталог моделей, загрузка входных файлов, оценка стоимости, запуск с защитой от повтора, ожидание исхода, результат и отмена.

Источник: https://strophe.app/docs/product/developers/generation
Обновлено: 2026-08-26

Генерация запускается одним запросом и выполняется в очереди: ответ на запуск несёт идентификатор, по которому забирают результат. Ниже — весь путь, от выбора модели до готового файла.

## Каталог моделей

Список семейств отдаёт `GET /api/v1/families` под правом `catalog:read`. Фильтры — `task` (что делает модель) и `outputType` (что получается на выходе):

```bash
curl "https://strophe.app/api/v1/families?outputType=image" \
  -H "Authorization: Bearer <ваш ключ>"
```

Подробности одного семейства — `GET /api/v1/families/{id}`. В ответе варианты модели с их задачами и медиа-входами, настраиваемые параметры с типами и допустимыми значениями, цены и ожидаемое время работы.

Там же оси выбора варианта — `axes`: чем семейство отличает свои варианты помимо формы входа. Чаще всего это уровень качества (`version`), реже размер (`size`), тир (`tier`), режим (`mode`) или формат вывода (`format`). У каждой оси перечислены допустимые значения и значение по умолчанию, а у каждого варианта — его значения осей: по ним видно, во что обходится каждый уровень.

Недоступные вам семейства из выдачи не исчезают: они приходят с `available: false` и причиной в `lockReason`. Пропустить их молча значило бы соврать, что такой модели нет.

Неизвестное имя параметра запроса — отказ 400, а не полная выдача. Опечатка вроде `?tasks=` иначе выглядела бы как применённый фильтр.

Общее устройство каталога описано в статье [Каталог моделей](https://strophe.app/docs/product/generation/model-catalog).

## Входные файлы

Медиа задаётся только нашими идентификаторами. Внешняя ссылка в генерацию не попадает: путь чужого файла внутрь один — `POST /api/v1/files` под правом `files:write`.

Файл принимается тремя способами: телом `multipart/form-data` (поле `file`), ссылкой или строкой base64.

```bash
curl https://strophe.app/api/v1/files \
  -H "Authorization: Bearer <ваш ключ>" \
  -F file=@reference.png
```

```bash
curl https://strophe.app/api/v1/files \
  -H "Authorization: Bearer <ваш ключ>" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/reference.png"}'
```

Предел файла — 25 МБ, одинаково для всех трёх способов.

Тип решает подпись содержимого, а не заявление вызывающего: `mimeType` в запросе можно передать, но если он противоречит содержимому, файл будет отвергнут.

В ответе — `fileId`, который и подставляется во входы генерации. Состояние `processing` не отказ: идентификатор уже действителен, а тяжёлое видео дообработается само. Запуск с ещё не готовым файлом отвечает `file_not_ready` — тот же запрос через несколько секунд пройдёт.

Результат прошлой генерации годится входом наравне с загруженным файлом: у готовой генерации есть поле `reusableAs` со списком полей запроса, куда её можно подать, а значением служит `generationId`.

## Оценка стоимости

Сколько будет стоить запрос, отвечает `POST /api/v1/generations/estimate` под правом `generations:read`. Тело — то же, что у запуска. Ничего не создаётся и не тратится:

```bash
curl https://strophe.app/api/v1/generations/estimate \
  -H "Authorization: Bearer <ваш ключ>" \
  -H "Content-Type: application/json" \
  -d '{"familyId": "nano-banana-pro", "prompt": "a red bicycle on a wet street"}'
```

В ответе — стоимость в кредитах, вариант модели, который будет запущен, доступные кредиты и признак `sufficient`: хватает ли счёта на эту работу прямо сейчас. Оценка считается так же, как окончательное списание, поэтому расхождения между ними нет.

## Запуск

`POST /api/v1/generations` под правом `generations:write`:

```bash
curl https://strophe.app/api/v1/generations \
  -H "Authorization: Bearer <ваш ключ>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-4821-render-1" \
  -d '{
        "familyId": "nano-banana-pro",
        "prompt": "a red bicycle on a wet street, evening light",
        "imageIds": ["3f2a…"],
        "maxCredits": 40
      }'
```

Обязателен только `familyId`. Подо что берётся вход, сервер читает по форме запроса. Уровень качества он угадать не может: его задают объектом `axes`, например `{"version": "pro"}`; пропущенная ось берёт значение по умолчанию. Параметры семейства идут объектом `parameters`, медиа — списками идентификаторов (`imageIds`, `videoId`, `videoIds`, `model3dIds`, `audioIds`), и порядок в списках значим: входы моделей позиционные.

`modelId` называет вариант целиком — и сценарий, и уровень; его передают, когда вариант нужен конкретный. Вместе с `axes` он не задаётся: два разных выбора в одном запросе — отказ, а не приоритет одного над другим. Имя оси или значение, которых у семейства нет, тоже отказ; значение, которого нет ни у одного варианта под эту форму входа, — отдельный отказ со списком доступных здесь.

`maxCredits` — потолок этого запроса: дороже — отказ до траты денег. Он необязателен, потому что точную цену даёт оценка, но в автоматической работе его стоит ставить всегда.

Тело проверяется строго: неизвестное поле — отказ, а не молчаливое отбрасывание. Опечатка в имени параметра иначе запустила бы не то, что вы просили, а счёт пришёл бы настоящий. То же внутри `parameters`: имя, которого нет в схеме семейства, — отказ, и медиа туда не кладут, даже если параметр модели называется ссылкой. Входы задаются только списками идентификаторов.

Ответ — 201 с идентификатором, состоянием `queued`, удержанной суммой и заголовком `Location` на ручку состояния.

## Защита от повтора

Заголовок `Idempotency-Key` делает запуск безопасным при обрыве связи. Повтор с тем же ключом и тем же телом не запускает вторую генерацию: приходит тот же ответ 201, но с `replayed: true`.

Тот же ключ с другими параметрами — отказ `idempotency_conflict`. Повтор, пока первый запрос ещё выполняется, — `idempotency_in_progress`: дождитесь его, а не запускайте новый.

Без заголовка повтор ничем не защищён. Оборвавшийся ответ в этом случае означает, что генерация могла запуститься, — и деньги за неё будут списаны.

## Ожидание исхода

Состояние генерации отдаёт `GET /api/v1/generations/{id}` под правом `generations:read`. Параметр `wait` до 60 секунд задерживает ответ до конца работы или до истечения этого времени:

```bash
curl "https://strophe.app/api/v1/generations/<id>?wait=30" \
  -H "Authorization: Bearer <ваш ключ>"
```

Состояний шесть: `queued`, `running`, `finalizing` и три конечных — `ready`, `failed`, `cancelled`. У незавершённой генерации есть `pollAfterSeconds` — через сколько имеет смысл спросить снова; у конечных его нет, потому что спрашивать больше не о чем.

Опрос — не единственный способ: исход умеет приходить сам. Как это настроить, описано в статье [Вебхуки](https://strophe.app/docs/product/developers/webhooks).

Провалившаяся генерация — это ответ 200, а не отказ запроса: состояние `failed`, а причина лежит в `error` — класс `code`, причина внутри класса `reason`, признак `retryable`, подсказка `hint` и разобранные числа в `details`. Как устроен этот разбор — в статье [Ошибки и лимиты](https://strophe.app/docs/product/developers/errors-and-limits).

## Результат

У готовой генерации в `result` лежит ссылка на файл, его тип и размеры, а у видео и аудио — длительность. Ссылка ведёт на нашу выдачу, а не в хранилище: она ничего не раскрывает и живёт не меньше суток, но умирает вместе с ключом, которым выдана. Если ключ отозвали, выданные им ссылки перестают работать.

Поле `text` в результате занято текстовой генерацией. Каталог внешнего API таких семейств не предлагает — текст через него не запускается, — но в истории они встречаются.

## История

`GET /api/v1/generations` возвращает историю страницами: до 50 записей за раз, метка следующей страницы — в `nextCursor`. Фильтр `status` принимает `active`, `ready` и `failed`.

Курсор ключевой, а не смещение: генерации, запущенные во время обхода, не сдвигают окно и не приводят к пропускам.

История общая с подключением агента по MCP: это один внешний доступ с двумя способами обращения, и делить их незачем.

## Отмена

`POST /api/v1/generations/{id}/cancel` под правом `generations:write`. В ответе — состояние, признак `cancelled` (отменил ли генерацию именно этот вызов) и `creditsCharged`.

Деньги зависят от момента: отмена до старта возвращает удержанное целиком, отмена уже начатой работы её оплачивает.

---

# Вебхуки

> Уведомления о завершении генерации на ваш адрес: подписка, три события, форма тела, проверка подписи, повторные попытки, журнал доставок и требования к приёмнику.

Источник: https://strophe.app/docs/product/developers/webhooks
Обновлено: 2026-08-02

Вебхук избавляет от опроса: как только генерация завершилась, мы сами шлём POST-запрос на ваш адрес с её итоговым состоянием. Опрос при этом остаётся рабочим способом — вебхук его дополняет, а не заменяет. Как генерация запускается и что возвращает опрос, описано в статье [Запуск генерации](https://strophe.app/docs/product/developers/generation).

## Подписка

Подписки заводятся в настройках, раздел «Интеграции». У подписки два поля:

- **Адрес** — куда слать. Только публичный адрес; внутренние и приватные отвергаются при сохранении. Он же называет подписку в списке.
- **События** — какие исходы вам нужны.

При создании выдаётся секрет подписи. Он показывается один раз — как и [ключ API](https://strophe.app/docs/product/developers/authentication), дальше он хранится только у вас.

Адрес проверяется в момент сохранения: если имя не разрешается в публичный адрес, подписка не создастся.

## События

Событий три, по числу конечных состояний генерации:

- `generation.completed` — работа закончена, результат готов;
- `generation.failed` — работа провалилась;
- `generation.cancelled` — генерация отменена.

Промежуточных переходов (постановка в очередь, начало работы) в рассылке нет намеренно: интегратору важен исход, а поток всех переходов пришлось бы фильтровать на своей стороне.

## Тело запроса

Приходит JSON:

```json
{
  "id": "9f1c…",
  "event": "generation.completed",
  "createdAt": "2026-08-02T10:15:31.204Z",
  "data": { "generation": { "generationId": "3f2a…", "state": "ready", "…": "…" } }
}
```

Генерация внутри `data` — в той же форме, что и ответ `GET /api/v1/generations/{id}`. Одна и та же работа не должна выглядеть по-разному в зависимости от того, пришла она сама или её спросили.

Поле `id` — идентификатор доставки. Он одинаков у всех попыток одного события: по нему приёмник глушит повторы.

`createdAt` — момент события, а не момент попытки. У повторной доставки он тот же, что у первой.

## Проверка подписи

Каждый запрос несёт заголовок `X-Strophe-Signature`:

```http
X-Strophe-Signature: t=1785974131,v1=6b1f…
```

`t` — момент подписи в секундах Unix, `v1` — HMAC-SHA256 от строки `t.тело` с вашим секретом, в шестнадцатеричном виде. Проверка на стороне приёмника:

```python
import hashlib, hmac, time

def valid(raw_body: bytes, header: str, secret: str) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(","))
    signed = f"{parts['t']}.".encode() + raw_body
    expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
    fresh = abs(time.time() - int(parts["t"])) < 300
    return fresh and hmac.compare_digest(expected, parts["v1"])
```

Считать подпись нужно от сырого тела запроса, до разбора JSON: повторная сборка объекта в строку даёт другие пробелы и другой порядок ключей, а значит другую подпись.

Момент `t` стоит сравнивать с текущим временем и отвергать слишком старые запросы: без этого перехваченный когда-то запрос можно проиграть заново.

Запрос без действительной подписи обрабатывать нельзя. Адрес приёмника рано или поздно становится известен, и подпись — единственное, что отличает наше уведомление от чужого.

## Требования к приёмнику

**Успех — только код 2xx.** Всё остальное считается неудачей и приводит к повтору. Редиректы не выполняются: приёмник обязан отвечать по тому адресу, на который подписался.

**Ответить нужно за 10 секунд.** Долгая работа по событию выносится в свою очередь: сначала подтвердите приём, потом обрабатывайте.

**Повторы возможны.** Сеть не гарантирует однократной доставки: приёмник должен переживать повтор того же `id` без последствий.

**Порядок не гарантирован.** Событие по одной генерации может обогнать событие по другой; опираться нужно на содержимое, а не на очерёдность прихода.

## Повторные попытки

Неудачная доставка повторяется до шести раз с удваивающейся паузой, начиная с десяти секунд, — это около двадцати минут на приёмник, упавший под нагрузкой. Исчерпав попытки, доставка закрывается как неудачная.

Первые несколько байт ответа приёмника мы сохраняем: если он объяснил отказ текстом, этот текст будет виден в журнале.

## Журнал доставок

У каждой подписки есть журнал: строка на событие с временем, номером события, числом попыток, кодом ответа и текстом отказа. Он открывается из меню подписки в настройках и отвечает на вопрос «почему мне не пришло» без обращения в поддержку.

Журнал хранится 30 дней — хвост чистится сам.

В строке подписки в списке видны день последней доставки и её исход: так поломка заметна раньше, чем о ней сообщит журнал.

---

# Ошибки и лимиты

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

Источник: https://strophe.app/docs/product/developers/errors-and-limits
Обновлено: 2026-08-26

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

## Форма отказа

```json
{
  "error": {
    "code": "cost_above_limit",
    "message": "The generation costs more than the maxCredits ceiling in the request.",
    "retryable": false,
    "details": { "credits": 62, "maxCredits": 40 }
  }
}
```

`code` — машинный идентификатор, единственное, на что стоит программировать. `message` написан для человека, читающего лог, и может меняться. `retryable` отвечает, имеет ли смысл повторить тот же запрос без изменений. `details` есть не всегда: там лежит машинная диагностика — перечень проблем валидации, незакрытые входы, числа.

Локализации нет: ответ читает программа, а не человек в интерфейсе.

Каждый ответ несёт `X-Request-Id`. Он же записан в наших логах, поэтому разбор происшествия начинается с одной строки — приложите его к обращению в поддержку.

## Коды и статусы

Список закрыт: код, которого нет в таблице, наружу не уходит. Новые значения могут появляться — незнакомый код обрабатывайте по числовому статусу и признаку `retryable` из ответа.

| Код                         | HTTP | Когда приходит                                                               |
| --------------------------- | ---- | ---------------------------------------------------------------------------- |
| `access_denied`             | 403  | Внешний доступ этому счёту закрыт                                            |
| `account_blocked`           | 403  | Аккаунт заблокирован                                                         |
| `cancel_conflict`           | 409  | Состояние генерации изменилось во время отмены                               |
| `cost_above_limit`          | 402  | Запрос дороже переданного `maxCredits`                                       |
| `credit_reservation_failed` | 402  | Резерв кредитов не удался                                                    |
| `family_not_found`          | 400  | Такого семейства в каталоге нет                                              |
| `family_unavailable`        | 503  | Семейство временно недоступно                                                |
| `file_fetch_failed`         | 502  | Файл по ссылке не забрался                                                   |
| `file_metadata_missing`     | 400  | Длительность входного видео ещё не измерена, а модель считается посекундно   |
| `file_not_found`            | 404  | Такого идентификатора файла или генерации нет                                |
| `file_not_ready`            | 409  | Файл ещё обрабатывается                                                      |
| `file_processing_failed`    | 422  | Обработка файла не удалась                                                   |
| `generation_not_found`      | 404  | Генерации с таким идентификатором у вас нет                                  |
| `idempotency_conflict`      | 409  | `Idempotency-Key` уже использован с другими параметрами                      |
| `idempotency_in_progress`   | 409  | Запрос с этим `Idempotency-Key` ещё выполняется                              |
| `insufficient_credits`      | 402  | Кредитов не хватает — на балансе или после вычета занятого другими запусками |
| `insufficient_scope`        | 403  | У ключа нет нужного права                                                    |
| `internal_error`            | 500  | Внутренний сбой сервиса                                                      |
| `invalid_cursor`            | 400  | Метка страницы не из предыдущего ответа                                      |
| `invalid_parameters`        | 400  | Параметры не подходят выбранному варианту                                    |
| `invalid_request`           | 400  | Тело или параметр не прошли проверку; перечень проблем в `details.issues`    |
| `invalid_token`             | 401  | Ключ отозван или не существует                                               |
| `not_cancellable`           | 409  | Генерация запущена в редакторе — такую отменяют там                          |
| `payload_too_large`         | 413  | Тело запроса больше допустимого                                              |
| `price_unavailable`         | 400  | Стоимость для таких параметров не складывается                               |
| `queue_unavailable`         | 500  | Очередь генерации недоступна                                                 |
| `rate_limited`              | 429  | Превышена частота запросов                                                   |
| `service_unavailable`       | 503  | Сервис временно недоступен                                                   |
| `spend_limit_exceeded`      | 403  | Задет потолок ключа; какой именно — в `details.limitKind`                    |
| `subscription_required`     | 403  | Семейство требует действующей подписки                                       |
| `team_expired`              | 403  | Срок плана команды истёк                                                     |
| `team_required`             | 403  | Доступ идёт вместе с командой; чего не хватает — в тексте ошибки             |
| `too_many_concurrent`       | 429  | Слишком много запросов в работе одновременно                                 |
| `unauthorized`              | 401  | Ключа в запросе нет                                                          |
| `unsupported_content_type`  | 415  | Такой тип содержимого ручка не принимает                                     |
| `unsupported_file_format`   | 415  | Содержимое не опознано или такой формат не принимается                       |
| `variant_not_resolved`      | 400  | Ни один вариант не подходит к такому набору входов                           |

Повторять или нет, говорит `retryable` в самом ответе: у части кодов это зависит от причины, а не от кода. У всех отказов по частоте и временной недоступности есть заголовок `Retry-After`.

## Отказ самой генерации

Провалившаяся генерация — это ответ 200 с состоянием `failed`, а не отказ запроса: запрос выполнен, не удалась работа модели. Причина лежит внутри генерации и устроена иначе, чем отказ ручки:

```json
{
  "generationId": "8f14e45f-ceea-467a-9a3e-4b1c2d5e7f80",
  "state": "failed",
  "error": {
    "code": "prompt_validation",
    "reason": "prompt_too_long",
    "message": "The prompt is longer than this model accepts.",
    "retryable": false,
    "hint": "The model could not work with this prompt. Rewrite it, or pick another family.",
    "details": { "limit": 8000 }
  }
}
```

`code` — класс отказа, список закрыт. `hint` называет действие, а не диагноз: что менять перед следующей попыткой. `details` появляется там, где из отказа удалось достать числа — например предел длины промпта у конкретной модели.

| Класс                  | Что случилось                                 | Что делать                                                    |
| ---------------------- | --------------------------------------------- | ------------------------------------------------------------- |
| `content_policy`       | Модель отказала по содержанию                 | Менять промпт или входные файлы: тот же запрос откажет так же |
| `prompt_validation`    | Модель не приняла промпт                      | Переписать промпт или взять другую модель                     |
| `parameter_validation` | Параметр или вход не подходит модели          | Свериться со схемой семейства и поправить запрос              |
| `file_size`            | Входной файл не укладывается в пределы модели | Взять файл другого размера                                    |
| `image_size`           | Размер входной картинки не подходит модели    | Взять картинку другого размера                                |
| `image_format`         | Файл не прочитался как изображение            | Загрузить заново в поддерживаемом формате                     |
| `feature_limitation`   | Модель не умеет того, о чём просили           | Выбрать другое семейство                                      |
| `model_unavailable`    | Модель недоступна                             | Взять другое семейство или повторить позже                    |
| `insufficient_credits` | Кредиты кончились до старта                   | Проверить баланс перед повтором                               |
| `authentication`       | Доступ к модели временно закрыт               | Повторить позже; запрос ни при чём                            |
| `timeout`              | Модель не ответила вовремя                    | Повторить: тот же запрос может пройти                         |
| `provider_error`       | Временный сбой модели                         | Повторить: тот же запрос может пройти                         |
| `internal_error`       | Внутренний сбой сервиса                       | Повторить: тот же запрос может пройти                         |
| `user_cancellation`    | Генерацию отменили                            | Ничего — это ответ на отмену                                  |

`reason` — причина внутри класса, и программировать разное поведение стоит по ней. Один класс покрывает несколько разных отказов: `prompt_too_long`, `prompt_failed` и `prompt_images_failed` — всё это `prompt_validation`, но первый чинится обрезкой промпта, а последний — заменой входных изображений. Список причин, в отличие от списка классов, открыт и пополняется. Опубликованную причину мы не переименовываем, а незнакомую обрабатывайте по `code`.

Дословную формулировку модели мы наружу не отдаём — в `message` приходит наш текст по причине отказа. Чтобы подняли оригинал, назовите `generationId` в обращении в поддержку.

Причина `unclassified` при классе `internal_error` означает, что отказ не удалось отнести ни к одной известной причине. Обрабатывайте его по `code`; со временем такие отказы получают точную причину.

## Частота и одновременность

Ограничений два, и считаются они на пользователя, а не на ключ: сорвавшийся скрипт одного участника команды не должен закрывать API остальным.

**Частота.** Сейчас это 600 запросов в минуту. Превышение — 429 `rate_limited` с заголовком `Retry-After`.

**Одновременность.** До 32 запросов в работе одновременно. Потолок рассчитан на ожидание через `wait`, где запрос висит до минуты; больше тридцати двух открытых ожиданий — повод перейти на историю или на вебхуки. Превышение — 429 `too_many_concurrent`.

Точные числа приходят в заголовках каждого ответа, и опираться стоит на них, а не на значения в тексте:

```http
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 587
X-RateLimit-Reset: 1785974160
```

`X-RateLimit-Reset` — момент обнуления счётчика в секундах Unix.

Отдельно от этого действуют потолки траты самого ключа — суточный и разовый. Они описаны в статье [Ключ и права](https://strophe.app/docs/product/developers/authentication).

## Потолки размеров

| Что                     | Предел                                                       | При превышении                      |
| ----------------------- | ------------------------------------------------------------ | ----------------------------------- |
| Тело запроса            | 256 КиБ                                                      | 413 `payload_too_large`             |
| Файл                    | 25 МБ — одинаково для `multipart/form-data`, ссылки и base64 | Отказ приёма файла                  |
| Промпт                  | 20 000 символов                                              | Отказ проверки запроса              |
| Медиа-входов в запросе  | 20                                                           | Подбор варианта отказывает          |
| Страница истории        | 50 записей                                                   | Значение больше не принимается      |
| Ожидание внутри запроса | 60 секунд                                                    | Ответ приходит с `pollAfterSeconds` |

Две последние границы — заслон транспорта, а не пределы моделей: те заметно строже. Сколько входов принимает вариант, видно в подробностях семейства (`inputs.images.max` и соседние поля), а предел длины промпта — в описании параметра, если модель его объявляет. Лишний файл отвергается подбором варианта с кодом `variant_not_resolved`, слишком длинный промпт — самой моделью с классом `prompt_validation`, и там же в `details` приходит настоящее число.

## Машинное описание

`GET /api/v1/openapi.json` отдаёт спеку OpenAPI: пути, схемы запросов и ответов, коды отказа. Она собирается из тех же схем, которыми проверяется вход, поэтому разойтись с поведением не может.

Спека закрыта тем же ключом, что и остальные ручки, и требует права `catalog:read`: документ описывает ручки, но не даёт ими пользоваться.

---

# Справочник

Раздел справки Строфи целиком, статьи в порядке чтения. Источник: https://strophe.app/docs/product/reference

# Горячие клавиши

> Полная таблица горячих клавиш Строфи: навигация по холсту, действия с блоками и быстрое создание блоков.

Источник: https://strophe.app/docs/product/reference/hotkeys
Обновлено: 2026-08-11

Горячие клавиши ускоряют работу с проектом: перемещение по холсту, действия с блоками и создание новых блоков без обращения к меню. Сочетания срабатывают, когда фокус на [холсте](https://strophe.app/docs/product/canvas/canvas-navigation) — то есть вы не находитесь в поле ввода промпта, названии проекта или другом текстовом поле.

Модификатор `Cmd/Ctrl` зависит от системы: на macOS это `Cmd`, на Windows и Linux — `Ctrl`. Дальше в таблицах указано `Cmd/Ctrl` — нажимайте ту клавишу, которая есть на вашей клавиатуре.

## Навигация

Сочетания для перемещения по холсту и открытия основных панелей.

| Сочетание      | Действие               |
| -------------- | ---------------------- |
| `Cmd/Ctrl + P` | Открыть проекты        |
| `Cmd/Ctrl + K` | Открыть каталог блоков |
| `Esc`          | Сбросить выделение     |
| `+`            | Приблизить             |
| `-`            | Отдалить               |
| `Cmd/Ctrl + 0` | Сбросить масштаб       |
| `Shift + 1`    | Отобразить все         |
| `H`            | Режим перемещения      |

## Действия с блоками

Сочетания для работы с [выделенными блоками](https://strophe.app/docs/product/canvas/selection-and-move): [отмена и повтор](https://strophe.app/docs/product/canvas/undo-redo), [копирование](https://strophe.app/docs/product/canvas/copy-paste), удаление и [группировка](https://strophe.app/docs/product/canvas/groups).

| Сочетание              | Действие                             |
| ---------------------- | ------------------------------------ |
| `Enter`                | Запустить генерацию или открыть блок |
| `Cmd/Ctrl + Z`         | Отменить действие                    |
| `Cmd/Ctrl + Shift + Z` | Повторить действие                   |
| `Cmd/Ctrl + C`         | Копировать                           |
| `Cmd/Ctrl + V`         | Вставить                             |
| `Cmd/Ctrl + D`         | Дублировать                          |
| `Backspace`            | Удалить                              |
| `Cmd/Ctrl + G`         | Группировать                         |
| `Cmd/Ctrl + Shift + G` | Разгруппировать                      |

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

«Повторить действие» означает «вернуть то, что вы только что отменили», а не «сделать последнее действие ещё раз». Что именно отменяется и возвращается — в статье [Отмена и повтор действий](https://strophe.app/docs/product/canvas/undo-redo).

## Создание блоков

Одна клавиша создаёт на холсте [блок](https://strophe.app/docs/product/canvas/block-types) нужного типа.

| Сочетание | Действие    |
| --------- | ----------- |
| `T`       | Текст       |
| `I`       | Изображение |
| `V`       | Видео       |
| `A`       | Аудио       |
| `D`       | 3D          |
| `S`       | Стикер      |

Все шесть клавиш работают одинаково на любом аккаунте — включая `A` для аудио-блока.

---

# Глоссарий

> Короткие определения основных понятий Строфи — блок, соединение, холст, проект, генерация, кредит и другие термины интерфейса.

Источник: https://strophe.app/docs/product/reference/glossary
Обновлено: 2026-08-07

Справка называет вещи так же, как их называет интерфейс Строфи. Этот словарь коротко объясняет основные понятия — чтобы, встретив в статье «блок» или «соединение», вы сразу понимали, о чём речь.

## Холст и блоки

**Проект** — отдельный документ со своим холстом и всем, что на нём стоит. Открывается из раздела «Проекты», сохраняется автоматически по мере работы.

**Холст** — бесконечная рабочая область, на которой размещаются блоки и соединения между ними.

**Блок** — базовый элемент на холсте. Блоки бывают двух родов: простые хранят готовое содержимое (текст, изображение, видео, аудио, 3D-модель, стикер), блоки генерации и обработки создают и меняют его. Подробнее — в статье [Какие бывают блоки](https://strophe.app/docs/product/canvas/block-types).

**Простой блок** — блок с готовым содержимым: загруженный файл, стикер. Он хранит и отдаёт содержимое дальше по соединениям, но модель сам не запускает и кредитов не тратит. Особняком стоит текстовый блок: он и хранит текст, и умеет сгенерировать его своей кнопкой Сгенерировать.

**Соединение** — связь между двумя блоками, по которой результат одного подаётся на вход другого. У входов есть предел: если подключить больше нельзя, интерфейс сообщает «Максимум N соединений».

**Группа** — несколько блоков, объединённых в общий контейнер. С группой работают как с одним объектом: перемещают, копируют и запускают её целиком.

## Генерация

**Блок генерации** — блок, который запускает модель и складывает в себя результат. Он принимает вход по соединениям (промпт, изображения, кадры) и выдаёт готовый текст, изображение, видео, звук или 3D.

**Генерация** — создание содержимого моделью по вашему запросу: текста, изображения, видео, звука или 3D. Как это устроено — в статье [Как работает генерация](https://strophe.app/docs/product/generation/how-it-works).

**Модель** — конкретный AI-генератор, например Nano Banana, Kling или FLUX. Каждая запись каталога — отдельная модель.

**Версия** — вариант внутри одной модели, между которыми переключаются в блоке: например, быстрый и более качественный. Версии есть не у всех моделей; цена и набор параметров у них могут отличаться.

**Промпт** — текстовый запрос к модели, который описывает, что сгенерировать.

**Пример** (в части интерфейса — **референс**) — изображение, которое подаётся модели как ориентир по стилю или содержанию. Встречаются оба слова: «Максимум 5 примеров» и «Стилевые референсы» означают одно и то же, продукт постепенно переходит на «пример».

**Стиль** — сохранённый набор примеров и настроек, который переиспользуется при генерации. Свои стили собраны в разделе «Мои стили».

## Аккаунт

**Кредит** — внутренняя валюта Строфи, которой оплачивается каждая генерация. Баланс виден в аккаунте; когда кредиты кончаются, появляется сообщение «Кредиты закончились. Пополните баланс». Что и сколько списывается — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

---

# Ограничения и лимиты

> Сводка числовых ограничений Строфи в одном месте — размер файла, пропорции, пакетное скачивание, длина имени проекта и глубина отмены.

Источник: https://strophe.app/docs/product/reference/limits-reference
Обновлено: 2026-07-24

Эта страница собирает в одном месте числовые ограничения Строфи, которые заметны в повседневной работе: сколько весит загружаемый файл, сколько результатов уходит в один архив, какой длины бывает имя проекта. Здесь короткие значения и ссылка на подробную статью по каждой теме.

Часть ограничений задаёт не платформа, а выбранная модель генерации — минимальный размер входного изображения, длительность видео, предельная вытянутость изображения на входе. Такие пределы у каждой модели свои, поэтому здесь их нет: их показывает сама модель, когда вход ей не подходит.

## Файлы

Ограничения на загрузку и скачивание одинаковы для всех типов медиа — изображений, видео, аудио и 3D-моделей.

| Ограничение                           | Значение                              |
| ------------------------------------- | ------------------------------------- |
| Размер одного загружаемого файла      | до 25 МБ                              |
| Пропорции загружаемого изображения    | не вытянутее 10:1 в любую сторону     |
| Файлов в одном пакетном скачивании    | до 50                                 |
| Размер архива при пакетном скачивании | до 200 МБ                             |
| Скачивание напрямую, без архива       | когда файлов до 5 и суммарно до 30 МБ |

Слишком узкое или длинное изображение (тоньше 1:10 или длиннее 10:1) при загрузке отклоняется. У отдельных моделей есть собственный предел вытянутости уже на входе генерации — он строже общего и задаётся самой моделью.

Подробнее о загрузке — в статье [Загрузка файлов](https://strophe.app/docs/product/files/uploading), о пакетном скачивании и архивах — в статье [Скачивание результатов](https://strophe.app/docs/product/files/downloading).

## Проект

| Ограничение         | Значение       |
| ------------------- | -------------- |
| Длина имени проекта | до 32 символов |

Имя ограничивается при создании проекта и при переименовании: поле не даёт ввести больше, а счётчик под ним показывает, сколько символов осталось.

Жёсткого потолка на число блоков и соединений при обычной работе нет. Вы добавляете блоки и связи по одному, и проект растёт, пока с ним удобно работать; отдельной цифры, на которой добавление останавливается, платформа не выставляет. Про то, от чего в этом случае зависит комфорт, — в статье [Размер проекта и его пределы](https://strophe.app/docs/product/projects/limits).

## Работа с холстом

| Ограничение              | Значение                  |
| ------------------------ | ------------------------- |
| Глубина отмены и повтора | до 100 последних действий |

История помнит сто последних шагов. Когда действий становится больше, самые старые вытесняются, и отменить их уже нельзя — доступны только сто свежих.

## Стили

| Ограничение            | Значение |
| ---------------------- | -------- |
| Примеров на один стиль | до 5     |

При обучении своего стиля вы добавляете до пяти изображений-примеров. Когда их пять, поле перестаёт принимать новые.