Langkau ke kandungan
MS
Dapatkan kunci API

YouTube Download / Python

Unduh audio YouTube ke ember S3 Anda

Kirimkan pengunduhan audio, lacak pekerjaan latar belakang dan dapatkan lokasi berkas MP3 yang dikirimkan.

FlashData · Diterbitkan

Sebuah bentuk gelombang audio yang dikirimkan ke penyimpanan objek

Siapkan baldimu

Anda perlu kunci Python 3, sebuah ember FlashData API dengan kredit yang tersedia, sebuah Amazon S3 dan kredensial penyimpanan yang dapat menulis ke ember tersebut. Simpan bukti itu di servermu.

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 wilayah embermu yang sebenarnya. MEDIA_BUCKET Nama ember, tanpa nama s3:// Awalan atau jalur direktori. Lihat Tetapan penyimpanan vatorium S3-compatible tujuan.

Kirim dan lacak unduhan

Simpan skrip sebagai delivery.py. Ini mengirimkan unduhan audio ke POST /v1/queries, memilih output 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

script mencetak pekerjaan ID sebelum polling. Simpan bahwa ID dalam aplikasi Anda sehingga sebuah start ulang atau timeout tidak kehilangan link untuk bekerja sudah diserahkan.

Bacalah penerimaan pekerjaan

Penyerahan unduhan mengembalikan penerimaan, bukan berkas media. Penerimaan yang dicatat ini berisi pekerjaan ID dan link yang digunakan untuk melacak kemajuan dan membaca hasil yang sebenarnya.

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

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

Use file yang dikirimkan

Setelah file diunggah, pekerjaan menjadi completed. Hasil endpoint redirect hasil endpoint untuk disimpan JSON; skrip mengikuti yang mengarahkan tanpa meneruskan kunci API ke penyimpanan.

Bacalah file_url, file_size dan medan format output daripada hasil. Untuk bucket peribadi, gunakan kelayakan storan anda bagi membaca fail atau mencipta pautan bertandatangan untuk pengguna akhir. URL fail itu sendiri tidak menjadikan objek awam.

Simpan pekerjaan itu JSON Hasil hasil dalam nya 24Masa retensi jam. Objek media ini tetap tunduk pada pengaturan daur hidup ember Anda. Penggunaan unduhan undload didasarkan pada volume data unduhan yang sebenarnya.