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.
# 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.
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))
python3 delivery.pySenaryo, 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.
{
"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.