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

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

YouTube Transcript API

รับคีย์ API

เรียกข้อมูล YouTube สําเนาข้อความด้วยเวลาและเอกสารเต็ม เลือกคําบรรยายภาพให้อัตโนมัติโดยค่าปริยาย

สร้างคำขอ

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

ทิ้งช่องว่างไว้เพื่อลอง 'en-orig' จากนั้น en และกลับมาหนึ่งร่อง หรือป้อนรหัสหนึ่งหรือขึ้น 10 รหัสที่แตกต่างกันโดยเครื่องหมายจุลภาค

แทร็กคําบรรยายภาพ auto
POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_transcript",
    "video_id": "dQw4w9WgXcQ",
    "params": {
        "language": "en",
        "auto": True,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
ผลในการตอบสนอง HTTPX-API-Key ยืนยัน

พารามิเตอร์

ส่ง 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ห้องสมุดมาตรฐาน และไม่มีการร้องขอใหม่

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 = {
    "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
  }
}
results[0]
{
  "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[].codestringlanguage_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. 1. บันทึกงาน IDs

    เก็บรายการที่ต้องการของแหล่งนี้เมื่อสลับไปยัง Async สําหรับ Batchใส่การร้องขอแต่ละในลําดับของ JSON วัตถุ บันทึกงานที่ส่งกลับทั้งหมด 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 ชั่วโมงของการเติมให้สมบูรณ์

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

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

ประมวลผลไฟล์แบบ 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ไม่มีค่าบริการรายเดือนเติมเครดิตเมื่อจำเป็น
MicroUS$0.40US$49.00 / เดือน1,000 เครดิต (Chonder)US$50.00 ของ API การใช้) รวม
StarterUS$0.35US$199.00 / เดือน4,000 เครดิต (Chonder)US$200.00 ของ API การใช้) รวม
ProUS$0.30US$499.00 / เดือน10,000 เครดิต (Chonder)US$500.00 ของ API การใช้) รวม
ScaleUS$0.25US$999.00 / เดือน20,000 เครดิต (Chonder)US$1,000.00 ของ API การใช้) รวม
BusinessUS$0.20US$1,999.00 / เดือน40,000 เครดิต (Chonder)US$2,000.00 ของ API การใช้) รวม

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

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