ข้ามไปยังเนื้อหา
TH
รับคีย์ API
เรียกดูเอกสาร

เอกสารอ้างอิง API

YouTube Download API

รับคีย์ API

ดาวน์โหลด YouTube วีดีโอหรือเสียงที่เก็บข้อมูลเมฆของคุณ เลือกความละเอียด รูปแบบ และระยะเวลาการตัดต่อ จากนั้นติดตามการทํางานที่น่าเบื่อผ่านการทําให้สมบูรณ์

API ดาวน์โหลดวิดีโอ YouTube — ตัวอย่าง Python

สร้างคำขอ

เดอะ 11- ช่างทําเล็บ ID จากวีดีโอ URLไม่เต็ม URL.

ตัวเลือกเพิ่มเติมของสื่อ

เลือกฟอร์แมตแทนคุณภาพ, อัตราเฟรมและการเลือกเพลง ยังใช้รูปแบบการแสดงผลและขอบเขตการส่งออกอยู่ ปลายโค้งจะต้องเริ่มตามต้องการ หากผูกให้ทั้งไม่สามารถยกเลิกได้

ที่อยู่เก็บ

ล้างโดยใช้วันที่อัปโหลดของ UTC (YYYMMDD).

เพิ่มข้อมูลส่วนตัวของคุณบนเซิร์ฟเวอร์ ก่อนที่จะทําการเข้ารหัส พวกเขาต้องการสิทธิ์ในการอัพโหลดไฟล์

ผู้จัดทําใบรับรองและความต้องการจัดเก็บ
การทําเว็บฮุกให้สมบูรณ์การโหลดเว็บฮุค, การตรวจสอบและแก้ไข

Markdown ใช้กับผลลัพธ์ที่เสร็จสมบูรณ์แล้ว Receepts และสถานะงาน เก็บสาขาเดิมของพวกเขา

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 ยืนยัน

พารามิเตอร์

ส่ง source ถึง video_id ที่ระดับบนสุด ตัวเลือกของแหล่งอยู่ใน params. ช่องข้อมูลทางเลือกสามารถยกเลิกได้

เนื้อหาคำขอ

sourcestring / จำเป็น
กําหนดเป็น youtube_download
video_idstring / จำเป็น
เดอะ 11- ช่างทําเล็บ YouTube วิดีโอ IDเช่น FUFGCZ092b0. รับจดหมาย ตัวเลข อุปทาน และไฮเฟน
ตรงกับ 11 ตัวอักษรค่าปริยาย: ยังไม่ได้ตั้งค่า
รูปแบบที่ยอมรับได้^[A-Za-z0-9_-]{11}$
paramsobject / จำเป็น
Settings สําหรับการร้องขอนี้
callback_urlstring · nullable / ไม่บังคับ
Async และชุดเท่านั้น สาธารณะ HTTPS เสร็จสมบูรณ์แล้ว URL บนพอร์ต 443ถึง 2,048 ตัวละคร ไม่มีเอกสารรับรองผู้ใช้หรือส่วน URL Omit, ใช้ null หรือข้อความเปล่าสําหรับไม่ให้แจ้งเตือน ในชุดนี้ กําหนดให้แต่ละคําถาม ภายนอกพม่า
ค่าปริยาย: ยังไม่ได้ตั้งค่า

เสียงวิดีโอ

params.download_typestring / ไม่บังคับ
audio_video ผนวกรวมวิดีโอและเสียง; วิดีโอเลือกเฉพาะวิดีโอเท่านั้น; เสียงสามารถเลือกเสียงได้อย่างเดียว
1 ถึง 11 ตัวอักษรค่าต่าง ๆ: audio_video / video / audioค่าปริยาย: "audio_video"
params.video_qualitystring / ไม่บังคับ
การคัดเลือกวิดีโอความละเอียด Omit สําหรับการดาวน์โหลดเฉพาะเสียงเท่านั้น
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. Omit สําหรับการดาวน์โหลดเฉพาะเสียงเท่านั้น
1 ถึง 6 ตัวอักษรค่าปริยาย: ยังไม่ได้ตั้งค่า
รูปแบบที่ยอมรับได้^(?:>=|<=|==)(?:[1-9]\d?|1\d\d|2[0-3]\d|240)$
params.audio_languagestring / ไม่บังคับ
เลือกแทร็กเสียง เรียกข้อมูล audio_video และเสียง
1 ถึง 8 ตัวอักษรค่าต่าง ๆ: default / originalค่าปริยาย: "default"
params.audio_qualitystring / ไม่บังคับ
อัตราส่งถ่ายข้อมูลเสียงอย่างเดียว ในหน่วย กิโลบิต/ วินาที หรือดีที่สุด ค่าตัวเลือกต้องถูกส่งมาเป็นสตริง Omit สําหรับการดาวน์โหลดวิดีโอ
1 ถึง 10 ตัวอักษรค่าต่าง ๆ: best / 320 / 256 / 192 / 128ค่าปริยาย: "best"
params.output_formatstring / ไม่บังคับ
วิดีโอ: mp4, webm หรือ mkv. เสียง: m4a, mp3 หรือ Oppus
1 ถึง 10 ตัวอักษรค่าต่าง ๆ: mp4 / webm / mkv / m4a / mp3 / opusค่าปริยาย: mp4 (video) / m4a (audio)
params.yt_dlp_formatstring / ไม่บังคับ
เครื่องมือเลือกฟอร์แมตขั้นสูง จาก 1 ถึง 1,024 อักขระหลังการตกแต่งช่องว่าง อักขระควบคุมถูกปฏิเสธ การแทนที่ video_quality(พ.ศ. audio_languageค่าที่ถูกละทิ้งจากค่าดังกล่าว รูปแบบของการแสดงผลและการตัดส่วนภาพยังคงใช้ได้อยู่
1 ถึง 1,024 ตัวอักษรค่าปริยาย: ยังไม่ได้ตั้งค่า
params.upload_metadataboolean / ไม่บังคับ
อัปโหลดข้อมูลกํากับภาพ JSON เคียงข้างกับแฟ้มสื่อในที่เก็บของคุณ
true หรือ falseค่าปริยาย: false

จิบ

params.start_atstring / ไม่บังคับ
เริ่มคลิปในรูปแบบ H: MM:S หรือ hH:MM: SS จาก 00:00:00 ถึง 12:00:00. ค่าปริยายไปยัง 00:00:00 เมื่อเท่านั้น end_at มีเสบียงให้
1 ถึง 8 ตัวอักษรค่าปริยาย: ยังไม่ได้ตั้งค่า
รูปแบบที่ยอมรับได้^\d{1,2}:[0-5]\d:[0-5]\d$
params.end_atstring / ไม่บังคับ
ปิดท้ายแบบ H: MM:SS หรือ hH:MM: SS ฟอร์แมต, จนถึง 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, asure, cos, Bos หรือ tos.
params.storage.storage_urlstring / จำเป็น
ถังเปล่าหรือชื่อกล่อง, ถึงตัวอักษร 1,024 ช่องว่างรอบนอกถูกลบออกไป สําหรับ s3, ใช้ชื่อถัง AWS ที่ถูกต้องโดยไม่มี URL หรือพาธของโฟลเดอร์; โฟลเดอร์ต่าง ๆ ควรอยู่ใน object_prefix.
params.storage.object_prefixstring / ไม่บังคับ
คํานําหน้าแบบปุ่มออบเจ็กต์ 1 ถึง 512 ตัวละคร แต่ละส่วนตัดแบ่งรับตัวอักษร ASCII, ตัวเลขจุด, เครื่องหมายเครื่องหมาย และไฮเฟน; ส่วนของเส้นตรงว่างเปล่า, และ ... ถูกปฏิเสธ ไม่มีรอยตัดนํา ล้อมรอบพื้นที่สีขาวและหนึ่งรอยตัดต่อท้ายจะถูกลบ YYYYMDD ใช้วันที่อัปโหลดจาก UTC รวมถึงใน archive/YYYYMMDD.
ค่าปริยาย: "YYYYMMDD"
params.storage.access_keystring / ไม่บังคับ
กุญแจเข้าใช้สําหรับ S3, S3- เข้ากันได้, OSS, COS, Bos หรือ Tors; คู่กับ secret_key.
params.storage.secret_keystring / ไม่บังคับ
กุญแจลับสําหรับ S3, S3- เข้ากันได้, OSS, COS, Bos หรือ Tos
params.storage.endpoint_urlstring / ไม่บังคับ
สาธารณะ HTTPS จุดสิ้นสุดสําหรับ S3- เข้ากันได้กับโกดังหรือโอเอสเอส ซีเอส, บอส และ ทอส ได้มันมาจากภูมิภาค
params.storage.regionstring / ไม่บังคับ
เรียกดู COS, Bos and Tors; นอกจากนี้ยังจัดหาสําหรับ S3 ถึง S3- การดาวน์โหลดที่เข้ากันได้ ชื่อถัง COSS รวม APID ด้วย
params.storage.service_accountobject / ไม่บังคับ
GCS บัญชีบริการ: project_id, client_email และ PEM private_key.
params.storage.account_namestring / ไม่บังคับ
Azure ชื่อบัญชีโกดัง ใช้ชื่อกล่องใน storage_url
params.storage.sas_tokenstring / ไม่บังคับ
เขียนได้ Azure ตู้คอนเทนเนอร์ SSA พร้อมเครื่องหมาย และลายเซ็น

คำตอบ

ผู้สร้างที่ต้องการส่งการดาวน์โหลดด้วย Async หรือ Batch และต้องการ params.storage. HTTP 200 ด้วย status: pending ยืนยันการยอมรับ ไม่ใช่การส่ง Batch คืนใบเสร็จงานหนึ่งใบต่อหนึ่งวิดีโอ ID.

การรับช่วง usage.credits คือ 0. การดาวน์โหลดจะถูกเรียกเก็บโดย ระดับเสียงของสื่อที่ส่งมาแล้ว หลังจากการส่งได้สําเร็จ; เลือกแฟ้มข้อมูลกํากับภาพที่ไม่เพิ่มข้อมูลในการดาวน์โหลด

สํารวจ job.status ถึง completed, จากนั้นรับผล JSON มา อ่านรายละเอียดของสื่อเมื่อ results[0], รวมทั้งการอัปโหลดวัตถุ file_url, ขนาดแฟ้มและ checksum

อ่านผลที่ออกมา

หลังจากงานเสร็จสิ้น บันทึก 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 ที่การยินยอม จํานวนดาวน์โหลดจะถูกชาร์จด้วยปริมาณข้อมูลที่ส่งแล้วหลังจากเสร็จสิ้น
linksarrayติดตามการเชื่อมโยงด้วยตนเองสําหรับสถานะงาน และส่วนเชื่อมโยงสําหรับการแสดงผลที่เสร็จสมบูรณ์
links[].relstringตัวตนหรือผลลัพธ์
links[].hrefstringURL เพื่อสอบถามด้วยสิ่งเดียวกัน API กุญแจ
links[].methodstringGET.
ช่องข้อมูลของสื่อที่เสร็จสมบูรณ์แล้ว
ช่องข้อมูลคําอธิบาย
results[0].file_urlstringตําแหน่งของแฟ้มสื่อในที่เก็บของคุณ
results[0].file_sizeintegerขนาดแฟ้มแบบมีเดีย ในหน่วยไบต์
results[0].downloaded_bytesintegerส่งโดยสื่อที่ใช้เรียกเก็บเงิน
results[0].md5stringMD5 Checkum ของแฟ้มสื่อ
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 · optionalข้อมูลกํากับภาพ file_url, file_size และ md5 เมื่อ upload_metadata คือ true. ข้อมูลกํากับภาพโดยแยกออกจากการดาวน์โหลด

ช่องข้อมูลด้านบน จะใช้อธิบายค่าปริยาย JSON ตอบสนอง ตัวเลือกต่าง ๆ ของรูปแบบจะถูกปรับใช้กับบันทึกการส่ง ไม่ใช่แฟ้มสื่อ JSONข้อความธรรมดาและ Markdown รูปแบบ.

Async วงจรชีวิตแบบชุด

การรับช่วงนําใบเสร็จกลับมา ไม่ใช่ผลลัพธ์ Async สร้างงานหนึ่งงาน; กลุ่มต่าง ๆ จะคืนค่ากลับมาเป็นงานที่แยกไว้ queries[] สําหรับทุก ๆ คนที่สอบถามเจ้า ติดตามและรับงานแต่ละงานเป็นอิสระ

ส่งข้อมูลไปยัง data.flashdata.dev; สืบค้นสถานะงานและผลลัพธ์จาก api.flashdata.dev กับ X-API-Key แบบเดียวกัน ความ เกี่ยว พัน API ตัวอย่างพื้นฐานที่ใช้ Python ถึง cURL.

  1. 1. บันทึกงาน IDs

    ส่งหนึ่งการดาวน์โหลดด้วย Asyncหรือใส่การร้องขอดาวน์โหลดหลายอันภายใน Batch เรียงแถว แต่ละรายการต้องการ params.storage บันทึกงานที่ส่งกลับทั้งหมด ID

    Async ร้องขอและใบเสร็จ · 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 · รูปแบบคำตอบ

    ดาวน์โหลดผลลัพธ์ API อ้างอิง

การ สํารวจ และ ได้ ผล ที่ มี อยู่ แล้ว ไม่ ได้ ใช้ เงิน เครดิต ที่ สอบ ถาม. จับเวลาแบบสํารวจไม่ได้ยกเลิกงาน: ให้ ID แทนการส่งงานที่ซ้ํากัน % 1 ไม่ถูกต้อง!.

Webhook เมื่อเสร็จสิ้น

บอกรับต่อคําค้น

ตั้งค่า callback_url ที่ระดับบนสุดของการร้องขอ Asinc หรือ ภายในแต่ละคําถาม ในชุดที่อยู่นอก params. ไม่มีความต้องการการแยกเว็บฮุค- regressing

ใช้สาธารณะชน HTTPS URL บนพอร์ต 443. FlashDataPOSTS แจ้งเตือนสําหรับแต่ละงานพิมพ์ที่ไปถึง completed หรือ failed; เหตุการณ์ที่บรรจุลิงก์ ไม่ใช่ผลลัพธ์เอง

การยอมรับและตรวจสอบ

กลับค่า 2xx หลังจากยอมรับเหตุการณ์นั้น บิดเบี้ยวโดย delivery_id, ยังถูกส่งมาเป็น X-Delivery-Id. ไม่ ปฏิบัติ ตาม การ ชี้ นํา.

การส่งล้มเหลว การลองใหม่ด้วยการกลับแบบเอกซ์โปเนนเชียลขึ้นไป 8 พยายามรวมทั้งหมด และที่มากที่สุด 24 ชั่วโมงหลังจากเติมให้สมบูรณ์แล้ว. ให้การวินิจฉัยเป็น การผิดพลาด

การเรียกตัวยังไม่แน่ชัด ยืนยันงาน IDแหล่งที่มาและสถานะปลายทางผ่าน สถานะที่ยืนยันแล้ว ก่อนที่จะประมวลผลการแจ้งเตือน การส่งมอบ ID สําหรับ deduction, ไม่ใช่ข้อพิสูจน์ของความเป็นจริง

ตัวอย่าง Hook เหตุการณ์และช่องข้อมูล
แจ้งเตือนการเติมให้สมบูรณ์
{
  "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 ส่วนหัว
idstringJoob ID.
sourcestringต้องการแหล่งข้อมูล
statusstringเสร็จสมบูรณ์หรือล้มเหลว
linksarrayสถานะและการเชื่อมโยงผลลัพธ์ การแจ้งให้ทราบไม่รวมเนื้อหาหรือรายการที่มีผล API กุญแจ
links[].relstringตัวตนหรือผลลัพธ์
links[].hrefstringการจัดการสัมบูรณ์ API URL2; ยืนยันตัวด้วย API กุญแจ
links[].methodstringGET.

สัญญาเว็บฮุคแบบเต็มและ URL จํากัด

ประมวลผลไฟล์แบบ Bulk

อัปโหลดหนึ่งวิดีโอ ID ต่อบรรทัดและสร้าง Bulk ทํางานกับแหล่ง: youtube_download. ตัวเลือกที่ใช้ร่วมกันจะถูกปรับใช้กับทุกแฟ้มคือ ID

ใส่ที่หมายจัดเก็บใน options.storage และการตั้งค่าสื่อใน options. งานเดียวและ Batch การดาวน์โหลด params.storage แทน

แฟ้มสื่อถูกส่งไปยังที่เก็บเมฆของคุณ เสร็จสมบูรณ์ Bulk ผล ก็ คือ ส่วน ต่าง ๆ ที่ อธิบาย เรื่อง การ ดาวน์ โหลด ได้ ปรากฏ ออก มา. เว้นแต่คํากล่าวที่รัดกุมชัดเจนเท่านั้น 24 หนึ่งชั่วโมงหลังจากทั้งหมด Bulk งานเสร็จสมบูรณ์แล้ว

Bulk การประมวลผล API · Python ถึง cURL · Batch JSON ต้องการ

สร้าง Bulk การ ไหล เวียน ของ แหล่ง นี้ · หยุดชั่วคราว และทําต่อและฟื้นตัว

ดาวน์โหลดวิดีโอแบบกลุ่ม — ชุดเครื่องมือ Python

ที่อยู่เก็บ

รวม params.storage ในแต่ละการร้องขอดาวน์โหลด ตั้งค่า storage_url ไปยังถังหรือชื่อตู้และเอกสารรับรองของคุณด้วยการเขียน เก็บบันทึกข้อมูลไว้บนเซิร์ฟเวอร์ของคุณ

params.storage · S3- จุดหมายที่เข้ากันได้
{
  "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, เพิ่มวันที่อัปโหลดไปยัง UTC ใช้ไดเร็กทอรีคงที่ หรือแม่แบบเช่น archive/YYYYMMDD.

s3
แพกเกจ access_key ถึง secret_key ด้วยการเข้าถึงการเขียน ตั้งขอบเขตพื้นที่ให้เขตเอดับเบิลยูเอสของคุณ
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 ขอสาบานต่อมะลาอิกะฮฺที่จําแนกระหว่างความจริงกับความเท็จ 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สืบค้นเมื่อ '% 1' ถึงแฟ้ม SAS ที่มีสิทธิ์ในการเขียน (รวม w), ทรัพยากร sr=c, Expiry c, รุ่น sv และลายเซ็น sig storage_url คือชื่อตู้คอนเทนเนอร์ ไม่ต้องส่ง endpoint_url, access_key หรือ 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
แพกเกจ access_key, secret_key และเขต: bj, su หรือ 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 และภูมิภาค ap-* เช่น ap-hongkong ค่า storage_url ต้องมี APPID ต่อท้าย ไม่ต้องส่ง endpoint_url เพราะระบบคำนวณจาก 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 ( ก.gserviceaccount.com ที่ อยู่), และ เพ เอ็ม private_key จากบัญชีบริการของคุณ บัญชีต้องเข้าถึงถังได้ ไม่ต้องส่ง access_key, secret_keyขอบเขตหรือ 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
แพกเกจ access_key, secret_key และพื้นที่ที่มี cn-a p-, eu-หรือเรานําหน้า จุดปลายมาจากพื้นที่ที่ตัดทิ้ง ใช้ชื่อถังที่ไม่มีจุด
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, ไม่ใช่ดาวน์โหลด MP4 FlashData. อัปโหลดสื่อจริงไปยังถังหรือภาชนะที่คุณให้มา สื่อมวลชนเฝ้าติดตามนโยบายของคุณ; ผลของงาน JSON หมดอายุ 24 หนึ่งชั่วโมงหลังจากเสร็จ

results[0].file_url ระบุวัตถุแต่ไม่ได้เป็นการให้สาธารณะโดยอัตโนมัติ หรือเซ็น URL เข้าใช้สื่อส่วนตัวด้วยจัดเก็บข้อมูลของคุณ SDKหรือสร้างลายเซ็นที่มีอายุสั้น URL บนเซิฟเวอร์ของคุณเอง อย่าส่ง FlashData API กุญแจของผู้ให้บริการเก็บของของคุณ

เปิด upload_metadata เพื่ออัปโหลด {video_id}_meta.json ผู้ร่วมประชุมในวงเดียวกัน ตําแหน่งของมัน และ checksum ก็ปรากฏภายใต้ results[0].metadata.

โหมดดาวน์โหลดของคอนโซลถูกแยก สาธารณะ API การดาวน์โหลดจะใช้คลังส่วนตัวของคุณ ไม่ต้องรวมคอนโซลเท่านั้น browser_delivery การตั้งค่า.

การกู้คืนผิดพลาด

สําหรับการอัปโหลดล้มเหลวหรือจัดเก็บ 403, ตรวจดูผู้ให้บริการ, ถัง, พื้นที่, จุดสิ้นสุด และสิทธิ์ในการเขียนออบเจ็กต์ ไม่ สามารถ หา ได้ หรือ เป็น ส่วน ตัว file_url ไม่ได้หมายความว่าการอัปโหลดล้มเหลวโดยตัวมันเอง: โปรดตรวจสอบวัตถุผ่านทางผู้ให้บริการจัดเก็บของคุณ

ไม่สามารถกู้วิดีโอที่เอาออกหรือไม่สามารถใช้งานได้โดยผลสํารวจ สําหรับรูปแบบที่ยังไม่มีให้ตรวจสอบ รูปแบบข้อมูลกํากับภาพ, การตั้งค่าการรีเฟรชคุณภาพ หรือเอาตัวเลือกขั้นสูงออก ต้องการเฉพาะแฟ้มเสียง m4a, mp3 หรือ opus; ขอวิดีโอ mp4, webm หรือ mkv.

ถ้าผลลัพธ์ JSON หมดอายุแล้ว เช็คถังของคุณก่อน สําหรับสื่อ การแทนที่นั้น สามารถสร้างการดาวน์โหลดใหม่ และอาจจะใช้ประจุอื่นแทน; มันจะไม่สามารถเรียกคืนผลลัพธ์เก่าที่ JSON ได้

สําหรับการตรวจสอบสิทธิ์, ดุลยภาพ, ร้องขอunit-format และอัตราการสิ้นสุดของอัตรา - การอ้างอิงข้อผิดพลาดร่วมกัน เวลา ที่ ใช้ ไป แล้ว อาจ ยัง คง สร้าง งาน อยู่; ตรวจ สอบ งาน ที่ มี อยู่ ก่อน จะ ลอง ทํา ใหม่.

ข้อผิดพลาดและรหัสสถานะ · เมื่อต้องการลองใหม่ · ข้อจํากัดของอัตรา

ไกด์ทีละขั้น: ดาวน์โหลดหนึ่งวิดีโอและตรวจสอบการส่ง

ราคา

แผนอัตราการใช้ส่งผ่าน GBสมาชิกรวมการให้เครดิตต่อช่วงเวลาเรียกเก็บเงิน
จ่ายตามการใช้งานUS$0.10ไม่มีค่าบริการรายเดือนเติมเครดิตเมื่อจำเป็น
MicroUS$0.08US$49.00 / เดือน1,000 เครดิต (Chonder)US$50.00 ของ API การใช้) รวม
StarterUS$0.07US$199.00 / เดือน4,000 เครดิต (Chonder)US$200.00 ของ API การใช้) รวม
ProUS$0.06US$499.00 / เดือน10,000 เครดิต (Chonder)US$500.00 ของ API การใช้) รวม
ScaleUS$0.05US$999.00 / เดือน20,000 เครดิต (Chonder)US$1,000.00 ของ API การใช้) รวม
BusinessUS$0.04US$1,999.00 / เดือน40,000 เครดิต (Chonder)US$2,000.00 ของ API การใช้) รวม

หนึ่งแผนต่อบัญชี ใช้เครดิตร่วมกันทั้งสามผลิตภัณฑ์ การใช้งานที่ครอบคลุมด้วยเครดิตในแผนจะไม่ถูกคิดค่าบริการซ้ำ

ราคาและแผนจํากัดในปัจจุบัน