Перейти до вмісту
UK
Отримати ключ 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-год. Предмет медіа залишається під загрозою настройок життєвого циклу відра. Завантажити використання базується на фактичному завантаженому обсязі даних.