İçeriğe geç
TR
API anahtarı al

YouTube Download / Python

YouTube sesinizi S3 kovanıza indirin

Bir ses indirmesini gönderin, arka plan işini takip edin ve teslim edilen MP3 dosyasının yerini alın.

FlashData · Yayınlanmış Yayınlanmış Yayınlandı

Bir ses dalgası depolama depolamak için teslim edildi

Kovanızı hazırlayın

Python 3, FlashData API anahtarına mevcut kredilerle ihtiyacınız var, Amazon S3 kova ve depolama bilgilerini bu kovaya yazabilirsiniz. Bu kimlikleri sunucunuzda tutun.

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'

Gerçek kova bölgenizi kullanın. MEDIA_BUCKET Kova adı, an olmadan s3:// ek veya bir dizi yol. Görün bakalım depolama ayarları S3 uyumlu yerler için.

Gönder ve indirmeyi takip edin

Senaryoyu kurtarmak olarak delivery.py. Bu, bir ses indirmesini gönderir POST /v1/queries, Ancak MP3 çıktısını seçin ve S3 destinasyonunu sağlar.

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

Senaryo, ID'u ankete başlamadan önce yazdırır. Uygulamanızda ID'u kurtarın, böylece bir yeniden başlatma veya zamanout, zaten sunulan çalışma bağlantısını kaybetmez.

İş makbulunu okuyun

Bir indirme teklifi bir makbuz döndürür, medya dosyası değil. Bu kayıt makbuzu iş ID ve ilerlemeyi takip etmek ve olaysal sonucu okumak için kullanılan bağlantıları içermektedir.

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

Durum bağlantısını okumak için aynı API anahtarı kullanın. Eğer anket süresi sona ererse, ID'u tut ve daha sonra kontrol edin. Otomatik olarak bir yedek iş yaratmaz.

Gönderilen dosyayı kullanın

Dosya yüklendikten sonra, iş olur completed. Sonuçlar, JSON'u depolamak için son nokta yönlendirmeleri yapar; senaryo, API anahtarınızı depolamak için yönlendirmeyi takip eder.

Read Oku file_url, file_size Ve sonuçtan gelen çıktı-format alanları. Özel bir kova için, dosyayı okumak veya son kullanıcınız için imzalanmış bir bağlantı oluşturmak için depolama kimliklerinizi kullanın. Dosya URL kendisini nesneyi halk haline getirmez.

İşin JSON sonucunu 24- saatlik bekletme süresi içinde kurtarın. Medya nesnesi kendi kovanızın yaşam döngüsüne tabi kalır. İndirme kullanımı gerçek indirilmiş veri hacmine dayanmaktadır.