YouTube to MP3 API

Автор Команда Tunelio·Опубликовано 13 июн. 2026

Нужно конвертировать видео YouTube в MP3 внутри своего приложения, бота или бэкенда? YouTube to MP3 API делает это программно — без браузера и ручных загрузок. В этом руководстве показано, как получить прямую ссылку на MP3 из ссылки на YouTube одним запросом к Tunelio API.

Что делает YouTube to MP3 API

Вместо парсинга страниц или локального конвертера вы отправляете ссылку на YouTube на endpoint и получаете готовую ссылку на MP3, которая отдаётся прямо из нашего потокового туннеля. Ваши серверы остаются лёгкими, а ответы быстрыми — идеально для Telegram-ботов, веб-приложений и автоматизаций.

Ссылка на MP3 одним запросом

Вызовите GET /create с quality=mp3. Поле url в ответе — прямая подписанная ссылка на скачивание MP3; отдельного шага конвертации, которого нужно ждать, нет.

curl "https://tunelio.dev/create?url=https://youtu.be/dQw4w9WgXcQ&quality=mp3" \
  -H "Authorization: Bearer tnl_your_api_key"

{
  "url": "https://tunelio.dev/tunnel?id=…&sig=…",
  "filename": "Example Video.mp3",
  "quality": "mp3",
  "mode": "audio",
  "file_size_str": "3.29 MB",
  "status": "ok"
}

Python

import os, requests

resp = requests.get(
    "https://tunelio.dev/create",
    params={"url": "https://youtu.be/dQw4w9WgXcQ", "quality": "mp3"},
    headers={"Authorization": f"Bearer {os.environ['TUNELIO_KEY']}"},
)
print(resp.json()["url"])  # прямая ссылка на MP3

Node.js

const res = await fetch(
  "https://tunelio.dev/create?" + new URLSearchParams({
    url: "https://youtu.be/dQw4w9WgXcQ",
    quality: "mp3",
  }),
  { headers: { Authorization: "Bearer " + process.env.TUNELIO_KEY } }
);
const data = await res.json();
console.log(data.url); // прямая ссылка на MP3

Сначала узнайте размер аудио (по желанию)

Если хотите показать размер файла до загрузки, сначала вызовите GET /info. Его объект audioFormat сообщает контейнер MP3 и точный размер в байтах для этого видео, так что в интерфейсе можно показать «3.29 MB» ещё до того, как пользователь нажмёт «скачать».

Почему разработчики выбирают Tunelio для YouTube to MP3

• Один запрос, без опроса статуса — ссылка на MP3 приходит сразу.
• Надёжная потоковая доставка со стабильными ссылками для продакшена.
• Щедрый бесплатный уровень — 100 кредитов при регистрации, далее тарифы от $9/мес.

Советы для продакшена

Кешируйте url из каждого ответа /create и переиспользуйте его до истечения, вместо того чтобы вызывать endpoint на каждую загрузку — это экономит кредиты, когда один трек запрашивают много пользователей. А поскольку ссылка на MP3 — обычный HTTPS GET, её можно отдать Telegram-боту через метод sendAudio или стримить в хранилище, не буферизуя весь файл в памяти.

Дальше

Прочитайте полную документацию API об аутентификации, лимитах и всех параметрах — или возьмите 100 бесплатных кредитов и попробуйте endpoint YouTube to MP3 прямо сейчас.