Ga naar de inhoud
NL
API-sleutel ophalen

YouTube Download / Python

Download YouTube audio naar uw S3 emmer

Stuur een audio download, volg de achtergrondtaak en haal de locatie van het geleverde MP3-bestand.

FlashData · Gepubliceerd

Een audiogolfvorm die wordt geleverd aan objectopslag

Maak je emmer klaar

Je hebt Python 3 nodig, een FlashData API sleutel met beschikbare credits, een Amazon S3 emmer en opslaggegevens die naar die emmer kunnen schrijven. Hou die referenties op je 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'

Gebruik je eigenlijke emmergebied. MEDIA_BUCKET is de naam van de emmer, zonder een s3:// prefix of een mappad. Zie de opslaginstellingen voor S3-compatibele bestemmingen.

Verzenden en volgen van de download

Het script opslaan als delivery.py. Het stuurt een audio download naar POST /v1/queries, kiest MP3-uitgang en biedt de S3 bestemming.

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

Het script drukt de taak ID af voordat het wordt ondervraagd. Sla dat ID op in uw toepassing, zodat een herstart of timeout de reeds ingediende link naar het werk niet verliest.

Lees het sollicitatiebewijs

Een download-inzending geeft een ontvangstbewijs terug, niet het mediabestand. Dit opgenomen ontvangstbewijs bevat de taak ID en de links die gebruikt worden om voortgang bij te houden en het uiteindelijke resultaat te lezen.

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

Gebruik dezelfde API-toets om de statuslink te lezen. Als de deadline van de peiling verstrijkt, houd de ID en controleer het later. Maak niet automatisch een vervangende baan aan.

Gebruik het afgeleverde bestand

Zodra het bestand is geüpload, de taak wordt completed. Het resultaat eindpunt verwijst naar opgeslagen JSON; het script volgt die redirect zonder het doorsturen van uw API sleutel naar opslag.

Gelezen file_url, file_size en de output-format velden van het resultaat. Voor een privé-emmer, gebruik uw opslaggegevens om het bestand te lezen of maak een ondertekende link voor uw eindgebruiker. Het bestand URL zelf maakt het object niet openbaar.

Bewaar de jobs JSON resultaat binnen de 24-uur retentie periode. Het media-object blijft onderworpen aan uw eigen emmers lifecycle instellingen. Downloaden gebruik is gebaseerd op de werkelijke gedownloade data volume.