client.projects.syncLyrics(...), чтобы повторно запустить синхронизацию для любого проекта с обновлённым текстом, другой моделью или новым языком.
client.projects.syncLyrics(projectId, body, options?)
Запустите новую операцию синхронизации текста.
Источник текста
Передайте объектlyricsSource в теле запроса:
- transcribe
- align
Позвольте модели транскрибировать текст из аудио.
Модели синхронизации
Модели выравнивания (используйте сalign, когда у вас точный текст):
audioshake-alignmentmusicai-alignmentmusicai-alignment-subwordwav2vec2
transcribe):
audioshake-transcriptionelevenlabs-transcriptionmusicai-transcriptionwhisper
Полный пример
Что дальше
- Stems — повторно выполните разделение на стемы перед повторной синхронизацией
- Tasks — хэндлы операций и паттерны отмены
- Choose a lyrics sync model — выберите подходящую модель
Узнайте о поддерживаемых моделях
client.capabilities.get() возвращает поддержку настроенных моделей и соответствие аутентифицированного аккаунта требованиям. Каждая модель описывает свою операцию, inputAudio, поддерживаемые workflows, языковую политику, требуемые возможности и suppliedTextHandling. Доступность не является гарантией аптайма провайдера.
Транскрибация принимает необязательные lyrics в качестве опорного текста. Ответ capabilities различает ключевые термины провайдера и исправления после транскрибации. Опорный текст не гарантирует идентичный результат. Для точного использования предоставленного текста выберите подходящую модель выравнивания.
Редактирование существующих таймингов
Используйтеclient.projects.alignments.list(projectId) и .get(projectId, alignmentId), чтобы читать типизированные ресурсы таймингов. .update(projectId, alignmentId, body) заменяет тайминги без задания синхронизации или удержания кредитов на обработку.
Тело обновления требует полный alignment и expectedRevision. Добавьте select: true и expectedSelectionRevision, чтобы атомарно выбрать сохранённое выравнивание. .select(projectId, alignmentId, { expectedRevision, expectedSelectionRevision }) выбирает существующие тайминги. Обе ревизии защищают от параллельных правок. Устаревшая ревизия возвращает HTTP 409.
При редактировании сохраняйте IDs элементов, текст, индексы, исполнителей и переводы. Времена указаны в абсолютных секундах. Каждое окончание должно быть больше своего начала. Недопустимые, отрицательные или выходящие за длительность тайминги отклоняются. Поддерживаются корректные перекрытия и дуэтные тайминги.
Полный пример редактирования таймингов и обработки конфликтов см. в Automate lyric videos.