🎌 Личный загрузчик без ограничений

Скачивайте всё
с YouTube

MP3, FLAC, 4K видео, плейлисты, обложки —
без рекламы, без капчи, без лимитов.

⬇ Скачать сейчас
音楽
✦ Возможности

Почему именно здесь?

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

Все аудио и видео форматы

MP3, M4A, OGG, FLAC, WAV, OPUS — для аудио. MP4, WebM, MKV — для видео. Качество аудио от 64 kbps до lossless, видео от 360p до 4K. Вы сами решаете, что нужно.

Плейлисты целиком

Вставьте ссылку на плейлист — получите полный список треков. Выберите нужные галочками и скачайте все сразу. Каждый трек обрабатывается параллельно.

Обложки и метаданные

Обложка вшивается прямо в MP3/FLAC/MP4 — видно в плеере, Telegram, VK Music. Отдельно скачивается как JPEG. Плюс полный JSON с описанием, тегами, главами и статистикой.

Файлы хранятся 24 часа

Скачали — не торопитесь. Файл лежит на сервере сутки. Можно вернуться через час, зайти с другого устройства, поделиться ссылкой. История хранится навсегда.

Субтитры прямо в видео

Вшиваем субтитры на любом языке (ru, en, de, fr...) прямо в MP4/MKV файл. Авторские и автоматически сгенерированные YouTube субтитры — выбирайте сами.

Личный кабинет

Войдите по email — и все загрузки в одном месте. Безлимитное скачивание, полная история, кнопки для повторного скачивания пока файл жив на сервере.

✦ Инструкция

Как пользоваться

Три шага — и файл у вас. Никакой регистрации для первого скачивания не нужно.

1

Вставьте ссылку на YouTube

Скопируйте URL и вставьте в поле. Подходят любые форматы ссылок:

  • https://www.youtube.com/watch?v=dQw4w9WgXcQ — обычная
  • https://youtu.be/dQw4w9WgXcQ — сокращённая
  • https://youtube.com/playlist?list=PLxxxxxx — плейлист
  • https://youtube.com/@channel/videos — канал или раздел
  • https://youtube.com/shorts/xxxxxxx — Shorts

Нажмите «Получить инфо» — покажем название, канал, длительность и превью перед скачиванием.

2

Выберите формат и настройки

Нажмите нужный формат: MP3 для музыки, MP4 для видео, FLAC для аудиофилов без потерь. Выберите качество, поставьте галочку «Обложка» если хотите встроенный арт, включите метаданные. Для плейлиста — выберите треки галочками и скачайте всё сразу.

3

Скачайте файл (и не только)

Прогресс виден в реальном времени: скачивание → конвертация → готово. Когда файл готов — появятся кнопки: ⬇ Скачать (основной файл), 🖼 Обложка (JPEG отдельно), 📄 JSON (полная информация о треке). Зарегистрированные пользователи могут вернуться в Кабинет и скачать повторно в течение 24 часов.

Скачать

Без регистрации — 1 бесплатное скачивание. Войдите по email — безлимитно.
9
форматов файлов
4K
максимальное видео
24ч
хранение на сервере
0₽
полностью бесплатно
∞
загрузок для аккаунта
✦ Поддерживаемые ссылки

Что можно скачать

Вставьте любую ссылку с YouTube — сервис автоматически определит тип и предложит нужные настройки. Работают все форматы URL, включая мобильные, короткие и ссылки на Shorts.

Видео
Обычное видео YouTube
youtube.com/watch?v=dQw4w9WgXcQ

Любое видео — клипы, лекции, подкасты, стримы, обзоры. Длина не ограничена: скачиваем и двухминутные, и восьмичасовые.

Shorts
YouTube Shorts
youtube.com/shorts/AbCdEfGhIjK

Короткие вертикальные видео. Конвертируются в MP3, MP4 и любой другой формат — точно так же, как обычные видео.

youtu.be
Сокращённая ссылка
youtu.be/dQw4w9WgXcQ

Короткие ссылки из кнопки «Поделиться» в приложении YouTube или браузере. Работают без дополнительных шагов.

Плейлист
Плейлист целиком
youtube.com/playlist?list=PLxxx

Сразу увидите список всех треков с названиями. Выберите нужные галочками и скачайте всё одним нажатием — каждый трек обрабатывается параллельно.

Канал
Раздел видео канала
youtube.com/@ChannelName/videos

Все видео с канала как большой плейлист. Работает с @handle, ID канала и классическими /user/ адресами.

YT Music
YouTube Music
music.youtube.com/watch?v=xxx

Ссылки прямо из YouTube Music. Те же видео, иногда с лучшим аудио потоком — особенно полезно для официальных альбомов и синглов.

С таймкодом
Ссылка с временной меткой
youtube.com/watch?v=xxx&t=120s

Временная метка игнорируется — скачивается видео целиком. Так работает большинство ссылок «Поделиться с этого момента».

Мобильная
Ссылки из мобильного браузера
m.youtube.com/watch?v=xxx

Ссылки из мобильного YouTube, приложений-браузеров и встроенных браузеров в Telegram или VK — обрабатываются без изменений.

🎵

Нарезка по главам — один клик

Многие YouTube-видео (лайвы, лонгриды, сборники, альбомы) содержат главы с таймкодами. Нажмите кнопку 🎵 Треки под скачанным файлом — сервис автоматически разрежет аудио по каждой главе и отдаст отдельные MP3 с правильными именами и обложками.

  • Каждый трек — отдельный файл с именем из главы
  • Обложка альбома встраивается в каждый MP3 / M4A
  • Все файлы доступны по прямым ссылкам из S3 — 48 часов
  • Через API можно запустить нарезку одним параметром: "split": true
✦ Форматы

Какой формат выбрать?

Поддерживаем 9 форматов — от компактного MP3 до lossless FLAC и 4K-видео. Разбираемся, что для чего.

MP3

Универсальный аудиоформат

Работает на любом устройстве и плеере. Качество от 64 до 320 kbps — для обычного прослушивания хватит 192 kbps. Меньше места, чем FLAC, но с небольшой потерей качества. Идеально для смартфона, машины, колонок.

FLAC

Без потерь для аудиофилов

Lossless-формат: сохраняет каждый бит оригинального звука. Файл больше MP3 в 3–5 раз, зато качество — точь-в-точь как в источнике. Подходит для Hi-Fi систем, студийного мониторинга, архивного хранения.

M4A

Аудио для Apple-экосистемы

Формат AAC в контейнере M4A — родной для iPhone, iPad, macOS и iTunes. При том же размере файла звучит лучше MP3. Поддерживает метаданные и обложки нативно. Оптимален если вы используете устройства Apple.

OGG / OPUS

Открытые форматы без лицензий

OGG Vorbis и OPUS — свободные кодеки. OPUS особенно хорош при низких битрейтах: 128 kbps OPUS звучит как 192 kbps MP3. Используется в WhatsApp, Telegram, Discord. Хорошая совместимость с Android.

MP4

Видео до 4K с любым качеством

Стандартный видеоформат — совместим со всеми устройствами и платформами. Выбирайте разрешение от 360p до 4K (2160p). Можно встроить субтитры, обложку и метаданные. Скачивается с лучшим видео и аудио потоком.

WebM / MKV

Контейнеры для профессионалов

WebM — открытый формат Google, отлично работает в браузерах. MKV — гибкий контейнер, вмещает любые кодеки, несколько аудиодорожек и субтитры. Оба подходят для сохранения видео в максимальном качестве.

✦ Сравнение

Чем отличаемся от других сервисов

Большинство онлайн-конвертеров YouTube2MP3 ограничивают форматы, показывают рекламу и не дают скачать плейлист. Мы — нет.

Функция YouTube2MP3.koderra.ru Типичный онлайн-сервис
Форматы аудиоMP3, FLAC, M4A, OGG, WAV, OPUSТолько MP3
Форматы видеоMP4, WebM, MKV до 4KMP4 до 1080p
Плейлисты✓ Целый плейлист с выбором треков✗ Только одно видео
Встроенная обложка✓ В MP3, FLAC, M4A, MP4✗
Субтитры в видео✓ Вшиваются в MP4/MKV✗
Метаданные✓ Исполнитель, альбом, год✗
JSON-информация о треке✓ Описание, теги, главы, статистика✗
История загрузок✓ Навсегда, в личном кабинете✗
Реклама✓ Полностью отсутствуетАгрессивная, 3–5 попапов
Ограничение на длину✓ Нет ограниченийЧасто до 15–20 минут
✦ О сервисе

Скачать MP3 с YouTube — просто и без лишнего

Как работает конвертер YouTube в MP3

Вы вставляете ссылку на видео — сервис получает информацию о нём через yt-dlp, один из лучших открытых загрузчиков видео. Затем скачивает аудиодорожку напрямую из YouTube и конвертирует её в нужный формат с помощью FFmpeg — профессионального инструмента для обработки медиафайлов.

Весь процесс занимает от нескольких секунд до минуты в зависимости от длины видео. Прогресс отображается в реальном времени. Готовый файл хранится на сервере 24 часа — скачивайте в любое удобное время.

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

Вставьте ссылку на плейлист — сервис покажет список всех треков с названиями и длительностью. Снимите галочки с тех, что не нужны, и нажмите «Скачать выбранные». Каждый трек обрабатывается параллельно, прогресс виден по каждому отдельно.

Плейлисты YouTube, подборки по каналу, результаты поиска — всё это можно скачать одним действием. Поддерживаются плейлисты любой длины.

Обложки треков и метаданные

При скачивании MP3 или FLAC вы можете включить опцию «Обложка в файл» — превью видео с YouTube будет вшито прямо в аудиофайл. Плееры на телефоне, в машине, в Telegram и VK Music покажут красивую картинку. Метаданные (название, исполнитель, альбом) прописываются автоматически. Дополнительно всегда доступен отдельный JPEG-файл с обложкой и JSON с полной информацией о треке.

Личный кабинет и история загрузок

Зарегистрируйтесь по email — и все ваши загрузки сохраняются в личном кабинете. Пока файл жив на сервере (24 часа), можно скачать повторно: с телефона, ноутбука, с другого браузера. После удаления файла запись в истории остаётся — видно, что и когда скачивалось. Лимит загрузок для зарегистрированных пользователей — безлимитный.

✦ FAQ

Часто задаваемые вопросы

Отвечаем на самые распространённые вопросы о скачивании музыки и видео с YouTube.

Как скачать MP3 с YouTube бесплатно?
Вставьте ссылку на видео YouTube в поле выше, нажмите «Получить инфо», выберите формат MP3 и нажмите «Скачать». Первое скачивание — бесплатно и без регистрации. Для безлимитного доступа войдите по email — регистрация занимает 30 секунд.
Можно ли скачать весь плейлист YouTube сразу?
Да. Вставьте ссылку на плейлист (например, youtube.com/playlist?list=...) — сервис покажет список всех треков. Выберите нужные галочками и нажмите «Скачать выбранные». Каждый трек скачается и сконвертируется параллельно.
Какое качество MP3 можно получить?
Максимальное качество зависит от исходного видео на YouTube. Для большинства видео доступно 192–320 kbps. В настройках выберите качество: от 64 kbps (компактно, для подкастов) до 320 kbps (максимальное, для музыки) или «Лучшее» (VBR — переменный битрейт, оптимальное соотношение качества и размера).
Как долго хранятся скачанные файлы?
Файлы хранятся на сервере 24 часа после скачивания. В течение этого времени вы можете скачать их повторно из Личного кабинета — с любого устройства. После 24 часов файл удаляется автоматически, но запись в истории остаётся навсегда.
Можно ли скачать видео в 4K?
Да, если YouTube предоставляет 4K-версию видео. Выберите формат MP4 (или WebM/MKV), в настройках качества выберите «4K (2160p)» — сервис скачает лучшую доступную версию. Обратите внимание: 4K-файлы могут весить несколько гигабайт.
Как встроить обложку в MP3-файл?
При выборе аудиоформата (MP3, FLAC, M4A и т.д.) поставьте галочку «🖼 Обложка в файл» перед нажатием «Скачать». Превью видео с YouTube будет автоматически вшито в аудиофайл. Дополнительно всегда доступна кнопка «🖼» для скачивания обложки отдельным JPEG-файлом.
Что такое формат FLAC и зачем он нужен?
FLAC (Free Lossless Audio Codec) — формат сжатия без потерь. В отличие от MP3, который убирает «незаметные» для уха частоты, FLAC сохраняет полностью весь звук оригинала. Файл весит в 3–5 раз больше MP3, зато качество идеальное. Выбирайте FLAC для Hi-Fi систем, студийного мониторинга или архивного хранения музыки.
Поддерживаются ли субтитры?
Да, для видеоформатов (MP4, MKV). Поставьте галочку «💬 Субтитры» и укажите нужные языки через запятую (например, ru,en). Субтитры будут скачаны — как авторские, так и автоматически сгенерированные YouTube — и вшиты прямо в видеофайл.
Нужна ли регистрация?
Нет — первое скачивание доступно без регистрации. Для безлимитного доступа и истории загрузок войдите по email: нажмите «Войти», введите email — на него придёт шестизначный код, после ввода которого вы авторизованы. Пароль не нужен.
Можно ли скачать YouTube Shorts в MP3?
Да. Shorts — это обычные короткие видео на YouTube. Вставьте ссылку вида youtube.com/shorts/xxx, выберите формат MP3 (или любой другой) и нажмите «Скачать». Сервис обработает его так же, как обычное видео.
Что такое нарезка по главам и как ей пользоваться?
Если YouTube-видео содержит главы (таймкоды в описании или на таймлайне), после скачивания появляется кнопка «🎵 Треки». Нажмите — сервис автоматически разрежет аудио на отдельные файлы по каждой главе, даст им имена из названий глав и встроит обложку. Это удобно для альбомов, лайвов и лонгридов, выложенных целиком.
Есть ли API для автоматического скачивания?
Да. Авторизованные пользователи могут получить API-ключ в разделе «API» и использовать его для программного скачивания. Поддерживается постановка задач на скачивание и нарезку по главам, хранение файлов в S3, опрос статуса задачи и получение готовых прямых ссылок. Подробная документация — в разделе API.

Мои загрузки

Готовые файлы хранятся на сервере 24 часа — можно вернуться и скачать в любой момент.
После истечения срока файл удаляется автоматически, но запись в истории остаётся навсегда.

💾 Файлы хранятся на нашем сервере и доступны только вам по вашей учётной записи. Скачайте их до истечения срока — после этого придётся загружать заново с YouTube.

Активные задачи

Загрузка...

История задач

Загрузка...

Настройки

Управляйте шаблонами имён файлов и другими параметрами аккаунта.

🗂 Шаблоны имён файлов

Имя файла формируется из шаблона. Используйте переменные в фигурных скобках — они заменятся реальными данными трека при скачивании.

{channel} — название канала / исполнителя
{title} — название видео / альбома
{id} — ID видео на YouTube
{chapter_num} — номер трека (01, 02…) только для глав
{chapter_title} — название главы только для глав
Примеры шаблонов
ШаблонРезультат файла
{channel} - {title}nireya-soviet-wave-1980s.mp3
{title}soviet-wave-1980s.mp3
{title} [{id}]soviet-wave-1980s-EIAsSYE33Po.mp3
{channel} - {chapter_num}. {chapter_title}nireya-01-polivoks-skyline.mp3
{chapter_num} {chapter_title}01-polivoks-skyline.mp3

Пробелы, точки и специальные символы автоматически преобразуются в дефисы. Кириллица транслитерируется в латиницу.

Используется когда скачиваешь весь трек целиком
Используется при нарезке по главам (кнопка «🎵 Треки» в кабинете)
⚙ Форматирование имён

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

Developer API

Программный доступ к сервису — ставьте задачи на скачивание и нарезку, получайте готовые файлы из S3.

🔑 Ваш API-ключ
Передаётся в заголовке X-Api-Key с каждым запросом. Кликните по ключу, чтобы показать.
ключ не сгенерирован
🧪 Playground — попробовать API
Введите одну или несколько ссылок (каждая на новой строке). Плейлисты будут автоматически разбиты на треки.
URLs (по одной на строке)
Эквивалентный curl-запрос:
— заполните поля выше —
Нужен сгенерированный API-ключ
Содержание
  1. Обзор
  2. Аутентификация
  3. POST /batch — создать пакет задач
  4. GET /batch/{id} — статус пакета
  5. GET /tasks/{id} — одна задача
  6. Статусы, ошибки и сроки хранения
  7. Структура ответа
  8. Примеры кода
1. Обзор

API позволяет программно скачивать аудио и видео с YouTube и других поддерживаемых платформ, автоматически загружать готовые файлы в S3-совместимое хранилище и при необходимости нарезать по главам. Всё асинхронно: вы отправляете задачу, получаете task_id, затем опрашиваете статус и забираете готовый JSON с presigned URL на файлы.

Форматы: MP3, M4A, FLAC, WAV, OGG, Opus (аудио) · MP4, WebM, MKV (видео)

Режимы скачивания:

split: false  Скачать трек → конвертировать → загрузить в S3. Ответ содержит ссылку на файл, обложку и info.json с полными метаданными.
split: true   Скачать → загрузить полный трек → нарезать по главам YouTube → загрузить каждую главу отдельно. Ответ содержит и полный трек, и список глав с индивидуальными ссылками.

Файлы хранятся 24 часа после завершения задачи. Задача с её результатами доступна бессрочно через GET-запрос — presigned URL в ответе обновляются при каждом обращении.

Base URL https://youtube2mp3.koderra.ru/api/v1
2. Аутентификация

Все запросы требуют API-ключ в заголовке X-Api-Key. Ключ генерируется выше — он привязан к вашему аккаунту.

HTTPX-Api-Key: ваш-ключ-здесь

⚠ Не передавайте ключ в URL-параметрах и не публикуйте его в открытом коде. При компрометации — отзовите и сгенерируйте новый.

3. Создать пакет задач
POST /api/v1/batch Отправить 1+ ссылок — плейлисты разбиваются автоматически

Передайте массив ссылок. Для каждой ссылки сервис автоматически определяет тип: одиночное видео, шортс или плейлист. Плейлисты раскрываются в отдельные задачи по каждому треку. В ответ возвращается batch_id и список созданных задач.

Тело запроса (JSON)
ПолеТипПо умолчаниюОписание
urls*string[]—Массив ссылок (максимум 50). Поддерживаются: одиночные видео, шортсы, плейлисты YouTube
formatoptstring"mp3" Аудио: mp3 m4a flac ogg wav opus   Видео: mp4 webm mkv
qualityoptstring"best"Разрешение для видеоформатов: best 2160p 1440p 1080p 720p 480p 360p
audio_qualityoptstring"192"Битрейт аудио в kbps: 320 256 192 128 64 0 (0 = без перекодирования)
splitoptbooleanfalseНарезать каждый трек по главам YouTube, если главы есть. Применяется ко всем задачам в пакете
Ответ 202 Accepted
JSON{ "batch_id": "a1b2c3d4-...", "status": "pending", "task_count": 8, // 1 одиночное видео + плейлист из 7 треков "tasks": [ { "task_id": "t1-uuid", "source_type": "single", "url": "https://youtu.be/abc", "playlist_index": null }, { "task_id": "t2-uuid", "source_type": "playlist_track", "url": "https://youtu.be/def", "playlist_index": 0 }, // ... остальные треки плейлиста ... ] }

Все задачи запускаются немедленно в фоне. Для опроса используйте batch_id или отдельные task_id.

4. Статус пакета
GET /api/v1/batch/{batch_id} Все задачи пакета с полными результатами
JSON{ "batch_id": "a1b2c3d4-...", "status": "processing", // pending / processing / done / partial "created_at": "2026-06-02T13:00:00+00:00", "format": "mp3", "audio_quality": "320", "split": false, "task_count": 3, "tasks": [ { "task_id": "...", "status": "done", "source": {...}, "track": {...}, "chapters": null }, { "task_id": "...", "status": "processing" }, { "task_id": "...", "status": "error", "error": "Video unavailable" } ] }

Статус пакета: done — все задачи завершены успешно; partial — часть завершена, часть с ошибкой; processing — есть незавершённые задачи.

5. Одна задача — полный результат
GET /api/v1/tasks/{task_id} Самодостаточный JSON с полным описанием задачи и файлами

Каждая задача полностью самодостаточна: содержит откуда взята (тип источника, плейлист, индекс), результат скачивания, обложку, chapters и presigned URL на все файлы.

Пока выполняется
JSON{ "task_id": "3f8a1c2d-...", "status": "processing", "created_at": "2026-06-02T13:00:00+00:00", "completed_at": null, "source": { "type": "playlist_track", // "single" | "playlist_track" "url": "https://youtube.com/watch?v=...", "format": "mp3", "split": false, "batch_id": "a1b2c3d4-...", "playlist_title": "Best of 2024", "playlist_index": 2 } }
Когда готово
JSON{ "task_id": "3f8a1c2d-...", "status": "done", "completed_at": "2026-06-02T13:02:14+00:00", "source": { "type": "single", "url": "...", "format": "mp3", "split": false, "batch_id": "...", "playlist_title": null, "playlist_index": null }, "track": { "title": "Never Gonna Give You Up", "channel": "Rick Astley", "duration": 213, "thumbnail_url": "https://i.ytimg.com/vi/.../maxresdefault.jpg", "expires_at": "2026-06-03T13:02:14+00:00", "file": { "filename": "rick-astley-....mp3", "size": 3414884, "s3_key": "...", "url": "https://s3...?X-Amz-..." }, "thumbnail": { "s3_key": "...", "url": "https://s3...?X-Amz-..." }, "info_json": { "s3_key": "...", "url": "https://s3...?X-Amz-..." } }, "chapters": null // или массив глав если split=true и главы найдены }

Поле chapters — массив с index, title, start_time, end_time, file, info_json для каждой главы. Если split: true, но глав нет — null.

5. Статусы, ошибки и сроки хранения
СтатусОписание
pendingЗадача принята, ожидает начала обработки
processingИдёт скачивание с YouTube и загрузка в S3
splittingТрек скачан, идёт нарезка по главам и загрузка в S3 (только при split: true)
doneГотово. Все файлы в S3, ссылки в ответе
errorОшибка. Поле error содержит описание

Рекомендуемый интервал опроса — каждые 3–5 секунд. Типичное время выполнения: 30–90 секунд для трека без нарезки, 2–10 минут для трека с нарезкой на 20+ глав.

Файлы хранятся 24 часа после завершения задачи (поле expires_at). Presigned URL в поле url действительны 48 часов — если ссылка истекла, повторно запросите задачу через GET, ответ содержит свежие presigned URL.

Ответ при ошибке (status: "error")
JSON{ "task_id": "3f8a1c2d-...", "status": "error", "created_at": "2026-06-02T13:00:00+00:00", "completed_at": "2026-06-02T13:00:12+00:00", "request": { "url": "...", "format": "mp3", "split": false }, "error": "ERROR: [youtube] dQw4w9WgXcQ: Video unavailable" }

Ошибки HTTP-уровня (неверный ключ, не найдена задача):

JSON// 403 — неверный или отсутствующий X-Api-Key { "detail": "API key required — pass X-Api-Key header" } // 404 — задача не найдена или принадлежит другому ключу { "detail": "Task not found" } // 422 — ошибка валидации тела запроса { "detail": [{ "loc": ["body", "url"], "msg": "field required", "type": "value_error.missing" }] }
6. Структура ответа
Корневые поля
ПолеТипОписание
task_idstringUUID задачи
statusstringТекущий статус (см. раздел 5)
created_atstring (ISO 8601)Время создания задачи
completed_atstring | nullВремя завершения
requestobjectПараметры запроса: url, format, split
errorstring | nullСообщение об ошибке (только при status=error)
trackobject | nullДанные трека (только при status=done)
chaptersarray | nullГлавы (только при split=true и status=done)
Объект track
ПолеТипОписание
titlestringНазвание видео
channelstringНазвание канала
durationintegerДлительность в секундах
thumbnail_urlstringПрямой URL обложки с YouTube
expires_atstringКогда файл будет удалён из S3
fileobjectfilename, size (байт), s3_key, url (presigned)
thumbnailobjects3_key, url (presigned) — обложка в S3
info_jsonobjects3_key, url — полный JSON с метаданными трека
Объект chapter (элемент массива chapters)
ПолеТипОписание
indexintegerПорядковый номер (начиная с 0)
titlestringНазвание главы
start_timefloatНачало в секундах
end_timefloatКонец в секундах
fileobjectfilename, size, s3_key, url (presigned)
info_jsonobjects3_key, url — JSON с метаданными этой главы
7. Примеры кода
Одно видео → MP3
bashcurl -X POST https://youtube2mp3.koderra.ru/api/v1/batch \ -H "X-Api-Key: ВАШ_КЛЮЧ" \ -H "Content-Type: application/json" \ -d '{"urls":["https://youtube.com/watch?v=dQw4w9WgXcQ"],"format":"mp3","audio_quality":"320"}'
Плейлист + одиночное видео → MP3, нарезать по главам
bashcurl -X POST https://youtube2mp3.koderra.ru/api/v1/batch \ -H "X-Api-Key: ВАШ_КЛЮЧ" \ -H "Content-Type: application/json" \ -d '{"urls":["https://youtube.com/playlist?list=PL...","https://youtu.be/abc123"],"format":"mp3","split":true}'
Опросить пакет
bashcurl https://youtube2mp3.koderra.ru/api/v1/batch/BATCH_ID \ -H "X-Api-Key: ВАШ_КЛЮЧ"
Опросить одну задачу / скачать файл
bashcurl https://youtube2mp3.koderra.ru/api/v1/tasks/TASK_ID \ -H "X-Api-Key: ВАШ_КЛЮЧ" # Скачать файл по presigned URL из ответа: curl -L -o track.mp3 "URL_ИЗ_ПОЛЯ_track.file.url"
pythonimport requests, time API_KEY = "ВАШ_КЛЮЧ" BASE_URL = "https://youtube2mp3.koderra.ru/api/v1" HEADERS = {"X-Api-Key": API_KEY} # 1. Создать пакет (плейлист + отдельное видео) batch = requests.post( f"{BASE_URL}/batch", headers=HEADERS, json={ "urls": [ "https://youtube.com/playlist?list=PL...", "https://youtube.com/watch?v=dQw4w9WgXcQ", ], "format": "mp3", "audio_quality": "320", "split": False, } ).json() batch_id = batch["batch_id"] print(f"Батч {batch_id}: {batch['task_count']} задач") # 2. Ждать завершения пакета while True: result = requests.get(f"{BASE_URL}/batch/{batch_id}", headers=HEADERS).json() print(f"Статус: {result['status']}") if result["status"] in ("done", "partial"): break time.sleep(5) # 3. Скачать все файлы for task in result["tasks"]: if task["status"] != "done": print(f" Ошибка: {task.get('error')}") continue src = task["source"] info = task["track"] label = f"{src['playlist_title']} #{src['playlist_index']}" if src["playlist_title"] else "single" print(f"[{label}] {info['title']}") audio = requests.get(info["file"]["url"]) with open(info["file"]["filename"], "wb") as f: f.write(audio.content) if task.get("chapters"): for ch in task["chapters"]: audio = requests.get(ch["file"]["url"]) with open(ch["file"]["filename"], "wb") as f: f.write(audio.content) print(f" Глава {ch['index']+1}: {ch['title']}")
javascriptconst API_KEY = 'ВАШ_КЛЮЧ'; const BASE_URL = 'https://youtube2mp3.koderra.ru/api/v1'; const headers = { 'X-Api-Key': API_KEY, 'Content-Type': 'application/json' }; async function pollTask(taskId, intervalMs = 4000) { while (true) { const data = await (await fetch(`${BASE_URL}/tasks/${taskId}`, { headers })).json(); if (data.status === 'done') return data; if (data.status === 'error') throw new Error(data.error); await new Promise(r => setTimeout(r, intervalMs)); } } async function pollBatch(batchId, intervalMs = 4000) { while (true) { const data = await (await fetch(`${BASE_URL}/batch/${batchId}`, { headers })).json(); if (data.status === 'done' || data.status === 'partial') return data; await new Promise(r => setTimeout(r, intervalMs)); } } (async () => { // Отправить плейлист + одиночное видео const batch = await (await fetch(`${BASE_URL}/batch`, { method: 'POST', headers, body: JSON.stringify({ urls: [ 'https://youtube.com/playlist?list=PL...', 'https://youtu.be/dQw4w9WgXcQ', ], format: 'mp3', audio_quality: '320', split: true, }) })).json(); console.log(`Батч ${batch.batch_id}: ${batch.task_count} задач`); // Ждать завершения всего пакета const result = await pollBatch(batch.batch_id); // Обработать каждую задачу for (const task of result.tasks) { if (task.status !== 'done') { console.warn('Ошибка:', task.error); continue; } const src = task.source; if (src.playlist_title) console.log(`[${src.playlist_title} #${src.playlist_index}] ${task.track.title}`); else console.log(task.track.title); console.log(' Файл:', task.track.file.url); task.chapters?.forEach(ch => console.log(` Глава ${ch.index + 1}: ${ch.title} → ${ch.file.url}`) ); } })();