Перейти к содержимому
RU
Ключ API

YouTube Download / Python

Загрузите аудио YouTube в свое ведро S3

Отправьте аудиозагрузку, отследите фоновую работу и получите местоположение доставленного MP3-файла.

FlashData · Опубликовано

Форма звуковой волны, доставленная в хранилище объектов

Приготовьте ведро

Вам нужен Python 3, ключ FlashData API с доступными кредитами, ведро Amazon S3 и учетные данные для хранения, которые могут записывать в это ведро. Держите эти учетные данные на своем сервере.

bash
# Replace YOUR_API_KEY near the top of the code below.
export YOUTUBE_VIDEO_ID='FUfGcZ092b0'
export MEDIA_BUCKET='your-media-bucket'
export AWS_REGION='us-east-1'
export MEDIA_ACCESS_KEY='your-storage-access-key'
export MEDIA_SECRET_KEY='your-storage-secret-key'

Используйте свой реальный регион. MEDIA_BUCKET Это название ведра, без s3:// Префикс или путь каталога. Видишь? настройки хранения Для S3-совместимых направлений.

Отправить и отследить загрузку

Сохранить сценарий как delivery.py. Он отправляет аудиозагрузку на POST /v1/queries, выбирает выход MP3 и предоставляет пункт назначения S3.

python
import json
import gzip
import os
import urllib.error
import urllib.request

API_URL = "https://data.flashdata.dev"
API_KEY = "YOUR_API_KEY"


def api_request(path, payload=None, response_headers=None, base_url=API_URL):
    target = path if path.startswith(("https://", "http://")) else base_url + path
    request = urllib.request.Request(
        target,
        data=json.dumps(payload).encode() if payload is not None else None,
        headers={"X-API-Key": API_KEY, "Content-Type": "application/json"},
        method="POST" if payload is not None else "GET",
    )
    with urllib.request.urlopen(request, timeout=60) as response:
        if response_headers is not None:
            response_headers.update(response.headers)
        return json.load(response)


class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, request, file_pointer, code, message, headers, new_url):
        return None


def result_request(url):
    request = urllib.request.Request(url, headers={"X-API-Key": API_KEY}, method="GET")
    try:
        with urllib.request.build_opener(NoRedirect).open(request, timeout=60):
            raise RuntimeError("Results endpoint did not redirect to storage")
    except urllib.error.HTTPError as response:
        if response.code != 302 or not response.headers.get("Location"):
            raise
        storage_url = response.headers["Location"]
        response.close()
    storage_request = urllib.request.Request(storage_url, headers={"Accept-Encoding": "gzip"})
    with urllib.request.urlopen(storage_request, timeout=60) as response:
        body = response.read()
        if response.headers.get("Content-Encoding") == "gzip":
            body = gzip.decompress(body)
        return json.loads(body)["results"]

import random
import time


def wait_for_job(submission, timeout_seconds=300):
    job_id = submission["id"]
    status_url = next(link["href"] for link in submission["links"] if link["rel"] == "self")
    deadline = time.monotonic() + timeout_seconds
    delay = 1.0
    while time.monotonic() < deadline:
        headers = {}
        payload = api_request(status_url, response_headers=headers)
        job = payload.get("job", payload)
        if job["status"] == "completed":
            results_url = next(link["href"] for link in job["links"] if link["rel"] == "results")
            return result_request(results_url)
        if job["status"] == "failed":
            raise RuntimeError(f"{job_id}: {job.get('error') or 'Job failed'}")
        hint = headers.get("Retry-After", headers.get("retry-after", "1"))
        delay = max(min(5.0, delay * 1.5), float(hint))
        time.sleep(min(delay * random.uniform(1.0, 1.2), max(0, deadline - time.monotonic())))
    raise TimeoutError(f"Keep this job ID and check again later: {job_id}")

storage = {
    "storage_type": "s3",
    "storage_url": os.environ["MEDIA_BUCKET"],
    "object_prefix": "YYYYMMDD",
    "region": os.environ["AWS_REGION"],
    "access_key": os.environ["MEDIA_ACCESS_KEY"],
    "secret_key": os.environ["MEDIA_SECRET_KEY"],
}

job = api_request("/v1/queries", {
    "source": "youtube_download",
    "video_id": os.environ["YOUTUBE_VIDEO_ID"],
    "params": {
        "download_type": "audio",
        "output_format": "mp3",
        "storage": storage,
    },
})
print("Save this job ID before polling:", job["id"], flush=True)
files = wait_for_job(job)
print(json.dumps(files, indent=2))
bash
python3 delivery.py

Сценарий печатает работу ID перед опросом. Сохраните этот ID в своем приложении, чтобы перезагрузка или тайм-аут не потеряли ссылку на уже представленную работу.

Прочитайте квитанцию о работе

Загрузка возвращает квитанцию, а не медиафайл. Эта запись квитанции содержит работу ID и ссылки, используемые для отслеживания прогресса и чтения конечного результата.

json
{
  "id": "job_d265c693-950e-40bf-a13e-a432044d99ba",
  "source": "youtube_download",
  "status": "pending",
  "usage": {
    "credits": 0
  },
  "created_at": "2026-09-16T07:51:13.139Z",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_d265c693-950e-40bf-a13e-a432044d99ba",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_d265c693-950e-40bf-a13e-a432044d99ba/results",
      "method": "GET"
    }
  ]
}

Используйте тот же ключ API, чтобы прочитать ссылку состояния. Если срок голосования истекает, сохраните ID и проверьте его позже. Не создавайте автоматически замену.

Используйте доставленный файл

После того, как файл загружен, работа становится completed. Конечная точка результатов перенаправляет на сохраненный JSON; следует сценарий, который перенаправляет без пересылки ключа API на хранилище.

Читать file_url, file_size и поля выходного формата от результата. Для частного ведра используйте свои учетные данные для чтения файла или создайте подписанную ссылку для вашего конечного пользователя. Файл URL сам по себе не делает объект общедоступным.

Сохранить результат работы JSON в течение периода удержания 24. Медиа-объект остается предметом настроек жизненного цикла вашего собственного ведра. Использование загрузки основано на фактическом объеме загруженных данных.