เรียกดูเอกสาร
เอกสารอ้างอิง API
YouTube Download API
ดาวน์โหลด YouTube วีดีโอหรือเสียงที่เก็บข้อมูลเมฆของคุณ เลือกความละเอียด รูปแบบ และระยะเวลาการตัดต่อ จากนั้นติดตามการทํางานที่น่าเบื่อผ่านการทําให้สมบูรณ์
API ดาวน์โหลดวิดีโอ YouTube — ตัวอย่าง Python
สร้างคำขอ
เดอะ 11- ช่างทําเล็บ ID จากวีดีโอ URLไม่เต็ม URL.
ตัวเลือกเพิ่มเติมของสื่อ
เลือกฟอร์แมตแทนคุณภาพ, อัตราเฟรมและการเลือกเพลง ยังใช้รูปแบบการแสดงผลและขอบเขตการส่งออกอยู่ ปลายโค้งจะต้องเริ่มตามต้องการ หากผูกให้ทั้งไม่สามารถยกเลิกได้
ที่อยู่เก็บ
ล้างโดยใช้วันที่อัปโหลดของ UTC (YYYMMDD).
เพิ่มข้อมูลส่วนตัวของคุณบนเซิร์ฟเวอร์ ก่อนที่จะทําการเข้ารหัส พวกเขาต้องการสิทธิ์ในการอัพโหลดไฟล์
ผู้จัดทําใบรับรองและความต้องการจัดเก็บการทําเว็บฮุกให้สมบูรณ์
การโหลดเว็บฮุค, การตรวจสอบและแก้ไขMarkdown ใช้กับผลลัพธ์ที่เสร็จสมบูรณ์แล้ว Receepts และสถานะงาน เก็บสาขาเดิมของพวกเขา
https://data.flashdata.dev/v1/queriesพารามิเตอร์
ส่ง 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 หรือ Oppus1 ถึง 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_at1 ถึง 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. มันอ่านรายละเอียดแฟ้มโดยไม่ดาวน์โหลดสื่อหรือร้องขอข้อมูลอื่น
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. |
sourcestring | youtube_download. |
statusstring | รอรับงานก่อน |
created_atstring | เวลา การ สร้าง งาน ใน ISO 8601 รูปแบบ |
usage.creditsnumber | 0 ที่การยินยอม จํานวนดาวน์โหลดจะถูกชาร์จด้วยปริมาณข้อมูลที่ส่งแล้วหลังจากเสร็จสิ้น |
linksarray | ติดตามการเชื่อมโยงด้วยตนเองสําหรับสถานะงาน และส่วนเชื่อมโยงสําหรับการแสดงผลที่เสร็จสมบูรณ์ |
links[].relstring | ตัวตนหรือผลลัพธ์ |
links[].hrefstring | URL เพื่อสอบถามด้วยสิ่งเดียวกัน API กุญแจ |
links[].methodstring | GET. |
ช่องข้อมูลของสื่อที่เสร็จสมบูรณ์แล้ว
| ช่องข้อมูล | คําอธิบาย |
|---|---|
results[0].file_urlstring | ตําแหน่งของแฟ้มสื่อในที่เก็บของคุณ |
results[0].file_sizeinteger | ขนาดแฟ้มแบบมีเดีย ในหน่วยไบต์ |
results[0].downloaded_bytesinteger | ส่งโดยสื่อที่ใช้เรียกเก็บเงิน |
results[0].md5string | MD5 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. บันทึกงาน IDs
ส่งหนึ่งการดาวน์โหลดด้วย Asyncหรือใส่การร้องขอดาวน์โหลดหลายอันภายใน Batch เรียงแถว แต่ละรายการต้องการ params.storage บันทึกงานที่ส่งกลับทั้งหมด ID
2. ตรวจสอบสถานะ
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: โพลด้วยความล่าช้าและความเคารพRetry-Afterเมื่อถึงวันนี้completed: รับผลfailed: สืบค้นเมื่อjob.error.อ่าน job.status ไม่ใช่สถานะใบเสร็จรับส่ง
ตรวจสอบสถานะที่: Python ถึง cURL
สถานะงาน API อ้างอิง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 ส่วนหัว |
idstring | Joob ID. |
sourcestring | ต้องการแหล่งข้อมูล |
statusstring | เสร็จสมบูรณ์หรือล้มเหลว |
linksarray | สถานะและการเชื่อมโยงผลลัพธ์ การแจ้งให้ทราบไม่รวมเนื้อหาหรือรายการที่มีผล API กุญแจ |
links[].relstring | ตัวตนหรือผลลัพธ์ |
links[].hrefstring | การจัดการสัมบูรณ์ API URL2; ยืนยันตัวด้วย API กุญแจ |
links[].methodstring | GET. |
ประมวลผลไฟล์แบบ Bulk
อัปโหลดหนึ่งวิดีโอ ID ต่อบรรทัดและสร้าง Bulk ทํางานกับแหล่ง: youtube_download. ตัวเลือกที่ใช้ร่วมกันจะถูกปรับใช้กับทุกแฟ้มคือ ID
ใส่ที่หมายจัดเก็บใน options.storage และการตั้งค่าสื่อใน options. งานเดียวและ Batch การดาวน์โหลด params.storage แทน
แฟ้มสื่อถูกส่งไปยังที่เก็บเมฆของคุณ เสร็จสมบูรณ์ Bulk ผล ก็ คือ ส่วน ต่าง ๆ ที่ อธิบาย เรื่อง การ ดาวน์ โหลด ได้ ปรากฏ ออก มา. เว้นแต่คํากล่าวที่รัดกุมชัดเจนเท่านั้น 24 หนึ่งชั่วโมงหลังจากทั้งหมด Bulk งานเสร็จสมบูรณ์แล้ว
Bulk การประมวลผล API · Python ถึง cURL · Batch JSON ต้องการ
สร้าง Bulk การ ไหล เวียน ของ แหล่ง นี้ · หยุดชั่วคราว และทําต่อและฟื้นตัว
ที่อยู่เก็บ
รวม params.storage ในแต่ละการร้องขอดาวน์โหลด ตั้งค่า storage_url ไปยังถังหรือชื่อตู้และเอกสารรับรองของคุณด้วยการเขียน เก็บบันทึกข้อมูลไว้บนเซิร์ฟเวอร์ของคุณ
{
"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 ตัวอย่าง
{ "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 ตัวอย่าง
{ "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 ตัวอย่าง
{ "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 ตัวอย่าง
{ "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 ตัวอย่าง
{ "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 ตัวอย่าง
{ "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 ตัวอย่าง
{ "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 ตัวอย่าง
{ "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 | ไม่มีค่าบริการรายเดือน | เติมเครดิตเมื่อจำเป็น |
| Micro | US$0.08 | US$49.00 / เดือน | 1,000 เครดิต (Chonder)US$50.00 ของ API การใช้) รวม |
| Starter | US$0.07 | US$199.00 / เดือน | 4,000 เครดิต (Chonder)US$200.00 ของ API การใช้) รวม |
| Pro | US$0.06 | US$499.00 / เดือน | 10,000 เครดิต (Chonder)US$500.00 ของ API การใช้) รวม |
| Scale | US$0.05 | US$999.00 / เดือน | 20,000 เครดิต (Chonder)US$1,000.00 ของ API การใช้) รวม |
| Business | US$0.04 | US$1,999.00 / เดือน | 40,000 เครดิต (Chonder)US$2,000.00 ของ API การใช้) รวม |
หนึ่งแผนต่อบัญชี ใช้เครดิตร่วมกันทั้งสามผลิตภัณฑ์ การใช้งานที่ครอบคลุมด้วยเครดิตในแผนจะไม่ถูกคิดค่าบริการซ้ำ
ราคาและแผนจํากัดในปัจจุบัน