Справочник
Структура фрагментированного ответа корпоративной конечной точки AudD (enterprise.audd.io): смещение для каждого фрагмента, оценка для каждой песни, ISRC/UPC, точные смещения и параметры запроса, управляющие фрагментацией.
view .md auddenterpriseoffsetstart_offset
Корпоративная конечная точка (POST https://enterprise.audd.io/) обрабатывает длинные аудиозаписи — полные песни, короткие видео, подкасты, трансляции, DJ-сеты — путем разбиения файла на 12-секундные фрагменты на стороне сервера и возвращая каждую распознанную дорожку. Ее ответ отличается по структуре от стандартной конечной точки: result представляет собой массив фрагментов, каждый из которых содержит свою позицию в файле и найденные в нем песни. На этой странице описана эта структура, поля для каждой песни и параметры запроса, управляющие фрагментацией. Информацию об ответе в виде одного объекта см. в справочнике полей результатов распознавания.
Структура ответа
result — это массив. Каждый элемент является одним фрагментом:
На верхнем уровне также передается execution_time (строка, например, "159.226763ms"), а status, как обычно, имеет значение "success".
Поля песни
Каждая запись в массиве songs фрагмента:
offset против start_offset / end_offset
Эти два параметра определяют совпадение в разных масштабах, и их путаница приводит к временным меткам, отличающимся на минуты.
- offset (для фрагмента) — это позиция в отправленном вами файле начала 12-секундного фрагмента, содержащего совпадение, в формате MM:SS или HH:MM:SS. Он определяет местоположение фрагмента в общем файле.
- start_offset / end_offset (для песни, только при accurate_offsets=true) — это позиции в миллисекундах внутри этого 12-секундного фрагмента, а не секунды файла. Они варьируются от 0 до примерно 12000.
Чтобы получить абсолютную позицию совпадения в файле, преобразуйте смещение фрагмента в секунды и добавьте start_offset песни, деленный на 1000:
Для фрагмента со смещением "04:48" и песни с start_offset 3520, совпадение начинается на 288 + 3.52 = 291.52 секунде файла.
Параметры запроса
Отправляются как multipart/form-data. Предоставьте аудио с помощью url (URL файла или страницы, который получает сервер) или file (multipart-загрузка). api_token обязателен для каждого запроса.
Всегда устанавливайте limit во время разработки. Корпоративная конечная точка тарифицируется за каждые 12 секунд обработанного аудио; неограниченный вызов может обработать часы аудио перед возвратом ответа. Устанавливайте небольшое значение limit при тестировании.
Всегда устанавливайте limit во время разработки. Корпоративная конечная точка тарифицируется за каждые 12 секунд обработанного аудио; неограниченный вызов может обработать часы аудио перед возвратом ответа. Устанавливайте небольшое значение limit при тестировании.
Примечания
- result — это массив, а не объект. Перебирайте фрагменты, затем перебирайте песни каждого фрагмента.
- Один фрагмент может вернуть несколько песен. Записи с более низким баллом в одном и том же фрагменте обычно представляют собой перекрывающееся или смешанное аудио, а не отдельные размещения.
- Типизированные SDK преобразуют массив фрагментов в единый список совпадений, но каждое совпадение содержит абсолютную позицию в файле в виде start_seconds и end_seconds (секунды от начала вашего файла). Они применяют формулу offset + start_offset/1000 внутри себя и по умолчанию запрашивают accurate_offsets=true, поэтому эти секунды точны — вам не нужны необработанный ответ или смещение фрагмента для определения совпадения. Необработанные start_offset/end_offset остаются доступными как миллисекунды относительно фрагмента. Используйте формулу напрямую только при самостоятельном вызове HTTP API.
- score, isrc и upc требуют план Startup или выше. На более низких планах эти поля отсутствуют в ответе.
- start_offset/end_offset присутствуют только тогда, когда в запросе установлено accurate_offsets=true.
- Контроль затрат Enterprise
- Создание треклиста DJ-сета
- Сбор доказательств для удаления по DMCA
- Поля результатов распознавания
- Глоссарий
- Справочник API
Читаете это как AI-агент? Необработанный Markdown находится в reference/enterprise-match-fields.md, а полный индекс — в /resources/llms.txt.
