Lewati ke isi
ID
Dapatkan kunci API

YouTube Download / Python

Unduh YouTube audio ke Anda S3 bucket

Ajukan pengunduhan audio, lacak pekerjaan latar belakang dan ambil lokasi berkas MP3 yang dikirim.

FlashData · Diterbitkan

Waveform audio dikirim ke penyimpanan objek

Siapkan ember Anda

Anda perlu Python 3, a FlashData API kunci dengan kredit yang tersedia, sebuah Amazon S3 ember dan penyimpanan kredensial yang dapat menulis ke ember itu. Simpan surat mandat itu di server.

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'

Gunakan area ember yang sebenarnya. MEDIA_BUCKET adalah nama ember, tanpa s3:// prefiks atau sebuah path direktori. Lihat pengaturan penyimpanan untuk S3- tujuan yang cocok.

Kirim dan lacak pengunduhan

Simpan skrip sebagai delivery.py. Ini menyerahkan download audio ke POST /v1/queries, memilih keluaran MP3 dan menyediakan tujuan 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

Naskah mencetak pekerjaan ID sebelum polling. Simpan bahwa ID dalam aplikasi Anda sehingga sebuah restart atau timeout tidak kehilangan link ke kerja yang telah dimasukkan.

Baca tanda terima pekerjaan

Diserahkan download mengembalikan tanda terima, bukan berkas media. Tanda terima rekaman ini berisi pekerjaan ID dan link yang digunakan untuk melacak kemajuan dan membaca hasil akhirnya.

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"
    }
  ]
}

Gunakan kunci API yang sama untuk membaca link status. Jika batas waktu pemungutan suara berakhir, jaga ID dan periksa nanti. Jangan secara otomatis membuat pekerjaan pengganti.

Gunakan berkas yang dikirim

Setelah file diunggah, pekerjaan menjadi completed. Hasil dari titik akhir mengarahkan untuk disimpan JSON; skrip berikut yang mengarahkan kembali tanpa meneruskan kunci API Anda ke penyimpanan.

Baca file_url, file_size dan daerah output- format dari hasil. Untuk ember pribadi, gunakan kredensial penyimpanan Anda untuk membaca berkas atau membuat link ditandatangani bagi pengguna akhir Anda. Berkas URL sendiri tidak membuat objek publik.

Simpan hasil JSON dalam periode penahanan 24Q- jam. Objek media tetap tunduk pada pengaturan lifecycle ember Anda sendiri. Penggunaan unduhan didasarkan pada volume data yang diunduh yang sebenarnya.