Замена YouTube Content ID для внешних платформ

Источник: AudD•

Замена YouTube Content ID для внешних платформ

Content ID работает только на YouTube. Чтобы обнаруживать защищенную авторским правом музыку на собственной платформе, в приложении или архиве, используйте собственное распознавание с помощью AudD API.

Эта страница предназначена для команд, которые знакомы с YouTube Content ID и нуждаются в аналогичном обнаружении авторских прав на платформах, которые Content ID не охватывает: в вашем собственном приложении, конвейере пользовательского контента (UGC), медиаархиве или продукте для подкастов и прямых трансляций. Content ID — это внутренняя система управления правами YouTube. Она работает только с контентом, загруженным на YouTube, и доступна правообладателям, соответствующим критериям отбора YouTube. Это не API, который можно задействовать на вашей собственной платформе. Если вам нужно обнаруживать контент на ваших платформах, вы настраиваете собственное распознавание. AudD предоставляет такую возможность через HTTP API: вы отправляете файл, URL или прямую трансляцию и получаете распознанный трек с его метаданными и временными метками. Это не замена Content ID на YouTube — это покрытие платформ, до которых Content ID не дотягивается.

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

Эквивалентный вызов

Content ID выполняет сопоставление внутри YouTube; вы не отправляете никаких запросов из собственного кода. Эквивалентом на вашей платформе является отправка контента в AudD и обработка полученного ответа. Для файлов длиннее короткого клипа (полноценные загрузки, эпизоды подкастов, архивная запись) используйте корпоративную точку доступа (enterprise endpoint), которая разбивает файл на фрагменты на стороне сервера и возвращает каждое совпадение с временными метками.

Всегда устанавливайте параметр limit для корпоративных вызовов во время разработки. Корпоративная точка доступа тарифицирует каждые 12 секунд обработанного аудио. В длинном архиве вызов без ограничений загрузит весь файл целиком; limit=N останавливает обработку после N совпадений.

Всегда устанавливайте параметр limit для корпоративных вызовов во время разработки. Корпоративная точка доступа тарифицирует каждые 12 секунд обработанного аудио. В длинном архиве вызов без ограничений загрузит весь файл целиком; limit=N останавливает обработку после N совпадений.

Для метаданных, чувствительных к авторским правам, важные поля напрямую соответствуют потребностям рабочего процесса по работе с правами: isrc и upc идентифицируют конкретную запись и релиз, label указывает правообладателя, а таймкод (плюс start_offset / end_offset с точными смещениями accurate_offsets) точно определяет, где именно в файле звучит музыка. Isrc и upc возвращаются при корпоративных вызовах, а также для аккаунтов на тарифе Startup и выше.

Сравнение с вашими собственными эталонными записями

Content ID позволяет регистрировать эталонные файлы, чтобы YouTube выполнял поиск по вашему каталогу. Эквивалентом в AudD является пользовательский каталог: вы загружаете собственные треки в свою учетную запись, а последующие вызовы распознавания сопоставляют поступающее аудио с ними. Сопоставление с пользовательским каталогом возвращает audio_id (вашу ссылку на загруженный трек); поля artist/title могут быть пустыми (null), если вы не указали их при загрузке.

Доступ к пользовательскому каталогу ограничен — отправьте запрос на [email protected] для его активации, а затем загружайте файлы через POST api.audd.io/upload/. Разницу между публичной базой данных и вашим пользовательским каталогом можно посмотреть в разделе Публичная база данных против вашего пользовательского каталога.

Мониторинг живого вещания

Если у вас живой источник (трансляция, которую вы хостите, или принимаемый эфир), используйте точки доступа для стримов (streams endpoints). Зарегистрируйте URL для обратного вызова (callback) и добавьте поток: AudD распознает песни по мере их звучания и отправляет POST-запрос с каждым совпадением на ваш callback.

URL потока поддерживает прямые ссылки на стримы (HLS, Icecast, m3u/m3u8), а также сокращения twitch:<channel>, youtube:<video_id> и youtube-ch:<channel_id>. Каждый обратный вызов передает распознаваемую песню вместе с radio_id — целым числом, которое вы присваиваете каждому потоку (а не строковым идентификатором актива, как в Content ID), — чтобы вы могли соотнести совпадение с правильным источником. Установите callbacks="before", чтобы получать обратный вызов в момент начала песни. Если вы не можете разместить общедоступный URL для обратного вызова, используйте опрос GET /longpoll/ и получайте совпадения по собственному расписанию.

Что изменилось

  • Где это работает. Content ID работает только с контентом, загруженным на YouTube. AudD работает с любым аудио или видео, которое вы можете ему отправить: файлом (MP3, WAV, FLAC, M4A, OGG, AAC, WMA, AIFF), видеофайлом через корпоративную точку доступа (MP4, AVI, MOV, MKV, WebM), URL или прямой трансляцией, независимо от того, где этот контент находится.
  • Кто может этим пользоваться. Content ID доступен правообладателям, соответствующим критериям отбора YouTube. AudD — это API самообслуживания:
  • Как происходит интеграция. Content ID отображает совпадения внутри Диспетчера контента YouTube; вызовы API из вашего собственного кода отсутствуют. AudD — это HTTP API, к которому вы обращаетесь из своего бэкенда, с 11 официальными SDK.
  • С чем производится сравнение. Content ID сопоставляет контент с эталонной базой данных YouTube и зарегистрированными вами эталонными файлами. AudD производит поиск по своей публичной базе данных, содержащей 160 миллионов песен, пользовательскому каталогу, который вы загружаете, или по обоим источникам одновременно.
  • Что вы получаете в результате совпадения. AudD возвращает структурированные метаданные, которые можно передать в ваш собственный рабочий процесс (исполнитель, название, альбом, дата релиза, лейбл, isrc, upc, ссылка на песню, а также таймкод / смещения внутри файла), вместо претензии, зарегистрированной на панели управления другой платформы.
  • Корпоративная единица тарификации. Корпоративная точка доступа AudD тарифицируется из расчета за каждые 12 секунд обработанного аудио и требует указания лимита (limit); планируйте бюджет исходя из длительности аудио.
  • Ценообразование. Цены AudD находятся в открытом доступе: 300 бесплатных запросов для новых аккаунтов без привязки карты, затем ежемесячные тарифные планы от $5 (включая 1 000 запросов, дополнительные запросы — по $5,00 за 1 000), все тарифы доступны на странице audd.io/pricing.

Шаги миграции

  • Определите платформу. Уточните, где именно вам нужно обнаружение — в конвейере загрузки пользовательского контента, медиаархиве, ленте подкастов или прямой трансляции, — поскольку от этого зависит выбор используемой точки доступа.
  • Получите токен AudD. Зарегистрируйтесь на dashboard.audd.io (300 бесплатных запросов, карта не нужна).
  • Установите SDK. Например, pip install audd, npm install @audd/sdk или go get github.com/AudDMusic/audd-go. Документация по SDK охватывает все 11 вариантов.
  • Выберите точку доступа в зависимости от задачи. Короткий клип → стандартный метод recognize(...). Полноценные загрузки, эпизоды или архивные файлы → recognize_enterprise(..., limit=N, accurate_offsets=True). Прямые эфиры → потоки (streams: set_callback_url + add) или longpoll, если вы не можете развернуть callback.
  • Зарегистрируйте собственные эталонные записи, если это необходимо. Если вы ведете учет эталонных файлов в Content ID, запросите доступ к пользовательскому каталогу (напишите на [email protected]) и загрузите их через POST api.audd.io/upload/.
  • Сформируйте реакцию на основе результата. Решите, что ваша платформа должна делать при обнаружении совпадения: заблокировать, пометить для проверки, прикрепить isrc/upc/лейбл для отчета о правах или собрать доказательства для удаления. Результат распознавания предоставляет вам поля; политика принятия решений остается за вами. Пример пошаговой реализации этого шага в готовом виде см. в рецептах сканера авторских прав и сбора доказательств для DMCA-удаления.
  • Проверьте работу с помощью фиксированных входных данных. Запустите https://audd.tech/example.mp3 через выбранный маршрут и убедитесь, что необходимые вам поля (isrc, upc, лейбл, временные метки) присутствуют перед запуском в продакшн.
  • Создать сканер авторских прав для пользовательского контента
  • Сгенерировать доказательства для DMCA-удаления
  • Публичная база данных против вашего пользовательского каталога
  • Справочник по API

О чём эта статья