Создайте черновик в Smart Set Builder

Для кого: Для тех, кто готовит упорядоченный список для прослушивания или диджейского сета. Задача: Объяснить настройки SET, требования, предварительный просмотр Hybrid и границы безопасности. Тип: Руководство

Состояние интерфейса v7

Описанный ниже сценарий React относится к отложенному интерфейсу. Он ещё не перенесён на API схемы v7, поэтому эти шаги сейчас не проверены и недоступны для v7. Используйте приведённую ниже альтернативу через API бэкенда.

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

Результат — упорядоченный черновик для прослушивания. По нему удобно искать возможный маршрут через фонотеку и замечать пробелы, повторы или резкие скачки. Это не готовый план выступления, не генератор cue-меток и не гарантия того, что соседние треки сведутся.

Актуальная альтернатива v7

Создавайте упорядоченный черновик через POST /api/set-builder/generate. Сравнение Hybrid доступно через POST /api/search/hybrid. Обе конечные точки только возвращают данные: клиент API сам выбирает нужные ID треков и отдельно вызывает POST /api/export. Актуальные поля и диапазоны описаны в справочнике API.

Сценарий отложенного интерфейса

Что происходит при создании

1. SET ограничивает пул треками с необходимым анализом.
2. Находит кандидатов, связанных с опорными точками несколькими аудиопризнаками.
3. Балансирует кандидатов по режиму, разнообразию, энергии, темпу, исполнителям и необязательным настройкам классификаторов.
4. Возвращает упорядоченный черновик со сведениями о покрытии.
5. До нажатия Add preview текущий сет не изменяется.

Вкладка SET создаёт черновик через /api/set-builder/generate.

Требования

SET использует треки с полным набором признаков. Трек подходит только при наличии:

• анализа SONARA;
• эмбеддинга MERT;
• эмбеддинга MAEST;
• аудиоэмбеддинга CLAP.

Ответ содержит общее и подходящее количество треков, а также число отсутствующих результатов MERT, MAEST, CLAP и SONARA.

Источник референсных треков

Manual - selected использует выбранные референсные треки (seed) как промежуточные опорные точки. Бэкенд проверяет полноту их признаков и применяет ограничение по исполнителю: не более одного трека известного исполнителя в одном черновике.

Auto - random start выбирает первую опорную точку из фонотеки с полными признаками, а затем подбирает связанные промежуточные опорные точки. Значение Auto anchors ограничивается диапазоном 1..5.

Режим сета

• Similar crate - close остаётся близко к опорным точкам и реже рискует разнообразием.
• Weird adjacent - odd допускает менее очевидный соседний материал, сохраняя связь с опорными точками.
• Balanced set - flow балансирует сходство, разнообразие, совместимость перехода, кривую энергии и ограничения исполнителей.
• Discovery - wide расширяет поиск ради новизны, но сохраняет связь кандидатов с опорными точками.

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

Размер и разнообразие

• Track limit принимает 1..500. Референсные треки и опорные точки входят в этот лимит.
• Diversity принимает 0.00..1.00. Малое значение держит результат ближе к опорным точкам, большое сильнее разносит кандидатов, сохраняя связь.

Кривая энергии

• Balanced удерживает энергию рядом с контекстом опорных точек.
• Warmup начинает ниже и постепенно поднимается.
• Peak предпочитает высокую энергию и плотность.
• Wave создаёт чередование подъёма и спада.

Настройки BPM

Режим General BPM по умолчанию использует BPM и тональность только как дополнительные данные о совместимости перехода. Сначала SET берёт актуальные данные темпа SONARA с корректной сигнатурой. При уверенности ниже 0.45 он проверяет варианты темпа SONARA и тег BPM из Mutagen. grid_stability может ослабить надёжность темпа; при низкой надёжности оценка движется к нейтральной, а не превращается в бонус сходства или жёсткое исключение.

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

Явные режимы траектории:

• Low to high: движение от меньшего BPM к большему.
• High to low: движение от большего BPM к меньшему.

При активной траектории:

• BPM change может быть slow, medium или fast;
• Start BPM и Target BPM принимают 20..300 либо остаются пустыми для автоматического выбора;
• половинный и двойной темп учитываются для совместимости перехода, но не заменяют фактическую траекторию BPM.

Ползунки классификаторов

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

• Preference находится в диапазоне от -1.00 до 1.00;
• Flow может быть flat, rise или fall.

Отсутствующая оценка классификатора остаётся нейтральной. Эти элементы читают сохранённые баллы, но не обучают модель и не декодируют аудио.

Предварительный просмотр Hybrid

Во вкладке SET находится Hybrid preview — явный взвешенный просмотр по сохранённым данным MERT, MAEST, SONARA и CLAP.

Hybrid:

• требует от одного до пяти выбранных референсных треков;
• позволяет включать и отключать каждый источник;
• принимает веса источников от 0.00 до 1.00;
• запрашивает 1..100 кандидатов на источник;
• показывает до 1..100 строк;
• применяет необязательный штраф риска перехода от 0.00 до 1.00;
• использует предпочтения и риск классификаторов, если опубликованные модели предоставляют совместимые сигналы.

Риск перехода v2 может использовать сохранённую устойчивость сетки ритмических долей и структурные границы SONARA. Это по-прежнему диагностика для порядка, проверяемого на слух: не cue-метки и не обещание удачного сведения. Версия v1 сохраняет первоначальный расчёт для воспроизводимых оценок.

Последовательность SET использует структуру отдельно от компонентов риска Hybrid. При наличии структурных данных уверенность перехода сочетает 50% темпа, 30% гармонической совместимости и 20% структуры. Без структуры используются 60% темпа и 40% гармонической совместимости. Устойчивость сетки ритмических долей влияет через надёжность темпа.

Точные правила темпа, Camelot и структуры см. в контракте SONARA v0.2.9.

Интерфейс записывает сессии и события оценки для обратной связи. Сам черновик не изменяет треки и текущий сет.

Добавьте черновик

Нажмите Add preview, чтобы добавить треки текущего черновика SET в текущий сет. Уже добавленные треки не дублируются. Экспорт остаётся отдельным шагом.