Files
SnapOtter/apps/docs/ru/tools/audio/pitch-shift.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.2 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Повышение или понижение высоты тона аудио на полутоны без изменения скорости. 2804d0eeecc8 human 3a452a89aa8e

Сдвиг высоты тона

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

Конечная точка API

POST /api/v1/tools/audio/pitch-shift

Принимает данные формы multipart с аудиофайлом и полем settings в формате JSON.

Параметры

Параметр Тип Обязательный По умолчанию Описание
semitones integer Нет 3 Полутоны для сдвига (от -12 до 12). Должно быть отлично от нуля.

Пример запроса

curl -X POST http://localhost:1349/api/v1/tools/audio/pitch-shift \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@audio.mp3" \
  -F 'settings={"semitones": -5}'

Пример ответа

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
  "originalSize": 4500000,
  "processedSize": 4500000
}

Примечания

  • Положительные значения повышают высоту тона; отрицательные понижают её.
  • Сдвиг на 12 полутонов равен одной октаве вверх; -12 равен одной октаве вниз.
  • Длительность воспроизведения остаётся неизменной независимо от величины сдвига.
  • Вывод обычно сохраняет входной контейнер. Вход AAC записывается как M4A, а неподдерживаемые для декодирования входы откатываются к MP3.