تخطَّ إلى المحتوى
AR
الحصول على مفتاح 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:// أو طريق دليل. انظر أماكن التخزين for 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. ولا يزال الجسم الإعلامي خاضعا لسيارات دورة الحياة الخاصة بك. ويستند استخدام الحمولة إلى الحجم الفعلي للبيانات المحملة.