Siapkan ember Anda
Anda perlu Python 3, a FlashData API kunci dengan kredit yang tersedia, sebuah Amazon S3 ember dan penyimpanan kredensial yang dapat menulis ke ember itu. Simpan surat mandat itu di server.
# 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 area ember yang sebenarnya. MEDIA_BUCKET adalah nama ember, tanpa s3:// prefiks atau sebuah path direktori. Lihat pengaturan penyimpanan untuk S3- tujuan yang cocok.
Kirim dan lacak pengunduhan
Simpan skrip sebagai delivery.py. Ini menyerahkan download audio ke POST /v1/queries, memilih keluaran MP3 dan menyediakan tujuan S3.
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.pyNaskah mencetak pekerjaan ID sebelum polling. Simpan bahwa ID dalam aplikasi Anda sehingga sebuah restart atau timeout tidak kehilangan link ke kerja yang telah dimasukkan.
Baca tanda terima pekerjaan
Diserahkan download mengembalikan tanda terima, bukan berkas media. Tanda terima rekaman ini berisi pekerjaan ID dan link yang digunakan untuk melacak kemajuan dan membaca hasil akhirnya.
{
"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"
}
]
}Gunakan kunci API yang sama untuk membaca link status. Jika batas waktu pemungutan suara berakhir, jaga ID dan periksa nanti. Jangan secara otomatis membuat pekerjaan pengganti.
Gunakan berkas yang dikirim
Setelah file diunggah, pekerjaan menjadi completed. Hasil dari titik akhir mengarahkan untuk disimpan JSON; skrip berikut yang mengarahkan kembali tanpa meneruskan kunci API Anda ke penyimpanan.
Baca file_url, file_size dan daerah output- format dari hasil. Untuk ember pribadi, gunakan kredensial penyimpanan Anda untuk membaca berkas atau membuat link ditandatangani bagi pengguna akhir Anda. Berkas URL sendiri tidak membuat objek publik.
Simpan hasil JSON dalam periode penahanan 24Q- jam. Objek media tetap tunduk pada pengaturan lifecycle ember Anda sendiri. Penggunaan unduhan didasarkan pada volume data yang diunduh yang sebenarnya.