เรียกดูเอกสาร
เอกสารอ้างอิง API
YouTube Transcript API
เรียกข้อมูล YouTube สําเนาข้อความด้วยเวลาและเอกสารเต็ม เลือกคําบรรยายภาพให้อัตโนมัติโดยค่าปริยาย
สร้างคำขอ
เดอะ 11- ช่างทําเล็บ ID จากวีดีโอ URLไม่เต็ม URL.
ทิ้งช่องว่างไว้เพื่อลอง 'en-orig' จากนั้น en และกลับมาหนึ่งร่อง หรือป้อนรหัสหนึ่งหรือขึ้น 10 รหัสที่แตกต่างกันโดยเครื่องหมายจุลภาค
https://data.flashdata.dev/v1/queries/realtimeพารามิเตอร์
ส่ง source ถึง video_id ที่ระดับบนสุด ตัวเลือกของแหล่งอยู่ใน params. ช่องข้อมูลทางเลือกสามารถยกเลิกได้
เนื้อหาคำขอ
sourcestring / จำเป็น- กําหนดเป็น youtube_transcript
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.languagestring | array / ไม่บังคับ- Omit สําหรับภาษาอังกฤษ (n-orig, แล้ว en). ด้วย อัตโนมัติ = true รหัสแต่ละตัวจะลองใช้ - ออร์แกนแทร็คก่อน จากนั้นใช้รหัสที่ต้องการ explicit - รหัสออริกและอัตโนมัติ = false คงที่ อาร์เรย์ร้องขอภาษาต่างๆ 1–10ค่าปริยาย:
en-orig → en params.autoboolean / ไม่บังคับ- true เลือก YouTube- คําบรรยายที่แต่งขึ้น; false เลือกคําบรรยายภาพที่อัปโหลดมา เลือกตัวเลือกนี้ เพื่อเลือกส่วนกํากับ ไม่ใช่การเลือกภาษา หรือตัวแปลคําสั่งใหม่
trueหรือfalseค่าปริยาย:true
คำตอบ
Realtime กลับค่า status: done. อ่านผลลัพธ์ที่ส่งมาจากแหล่ง results[0]; usage.credits บันทึกค่าใช้จ่าย.
ส่วนของเส้นตรงสําหรับข้อความที่ถูกจับเวลาและ fullText สําหรับเอกสารที่รวมไว้ การเริ่มต้นและสิ้นสุดคือวินาที languageCode ถึง isAutoGenerated โปรดระบุเพลงที่เลือก
อ่านผลที่ออกมา
บันทึกความสําเร็จ JSON ตอบกลับเป็น response.json. บันทึกนี้เป็น read-response.py และเรียกไพธอน read-response.py. มันใช้เฉพาะ Pythonห้องสมุดมาตรฐาน และไม่มีการร้องขอใหม่
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 = {
"tracks": result.get("tracks", [result]),
"errors": result.get("errors", []),
}
print(json.dumps(output, ensure_ascii=False, indent=2))ภาษาโอมีตชอบแบบเอนออริกมากกว่า และถอยกลับไป en,กลับเส้นทางหนึ่ง ด้วยอัตโนมัติ=trueโค้ดแต่ละตัวที่ต้องการชอบติดตาม - orig ของมัน แล้วรหัสธรรมดา; โดยตรง - ออริคและออโต้=false อยู่เฉยๆนะ อาร์เรย์พยายามทุกภาษาที่ต้องการ และกลับร่องเสียงและความผิดพลาดตามลําดับ languageCode ระบุว่าเป็นเพลงที่เลือก requestedLanguageCode จะรวมเมื่อมันแตกต่างกัน
เมื่อระบุอาร์เรย์ภาษา ให้ดู errors เพื่อทราบว่าแทร็กใดดึงข้อมูลไม่สำเร็จ หากดึงข้อมูลไม่ได้สักแทร็ก คำขอจะล้มเหลวและระบบจะคืนเครดิตที่กันไว้ การดึงข้อมูลวิดีโอล้มเหลวหรือคำขอหมดเวลาก็ทำให้คำขอล้มเหลวเช่นกัน
ค่าปริยายอัตโนมัติไปยัง true สําหรับคําบรรยายอัตโนมัติ ตั้งค่า false สําหรับคําบรรยายของผู้อัปโหลด API ไม่เคยสลับคําบรรยาย
เดอะ API มี การ อ่าน อยู่ แล้ว YouTube หัวเรื่อง; มันไม่ได้สร้างสําเนาใหม่ การตอบสนองปริยายมีค่าที่ปรับให้พอดี JSON ข้อความ; Accept เลือกข้อความธรรมดาและ X-Respond-Withแปรงทาสี Markdown. languageName อาจเป็นไปได้ null.
หลายภาษา
ส่งอาร์เรย์ภาษาเพื่อรับแทร็กเสียงและข้อมูลข้อผิดพลาดต่อลา ตัวอย่างนี้แสดงภาษาอังกฤษและภาษาสเปนไม่สามารถใช้งานได้
{
"source": "youtube_transcript",
"video_id": "jNQXAC9IVRw",
"params": {
"language": [
"en",
"es"
],
"auto": true
}
}{
"videoId": "jNQXAC9IVRw",
"isAutoGenerated": true,
"tracks": [
{
"videoId": "jNQXAC9IVRw",
"languageCode": "en-orig",
"requestedLanguageCode": "en",
"languageName": null,
"isAutoGenerated": true,
"segments": [
{
"start": 0,
"end": 1.5,
"text": "Hello world."
}
],
"fullText": "Hello world."
}
],
"errors": [
{
"languageCode": "es",
"code": "language_unavailable",
"message": "Auto-generated subtitles not available for language: es"
}
]
}ช่องข้อมูลทั้งหมด
| ช่องข้อมูล | คําอธิบาย |
|---|---|
sourcestring | สิ่งที่ร้องขอมา API แหล่งข่าว |
statusstring | เสร็จสิ้นเมื่อการร้องขอจริง สําเร็จ |
created_atstring | ช่วงเวลาการสร้างแบบ ISO 8601 |
usage.creditsnumber | บัตรเครดิตตามที่ขอ จากแผนของคุณ |
results[0].videoIdstring | รายการที่ขอมาคือ ID |
results[0].languageCodestring | อักขระกํากับการทํางานที่ถูกเลือก เช่น en-orig |
results[0].languageNamestring · nullable | แสดงผลชื่อภาษาหากมีอยู่ |
results[0].requestedLanguageCodestring · optional | โค้ดที่ต้องการเมื่อมันแตกต่างจาก languageCode เป็นต้นเมื่อ Ann-orig ถูกเลือก |
results[0].isAutoGeneratedboolean | จะให้สร้างคําบรรยายภาพที่เลือกไว้โดยอัตโนมัติหรือไม่ |
results[0].segmentsarray | สัดส่วนตามเวลา |
results[0].segments[].startnumber | เวลาเริ่มต้นของ seckment ในวินาที. |
results[0].segments[].endnumber | เวลาสิ้นสุด seckment ในวินาที. |
results[0].segments[].textstring | ข้อความคําบรรยายภาพ |
results[0].fullTextstring | ข้อความทุกส่วนถูกรวมเป็นสําเนา |
results[0].tracksarray · optional | สําหรับภาษาอาร์เรย์เท่านั้น มีร่องเสียงอยู่ในลําดับที่ต้องการ แต่ละเพลงมีช่องข้อมูลแบบเดี่ยวที่แสดงอยู่ด้านบน |
results[0].errorsarray · optional | สําหรับภาษาอาร์เรย์เท่านั้น ภาษาล้มเหลวในลําดับที่ต้องการ ว่างเปล่าเมื่อทุกแทร็กประสบความสําเร็จ |
results[0].errors[].languageCodestring | ภาษาที่ต้องการล้มเหลว |
results[0].errors[].codestring | language_unavailable เมื่อเพลงที่เลือกยังไม่มีอยู่ retrieval_failed เมื่อไม่สามารถดาวน์โหลดหรือวิเคราะห์ได้ |
results[0].errors[].messagestring | คําบรรยายความล้มเหลวของภาษา |
ช่องข้อมูลด้านบน จะใช้อธิบายค่าปริยาย JSON ตอบสนอง JSONข้อความธรรมดาและ Markdown รูปแบบ.
Async คืนค่าเป็นใบเสร็จงานหนึ่งตัว; จํานวนครั้งจะคืนค่ากลับมาเป็นหนึ่งตัว วิดีโอ ID. โปรดตรวจสอบสถานะงานพิมพ์แต่ละงาน และรับผลของมันโดยใช้ที่อยู่เชื่อมโยงที่ส่งกลับ
Async วงจรชีวิตแบบชุด
การรับช่วงนําใบเสร็จกลับมา ไม่ใช่ผลลัพธ์ Async สร้างงานหนึ่งงาน; กลุ่มต่าง ๆ จะคืนค่ากลับมาเป็นงานที่แยกไว้ queries[] สําหรับทุก ๆ คนที่สอบถามเจ้า ติดตามและรับงานแต่ละงานเป็นอิสระ
ส่งข้อมูลไปยัง data.flashdata.dev; สืบค้นสถานะงานและผลลัพธ์จาก api.flashdata.dev กับ X-API-Key แบบเดียวกัน ความ เกี่ยว พัน API ตัวอย่างพื้นฐานที่ใช้ Python ถึง cURL.
1. บันทึกงาน IDs
เก็บรายการที่ต้องการของแหล่งนี้เมื่อสลับไปยัง Async สําหรับ Batchใส่การร้องขอแต่ละในลําดับของ JSON วัตถุ บันทึกงานที่ส่งกลับทั้งหมด 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 ชั่วโมงของการเติมให้สมบูรณ์
ดึงข้อมูลผลลัพธ์ที่ออกมา Python ถึง cURL · รูปแบบคำตอบ
ดาวน์โหลดผลลัพธ์ API อ้างอิง
การ สํารวจ และ ได้ ผล ที่ มี อยู่ แล้ว ไม่ ได้ ใช้ เงิน เครดิต ที่ สอบ ถาม. จับเวลาแบบสํารวจไม่ได้ยกเลิกงาน: ให้ ID แทนการส่งงานที่ซ้ํากัน % 1 ไม่ถูกต้อง!.
Webhook เมื่อเสร็จสิ้น
บอกรับต่อคําค้น
ตั้งค่า callback_url ที่ระดับบนสุดของการร้องขอ Asinc หรือ ภายในแต่ละคําถาม ในชุดที่อยู่นอก params. ไม่มีความต้องการการแยกเว็บฮุค- regressing Realtime ร้องขอไม่ให้ส่งการเรียกกลับ
ใช้สาธารณะชน 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_transcript",
"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_transcript. ตัวเลือกที่ใช้ร่วมกันจะถูกปรับใช้กับทุกแฟ้มคือ ID
ตัวเลือกของแหล่ง: ภาษา, อัตโนมัติ. เพิ่มตัวเลือกเมื่อสร้างงาน Bulk
รับค่าสะสมที่สมบูรณ์เป็นรายการและบีบอัดข้อมูล gzip NDJSON ชิ้นส่วนผลลัพธ์ แหล่ง ข้อมูล ยัง สามารถ ส่ง ส่วน ต่าง ๆ ที่ ได้ จาก การ เก็บ เมฆ ของ คุณ ได้ ด้วย โดย การ วาง options.result_storage เมื่อสร้าง Bulk งาน เว้นแต่คํากล่าวที่รัดกุมชัดเจนเท่านั้น 24 หนึ่งชั่วโมงหลังจากทั้งหมด Bulk งานเสร็จสมบูรณ์แล้ว
Bulk การประมวลผล API · Python ถึง cURL · Batch JSON ต้องการ
สร้าง Bulk การ ไหล เวียน ของ แหล่ง นี้ · หยุดชั่วคราว และทําต่อและฟื้นตัว
การกู้คืนผิดพลาด
หากไม่มีเพลงที่ร้องขอ ให้ตรวจสอบข้อมูลกํากับภาพ API's transcriptLanguages และร้องขอการสนับสนุน language/track พิมพ์มันโดยตรงเลย การทํารายการที่เลือกที่ไม่สามารถแก้ไขได้ จะไม่สามารถสร้างแทร็กดังกล่าวได้
Check language ที่มีอยู่กับข้อมูลกํากับภาพ. การร้องขอใหม่จะใช้หน่วยกิตสําหรับสอบถาม การเปลี่ยนแทร็กไม่ได้แก้ไขงานพิมพ์ที่มีอยู่แล้ว
สําหรับการตรวจสอบสิทธิ์, ดุลยภาพ, ร้องขอunit-format และอัตราการสิ้นสุดของอัตรา - การอ้างอิงข้อผิดพลาดร่วมกัน เวลา ที่ ใช้ ไป แล้ว อาจ ยัง คง สร้าง งาน อยู่; ตรวจ สอบ งาน ที่ มี อยู่ ก่อน จะ ลอง ทํา ใหม่.
ข้อผิดพลาดและรหัสสถานะ · เมื่อต้องการลองใหม่ · ข้อจํากัดของอัตรา
ไกด์ทีละขั้น: เลือกภาษาและร่องเสียงแบบสําเนา
ราคา
| แผน | อัตราการใช้ต่อ 1,000 คำขอมาตรฐาน | สมาชิก | รวมการให้เครดิตต่อช่วงเวลาเรียกเก็บเงิน |
|---|---|---|---|
| จ่ายตามการใช้งาน | US$0.50 | ไม่มีค่าบริการรายเดือน | เติมเครดิตเมื่อจำเป็น |
| Micro | US$0.40 | US$49.00 / เดือน | 1,000 เครดิต (Chonder)US$50.00 ของ API การใช้) รวม |
| Starter | US$0.35 | US$199.00 / เดือน | 4,000 เครดิต (Chonder)US$200.00 ของ API การใช้) รวม |
| Pro | US$0.30 | US$499.00 / เดือน | 10,000 เครดิต (Chonder)US$500.00 ของ API การใช้) รวม |
| Scale | US$0.25 | US$999.00 / เดือน | 20,000 เครดิต (Chonder)US$1,000.00 ของ API การใช้) รวม |
| Business | US$0.20 | US$1,999.00 / เดือน | 40,000 เครดิต (Chonder)US$2,000.00 ของ API การใช้) รวม |
หนึ่งแผนต่อบัญชี ใช้เครดิตร่วมกันทั้งสามผลิตภัณฑ์ การใช้งานที่ครอบคลุมด้วยเครดิตในแผนจะไม่ถูกคิดค่าบริการซ้ำ
ราคาและแผนจํากัดในปัจจุบัน