تخطَّ إلى المحتوى
AR
الحصول على مفتاح API
تصفح الوثائق

مرجع API

YouTube Download API

احصل على مفتاح API

تحميل فيديو YouTube أو الصوت لتخزين السحابة الخاص بك. اختصار القرار، والشكل، ومدة الشظايا، ثم تتبع العمل غير المتناهي عن طريق الإنجاز.

واجهة API لتنزيل فيديوهات YouTube — أمثلة Python

إنشاء طلب

المعرّف المكوّن من 11 حرفًا في رابط الفيديو، وليس الرابط الكامل.

خيارات وسائط الإعلام المتقدمة

ويتجاوز اختيار الشكل الجودة، ومعدل الإطار، واختيار اللغة السمعية. ولا يزال شكل النواتج وربطات الشظايا سارية. ويجب أن تُبدأ نهاية الشفاه؛ ويمكن إغفال أي من الحدود.

الوجهة المخزنة

ويستخدم (بلانك) تاريخ تحميل رابع كلوريد الكربون (YYYYMDD).

أضف أوراق إعتمادك على خادمك قبل تشغيل الشفرة يحتاجون الإذن بتحميل الملفات

وثائق تفويض المورد واحتياجات التخزين
موقع الإنجاز على الإنترنتحمولة المواقع الشبكية والتحقق منها ومخازنها

وتطبق شركة Markdown على النتائج المنجزة. وتحتفظ المقبوضات وحالة العمل بميادينها الأصلية.

POSThttps://data.flashdata.dev/v1/queries
import gzip
import json
import random
import time
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_download",
    "video_id": "jNQXAC9IVRw",
    "params": {
        "download_type": "audio_video",
        "video_quality": "<=720",
        "audio_language": "default",
        "upload_metadata": False,
        "output_format": "mp4",
        "storage": {
            "storage_type": "s3",
            "storage_url": "your-media-bucket",
            "access_key": "YOUR_ACCESS_KEY",
            "secret_key": "YOUR_SECRET_KEY",
            "region": "us-east-1",
        },
    },
}

def api_get(url):
    request = urllib.request.Request(url, headers={"X-API-Key": api_key})
    with urllib.request.urlopen(request, timeout=60) as response:
        return json.load(response), response.headers

class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, request, file_pointer, code, message, headers, new_url):
        return None

def read_result(url):
    request = urllib.request.Request(url, headers={"X-API-Key": api_key})
    try:
        with urllib.request.build_opener(NoRedirect).open(request, timeout=60):
            raise RuntimeError("Expected a result redirect")
    except urllib.error.HTTPError as response:
        if response.code != 302 or not response.headers.get("Location"):
            raise
        storage_url = response.headers["Location"]
        response.close()
    # Never forward the API key to storage.
    with urllib.request.urlopen(urllib.request.Request(storage_url, headers={"Accept-Encoding": "gzip"}), timeout=60) as response:
        content = response.read()
        if response.headers.get("Content-Encoding") == "gzip":
            content = gzip.decompress(content)
        return json.loads(content)

def link(job, relation):
    return next(item["href"] for item in job["links"] if item["rel"] == relation)

request = urllib.request.Request(
    "https://data.flashdata.dev/v1/queries",
    data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
    headers={"Content-Type": "application/json", "X-API-Key": api_key},
    method="POST",
)
with urllib.request.urlopen(request, timeout=120) as response:
    submission = json.load(response)
jobs = submission.get("queries", [submission])
for submitted in jobs:
    print("Job:", submitted["id"])
    deadline = time.monotonic() + 300
    while time.monotonic() < deadline:
        status, headers = api_get(link(submitted, "self"))
        job = status.get("job", status)
        if job["status"] == "completed":
            result = job.get("result") if submitted["source"] == "youtube_download" and job.get("result") is not None else read_result(link(submitted, "results"))
            print(json.dumps(result, ensure_ascii=False, indent=2))
            break
        if job["status"] == "failed":
            raise RuntimeError(f"{submitted['id']}: {job.get('error', 'Job failed')}")
        hint = headers.get("Retry-After", "1")
        delay = max(1, min(5, int(hint))) if hint.isdigit() else 5
        time.sleep(min(delay * random.uniform(1, 1.2), max(0, deadline - time.monotonic())))
    else:
        raise TimeoutError(f"Still running; save this job ID: {submitted['id']}")
إيصال العمل، ثم استطلاع النتائجX-API-Key authentication

البارامترات

أرسل source و video_id على المستوى الأعلى خيارات المصادر تنتمي إلى params. ويمكن إغفال الحقول الاختيارية.

نص الطلب

sourcestring / مطلوب
جاهزون إلى youtube_download.
video_idstring / مطلوب
معرّف فيديو YouTube من 11 محرفًا، مثل FUfGcZ092b0. يقبل الحروف والأرقام والشرطات السفلية والواصلات.
بالضبط 11 الشخصياتالتقصير: غير محدد
الشكل المقبول^[A-Za-z0-9_-]{11}$
paramsobject / مطلوب
Settings for this request.
callback_urlstring · nullable / اختياري
لـ async وbatch فقط. رابط HTTPS عام للإشعار بالاكتمال على المنفذ 443، بطول يصل إلى 2,048 حرفًا، دون بيانات اعتماد مستخدم أو جزء رابط. احذف القيمة أو استخدم null أو سلسلة فارغة لعدم إرسال إشعار. في batch، ضعه في كل استعلام خارج params.
التقصير: غير محدد

صوت فيديو

params.download_typestring / اختياري
ويدمج audio_video الفيديو والصوت؛ ويختار الفيديو فقط؛ ويختار الصوت فقط.
1 إلى 11 الشخصياتالقيمة: audio_video / video / audioالتقصير: "audio_video"
params.video_qualitystring / اختياري
انتقاء قرارات الفيديو. ابدأوا بالحملات الصوتية فقط.
1 إلى 40 الشخصياتالقيمة: best / worst / <=144 / ==144 / >=144 / <=360 / ==360 / >=360 / <=480 / ==480 / >=480 / <=720 / ==720 / >=720 / <=1080 / ==1080 / >=1080 / <=1440 / ==1440 / >=1440 / <=2160 / ==2160 / >=2160 / <=4320 / ==4320 / >=4320التقصير: "<=720"
params.fpsstring / اختياري
قيد معدل الإطارات: >= أو <= أو == متبوعًا بقيمة من 1 إلى 240. احذفه عند تنزيل الصوت فقط.
1 إلى 6 الشخصياتالتقصير: غير محدد
الشكل المقبول^(?:>=|<=|==)(?:[1-9]\d?|1\d\d|2[0-3]\d|240)$
params.audio_languagestring / اختياري
اختيار المسار الصوتي. Applies to audio_video وصوت.
1 إلى 8 الشخصياتالقيمة: default / originalالتقصير: "default"
params.audio_qualitystring / اختياري
مرّت بشكل مُطلق في الكبسولة، أو أفضل. يجب أن تُرسل خيارات عديدة كخيوط. قم بتحميل الفيديو.
1 إلى 10 الشخصياتالقيمة: best / 320 / 256 / 192 / 128التقصير: "best"
params.output_formatstring / اختياري
Video: mp4, webm or mkv. Audio: m4a, mp3 or opus.
1 إلى 10 الشخصياتالقيمة: mp4 / webm / mkv / m4a / mp3 / opusالتقصير: mp4 (video) / m4a (audio)
params.yt_dlp_formatstring / اختياري
محدّد صيغة متقدم، من 1 إلى 1,024 حرفًا بعد حذف الفراغات المحيطة. تُرفض محارف التحكم. يتجاوز video_quality وfps وaudio_language، فتُتجاهل قيمها؛ وتبقى صيغة الإخراج والاقتطاع ساريتين.
1 إلى 1,024 الشخصياتالتقصير: غير محدد
params.upload_metadataboolean / اختياري
تحميل البيانات الوصفية JSON ملف بجانب ملف الإعلام في مخزنك
true أو falseالتقصير: false

Clipping

params.start_atstring / اختياري
Clip start in H:MMM:SS/H:MMM:SS format, from 00:00:00 to 12:00:00. Defaults to 00:00:00 when only end_at is supplied.
1 إلى 8 الشخصياتالتقصير: غير محدد
الشكل المقبول^\d{1,2}:[0-5]\d:[0-5]\d$
params.end_atstring / اختياري
Clip end in H:MMM:SS/H:MM:SS:SS format, up to 12:00:00. لا بد أن يكون في وقت لاحق من start_at.
1 إلى 8 الشخصياتالتقصير: غير محدد
الشكل المقبول^\d{1,2}:[0-5]\d:[0-5]\d$

الوجهة المخزنة

params.storageobject / مطلوب
تحديد ملفات إعلامية كاملة. ولا تقبل سوى حقول التخزين المدرجة في القائمة.
params.storage.storage_typestring / مطلوب
مورد تخزين: S3, s3_compatible, os, gcs, azure, cos, bos or tos.
params.storage.storage_urlstring / مطلوب
دلو غير فارغ أو اسم حاويات، إلى جانب شخصيات 1,024. ازالة الفضاء الأبيض المحيط (ب) فيما يتعلق برقم 3، استخدام اسم دلو صالح من طراز AWS بدون ممر من طراز URL أو مسار الملف؛ وتنتمي الملفات إلى object_prefix.
params.storage.object_prefixstring / اختياري
Object-key prefix, 1 to 512 characters. ويقبل كل جزء مفصّل من أجزاء " ASCII " رسائل وأرقام ونقطات، وتأكيدات وهيفنز؛ وشرائح فارغة، و... مرفوضة. لا يوجد صدع رئيسي ازالة الفضاء الأبيض المُحيط وقطعة أثرية واحدة YYYMDD uses the UTC upload date, including in archive/YYYYMMDD.
التقصير: "YYYYMMDD"
params.storage.access_keystring / اختياري
مفتاح وصول لـ S3 أو S3-compatible أو OSS أو COS أو BOS أو TOS؛ ويُستخدم مع secret_key.
params.storage.secret_keystring / اختياري
مفتاح سري لـ S3 أو التخزين المتوافق مع S3 أو OSS أو COS أو BOS أو TOS.
params.storage.endpoint_urlstring / اختياري
Public HTTPS endpoint for S3-compatible storage or OSS. COS, BOS and TOS extract it from region.
params.storage.regionstring / اختياري
(ب) الاحتياجات من المعدات المملوكة للوحدات، والمخزونات من السلع الأساسية، والتصنيفات؛ وكذلك الإمدادات من الـ S3 و S3-compatible downloads. (أسماء دلو (كوس تشمل (آي بي دي
params.storage.service_accountobject / اختياري
حساب خدمة GCS: الحقول project_id وclient_email وprivate_key بصيغة PEM.
params.storage.account_namestring / اختياري
اسم حساب تخزين Azure. استخدام اسم الحاوية في storage_url.
params.storage.sas_tokenstring / اختياري
حاويات SAS SAS التي تحمل حرف Azure والتي تحمل صلاحيتها وتوقيعها.

استجابة

ويُقدم مبني الطلب التحميلات إلى شركة Async أو Batch ويحتاج إلى params.storage. HTTP 200 مع status: pending يؤكد القبول، وليس التسليم Batch Returns one job receipt per video ID.

Submission usage.credits هو 0. وتُدوَّن عمليات التنزيل بحجم وسائط الإعلام المُسلَّمة بعد النجاح في التنفيذ؛ ولا تُضاف ملفات البيانات الوصفية الاختيارية إلى رسوم تحميلها.

Poll job.status حتى completed, ثم استرجع النتيجة JSON. قراءة تفاصيل وسائط الإعلام results[0], بما في ذلك الجسم المحمل file_url, حجم الملف و الشيكوم

اقرأ النتيجة

وبعد إتمام العمل، وفر الـ JSON من وصلة النتائج التي تربطه بها كـ response.json. احفظ هذا read-response.py و اركضوا بيثون read-response.py. ويقرأ التقرير تفاصيل الملف دون تحميل وسائط الإعلام أو تقديم طلب آخر.

read-response.py
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = {name: result.get(name) for name in (
    "file_url", "file_size", "md5", "duration", "output_format"
)}
# Use your storage credentials to access the media at file_url.
print(json.dumps(output, ensure_ascii=False, indent=2))

قد تشمل الحالة تفاصيل وسائط الإعلام job.result. استخدام تدفقات العمل التي تستخدمها شركة JSON عند توافرها وتتبعها بطريقة أخرى rel: results الصلة؛ لا تفترض أن هناك دائماً نتيجة خطية.

جميع مجالات الاستجابة
الميدانالوصف
idstringوظيفة تحميل ID.
sourcestringyoutube_download.
statusstringفي انتظار قبول الوظيفة.
created_atstringوقت خلق الوظائف في شكل ISO 8601.
usage.creditsnumber0 at submission. وتُحمَّل الحمولات بحجم البيانات المُسلَّمة بعد إتمامها.
linksarray(ب) أن تتبع الصلة الذاتية فيما يتعلق بحالة العمل والصلة بين النتائج لإنجاز النواتج.
links[].relstringذاتي أو نتائج.
links[].hrefstringURL to query with the same API key.
links[].methodstringGET.
حقول ملفات وسائط الإعلام المنجزة
الميدانالوصف
results[0].file_urlstringموقع ملف الإعلام في مخزنك
results[0].file_sizeintegerحجم ملف وسائل الإعلام في الصدر.
results[0].downloaded_bytesintegerوسائل الإعلام المرسلة تستخدم في الفواتير.
results[0].md5stringMD5 checksum of the media file.
results[0].resolutionstring · nullable- قرار فيديو، أو null بالنسبة للناتج الصوتي فقط أو الارتفاع غير المتوفر.
results[0].durationnumber · nullableمدة في ثواني عندما تكون متاحة.
results[0].output_formatstringاستمارة ملف النواتج
results[0].fpsnumber · nullableمعدل الصدمة عند توافرها.
results[0].video_codecstring · nullableشفرة الفيديو عندما تكون متاحة
results[0].audio_codecstring · nullable(أديو كودك) عندما يكون متاحاً
results[0].dynamic_rangestring · nullableالمدى الحركي للفيديو عند توافره.
results[0].metadataobject · optionalMetadata file_url, file_size and md5 when upload_metadata is true. وتُستبعد من رسوم التنزيل البيانات الفوقية.

وتصف المجالات المذكورة أعلاه رد شركة JSON. وتنطبق خيارات الشكل على سجل التسليم، وليس على ملف وسائط الإعلام. JSON, plain text and Markdown formats.

Async ' batch lifecycle

يعيد الإرسال إيصالًا وليس نتائج. ينشئ Async مهمة واحدة؛ ويعيد batch مهمة مستقلة في queries[] لكل سؤال مقبول تتبع كل وظيفة واسترجاعها بشكل مستقل.

Submit to data.flashdata.dev; قراءــة مركز العمل والنتائج api.flashdata.dev مع نفس X-API-Key. وتستخدم الأمثلة الأساسية للزدحام الزكسكسيك ذات الصلة API Python و cURL.

  1. 1. وفّر الوظيفة IDs

    (ج) تقديم حمولة واحدة مع Async، أو وضع طلبات تحميل متعددة داخل صفيفة أسئلة من طراز Batch. كل بند يحتاج إلى params.storage. انقذوا كل عمل ID.

    Async Request and receipt · Batch

  2. 2. حالة التحقق

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: استطلاع مع التأخير والاحترام Retry-After عندما تكون حاضراً completed: تحقيق النتائج failed: التفتيش job.error.

    اقرأ job.statusليس حالة إيصال المعلومات.

    مركز التحقير: Python و cURL

    المرجعي API
  3. 3. نتائج الرسم

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    بعد الإكمال، توثّق النتيجة على النحو التالي، ثمّ تُحضر مخزن 302 URL بدون مفتاحك API. وفّر الرقم JSON في غضون ساعات الإنجاز من تاريخ الـ 24.

    The JSON يصف وسائل الإعلام التي تم تسليمها إلى مخزنك الاطلاع على ملف وسائط الإعلام.

    نتائج المشاهدة: Python و cURL · تنسيقات الاستجابة

    Result download API reference

ولا تستهلك السياسات وتحقق النتائج القائمة أي تنازلات للأسئلة. ولا يلغى وقت الاقتراع هذا العمل: فإبقاء مقره ID بدلاً من تقديم عمل مكرر قابل للتعديل. شفرات الرعب وسلوك الاعادة.

إشعارات Webhook عند الاكتمال

Subscribe per query

المجموعة callback_url على أعلى مستوى لطلب الأسينك، أو داخل كل استفسار في دفعة، في الخارج params. ولا يلزم طلب تسجيل منفصل على الشبكة العالمية.

استخدم عنوان HTTPS عامًا على المنفذ 443. ترسل FlashData إشعار POST لكل مهمة تصل إلى completed أو failed; The event contains links, not the result itself.

الاعتراف والتحقق

العودة 2xx بعد قبول الحدث بشكل مكثف. مُتَوَجَّل delivery_id, كما أُرسلت X-Delivery-Id. لا تتبع إعادة التوجيه.

عمليات التسليم الفاشلة تُعاد مع التراجع المفاجئ، حتى 8 مجموع المحاولات على الأكثر 24 بعد ساعات من الانتهاء. استمر في الاقتراع كتراجع

النداءات غير موقعة. تأكد من معرّف المهمة ومصدرها وحالتها النهائية باستخدام نقطة نهاية الوضع الموثقة قبل تجهيز الإخطار. التسليم ID هو للتحلل، وليس إثبات صحة.

مناسبة وميادين على الشبكة العالمية
الإخطار بالإكمال التوضيحي
{
  "delivery_id": "completion:job_example0001",
  "id": "job_example0001",
  "source": "youtube_download",
  "status": "completed",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
      "method": "GET"
    }
  ]
}
الميدانالوصف
delivery_idstringمعرّف تسليم ثابت. امنع تكرار الإشعارات باستخدام هذه القيمة؛ وتُرسل أيضًا في ترويسة X-Delivery-Id.
idstringوظيفة(ب) ID.
sourcestringطلب مصدر بيانات.
statusstringاكتملت أو فشلت
linksarrayوصلات الوضع والنتائج. ولا تشمل الإخطارات محتوى النتائج أو مفتاحاً من طراز API.
links[].relstringذاتي أو نتائج.
links[].hrefstringعنوان URL كامل لواجهة الإدارة؛ صادِق باستخدام مفتاح API.
links[].methodstringGET.

عقد كامل على الشبكة العالمية وقيود URL

تجهيز ملفات Bulk

تحميل شريط فيديو واحد من طراز ID لكل خط وإنشاء وظيفة من طراز Bulk مع المصدر: youtube_download. وتنطبق الخيارات المشتركة على كل شركة ID في الملف.

وضع وجهة التخزين المطلوبة في options.storage and media settings in options. وظيفة واحدة Batch استخدام الحمولات params.storage بدلاً من ذلك

الملفات الإعلامية تم تسليمها إلى مخزن السحابة الخاص بك. وتشمل نتيجة " Bulk " المكتملة أجزاء من البيانات والنتائج تصف عمليات التنزيل. وفّر البيان وقطعه في غضون ساعات العمل التي تنجزها شركة 24 بعد أن اكتملت جميع وظائف شركة Bulk.

Bulk processing API ; Python and cURL · Batch JSON

بناء تدفق عمل من طراز Bulk لهذا المصدر · وقف، واستئناف واستعادة

تنزيل الفيديوهات بالجملة — أدوات Python

الوجهة المخزنة

Include params.storage في كل طلب تحميل المجموعة storage_url إلى سطلك أو اسم الحاويات و وثائق التفويض المزودة برخصة الدخول احتفظ بوثائق التخزين على خادمك

params.storage · S3-compatible destination
{
  "storage_type": "s3_compatible",
  "storage_url": "your-media-bucket",
  "object_prefix": "archive/YYYYMMDD",
  "endpoint_url": "https://your-s3-endpoint.example.com",
  "region": "your-provider-region",
  "access_key": "<storage-access-key>",
  "secret_key": "<storage-secret-key>"
}

object_prefix التقصير إلى YYYYMMDD, استبدلت بموعد تحميل المفاعلات استخدام دليل ثابت أو نموذج مثل archive/YYYYMMDD.

s3
Provide access_key and secret_key with written access. جهزوا المنطقة إلى منطقة الدلو الخاصة بكم
s3 مثال
params.storage · s3
{
  "storage_type": "s3",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "us-east-1"
}
s3_compatible
الإمداد access_key, secret_key and a public HTTPS endpoint_url. (ب) أن تحدد المنطقة حسب ما يطلبه مقدمك؛ Cloudflare R2 تستخدم آليا.
s3_compatible مثال
params.storage · s3_compatible
{
  "storage_type": "s3_compatible",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "endpoint_url": "https://YOUR_ACCOUNT_ID.r2.cloudflarestorage.com",
  "region": "auto"
}
azure
أما الإمداد برقم account_name و sas_token، وهي حاوية مجهزة بإذن كتابي (البرنامج الفرعي (ث)، والرمز المرجعي (ج)، والخلاصة، والنسخة (Sv) والتوقيع (storage_url، فهي اسم الحاويات. لا ترسل endpoint_url, access_key or secret_key.
azure مثال
params.storage · azure
{
  "storage_type": "azure",
  "storage_url": "your-media-container",
  "account_name": "yourstorageaccount",
  "sas_token": "sv=2023-11-03&sr=c&sp=w&se=2099-01-01T00%3A00%3A00Z&sig=YOUR_SAS_SIGNATURE"
}
bos
Supply access_key, secret_key and region: bj, su or hkg. وتنبع نقطة النهاية من المنطقة عندما تُحذف. استخدمي اسم دلو بدون نقاط
bos مثال
params.storage · bos
{
  "storage_type": "bos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "bj"
}
cos
إمداد access_key, secret_key and an ap-* region, such as ap-hongkong. storage_url must include the APPID suffix. لا ترسل endpoint_url; It is derived from region.
cos مثال
params.storage · cos
{
  "storage_type": "cos",
  "storage_url": "your-media-bucket-1234567890",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "ap-hongkong"
}
gcs
إمداد service_account مع project_id, client_email (a.gserviceaccount.com) و PEM private_key من حساب خدماتكم. يجب أن يكتب الحساب الدخول إلى الدلو. لا ترسل access_key, secret_key, region or endpoint_url.
gcs مثال
params.storage · gcs
{
  "storage_type": "gcs",
  "storage_url": "your-media-bucket",
  "service_account": {
    "project_id": "your-project-id",
    "client_email": "[email protected]",
    "private_key": "-----BEGIN PRIVATE KEY-----\nYOUR_PRIVATE_KEY\n-----END PRIVATE KEY-----\n"
  }
}
oss
الإمداد access_key, secret_key و منطقة الدلو العامة HTTPS endpoint_url.
oss مثال
params.storage · oss
{
  "storage_type": "oss",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "endpoint_url": "https://oss-cn-hongkong.aliyuncs.com"
}
tos
Supply access_key, secret_key and region with a cn-, ap-, eu- or us- prefix. وتنبع نقطة النهاية من المنطقة عندما تُحذف. استخدمي اسم دلو بدون نقاط
tos مثال
params.storage · tos
{
  "storage_type": "tos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "cn-beijing"
}

النتيجة file_url يُحدّدُ جسماً في مخزنِكَ. الأجسام الخاصة تتطلب إذناً من مقدِّم التخزين أو موقعاً URL; FlashData API المفتاح لا يمنح الدخول إلى دلوكم

وللاطلاع على الطلب الكامل، يُرجى الاطلاع على عملية الاقتراع والتحميل، انظر حمولة من طراز YouTube مسموعة إلى Amazon S3.

تسليم الملفات

العمل rel: results تعيد التوجيه افتراضيًا إلى النتيجة JSON, ليس تحميلاً من "إم بي 4" FlashData يُرفع وسائل الإعلام الفعلية إلى الدلو أو الحاوية التي زودتها. استبقاء وسائل الإعلام يتبع سياسة الدلو الخاص بك، نتيجة الوظيفة JSON تنتهي بـ 24 بعد ساعات من الانتهاء.

results[0].file_url يحدد الجسم ولكنه ليس رسمياً أو موقعاً على URL. الوصول إلى وسائل الإعلام الخاصة مع تخزينك SDKأو تولد توقيعاً قصير الأمد URL على خادمك الخاص لا ترسل FlashData API مفتاح مخزنك

التمكين upload_metadata لتحميل {video_id}_meta.json رفيقة في نفس المأزق موقعها وكمياتها تظهر تحت results[0].metadata.

طريقة تحميل (بروسلر) الخاصة بـ (بروسلر) منفصلة الجمهور API التحميلات تستخدم مخزنك الخاص لا تشمل "كونبول" فقط browser_delivery أماكن.

التعافي من الأخطاء

بالنسبة لفشل الحمولة أو التخزين 403, تحقق من المزود، الدلو، المنطقة، نقطة النهاية، الأذن بالكتابة. غير متصل أو خاص file_url لا يعني في حد ذاته أن الحمولة فشلت تحقق من الجسم من خلال مخزنك

ولا يمكن استرجاع شريط فيديو أزيل أو غير متاح عن طريق الاقتراع. بالنسبة للأشكال غير المتاحة، صيغ البيانات الوصفية, أو تخفيف القيود على الجودة أو إزالة المختار المتقدم. الاحتياجات من الطلبات الصوتية فقط m4a, mp3 أو opus; طُلبت طلبات الفيديو mp4, webm أو mkv.

النتيجة JSON لقد انتهت صلاحيته أولاً تفقد دلوتك من أجل وسائل الإعلام ويؤدي إعادة تقديم التقارير إلى تنزيل جديد وقد يتكبد شحنة أخرى؛ وهو لا يسترد النتيجة القديمة JSON.

وللتوثيق، والتوازن، وطريقة الطلب، والإخفاقات في الحد الأقصى للمعدلات، تستخدم مرجع الخطأ المشترك. وقد يكون الوقت المتاح لتقديم الطلبات قد أدى إلى خلق وظيفة؛ والتحقق من العمل القائم قبل إعادة التجريب.

الأخطاء ورموز الحالة · متى يُعيدُ النظر · الحد الأقصى للمعدل

دليل الخطوة خطوة: تحميل شريط فيديو واحد والتحقق من التسليم

الأسعار

الخططمعدلات الاستخدامموزعة حسب نوع GBالاشتراكاتتشمل الأرصدة الدائنة لكل فترة من فترات إعداد الفواتير
الدفع حسب الاستخدام‏0.10 US$بلا رسوم شهريةأضف رصيدًا عند الحاجة
Micro‏0.08 US$‏49.00 US$ / الشهر1,000 credits (‏50.00 US$ of API usage) included
Starter‏0.07 US$‏199.00 US$ / الشهر4,000 credits (‏200.00 US$ of API usage) included
Pro‏0.06 US$‏499.00 US$ / الشهر10,000 credits (‏500.00 US$ of API usage) included
Scale‏0.05 US$‏999.00 US$ / الشهر20,000 credits (‏1,000.00 US$ of API usage) included
Business‏0.04 US$‏1,999.00 US$ / الشهر40,000 credits (‏2,000.00 US$ of API usage) included

خطة واحدة للحساب. رصيد مشترك للمنتجات الثلاثة. لا تُفرض رسوم مرة أخرى على الاستخدام المغطى بالرصيد المضمّن.

الأسعار والحدود الحالية للخطة