# Supadata ทางเลือกสำหรับ YouTube ข้อมูล

เปรียบเทียบค่าบทถอดเสียงและเมทาดาทา YouTube คุณสมบัติคำบรรยายจากต้นทาง และสิทธิ์เอเจนต์ ย้ายจาก Supadata ด้วยตัวอย่าง Python และ Bash ที่เรียกใช้ได้

Supadata ตรวจสอบข้อเท็จจริงแล้ว 2026-11-10 FlashData ราคาและค่าเผื่อการทดลองใช้งานใช้แคตตาล็อกสาธารณะในปัจจุบัน

- [คุณสมบัติ](#features)
- [เปรียบเทียบค่าใช้จ่าย](#costs)
- [ย้ายข้อมูลการถอดเสียง](#migration)
- [ข้อมูลเมตาและจำนวนมาก](#workflows)
- [สำหรับตัวแทน AI](#agents)
- [คำถามที่พบบ่อย](#faq)

<a id="features"></a>
## เปรียบเทียบคุณสมบัติ

สำหรับแอปและตัวแทนที่รวบรวมคำบรรยายและข้อมูลเมตาที่มีอยู่ YouTube

### จ่ายต่อเนื่อง YouTube รับแบบประหยัด

| คุณสมบัติ | FlashData | Supadata |
| --- | --- | --- |
| การใช้งานแบบชำระเงินโดยไม่ต้องสมัครสมาชิก | ใช่ — เครดิตแบบจ่ายตามการใช้งาน ซื้อตั้งแต่ $10 | แผนการชำระเงิน — Basic: $60/ปี · Pro: $17/เดือน |
| การถอดเสียงหรือข้อมูลเมตาดั้งเดิม · ราคาต่อ 1,000 | $0.50 — จ่ายตามการใช้งาน · ไม่มีค่าธรรมเนียมรายเดือน | $5.67 บน Pro — $17 / 3,000 included credits; full allowance ใช้แล้ว |
| เป็นกลุ่มโดยไม่มีแผนรายเดือน | มากถึง 100 คำสั่ง / แบทช์ — รหัสเจ้าของแบบจ่ายตามการใช้งาน ขีดจำกัดการทดลองใช้แยกจากกัน | Pro ขึ้นไป — ปลายทางวิดีโอและการถอดเสียง batch |

### ค้นหาวิดีโอและสร้างห้องสมุดวิจัย

| คุณสมบัติ | FlashData | Supadata |
| --- | --- | --- |
| ค้นหาวิดีโอตามหัวข้อ | ใช่ — ค้นหาคำสำคัญด้วยวันที่ ระยะเวลา ประเภท และการเรียงลำดับตัวกรอง | ใช่ — ค้นหาวิดีโอ ช่อง และเพลย์ลิสต์ด้วยตัวกรอง |
| รีเฟรชข้อมูลเมตาของวิดีโอโดยไม่ต้องดึงคำบรรยาย | ใช่ — ชื่อ ช่อง ระยะเวลา ภาพขนาดย่อ และจำนวนการมีส่วนร่วม | ใช่ — แยกจุดสิ้นสุดข้อมูลเมตาด้วยช่องผู้เขียน สื่อ และสถิติ |
| ภาษาคำบรรยายในข้อมูลเมตาของวิดีโอ | ใช่ — hasTranscripts และ transcriptLanguages | ในการตอบกลับการถอดเสียง — availableLangs; มีสคีมาเมทาดาทาแยกต่างหาก |

### เก็บหลักฐานการถอดเสียงที่เป็นประโยชน์สำหรับการอ้างอิงและการวิเคราะห์

| คุณสมบัติ | FlashData | Supadata |
| --- | --- | --- |
| ข้อความประทับเวลาสำหรับการอ้างอิงแหล่งที่มา | JSON ส่วนในไม่กี่วินาที — ข้อความพร้อมเวลาเริ่มต้นและสิ้นสุด | JSON ชิ้นในหน่วยมิลลิวินาที — ข้อความที่มีการชดเชยและระยะเวลา |
| ข้อความเต็มและการประทับเวลาจากการตอบกลับเดียวกัน | ใช่ — fullText และเซ็กเมนต์จะถูกส่งกลับพร้อมกัน | เลือกข้อความหรือชิ้นส่วน — text=true ส่งคืนสตริง หรือเข้าร่วมส่วนต่างๆ ในแอปของคุณ |
| ภาษาคำอธิบายภาพที่มีอยู่หลายภาษาในคำขอเดียว | มากถึง 10 ภาษา — แทร็กและข้อผิดพลาดต่อภาษา | ภาษาหนึ่งที่ต้องการ — พารามิเตอร์ lang บนจุดสิ้นสุดการถอดเสียง |
| เลือกคำบรรยายที่ผู้อัปโหลดให้มาหรือคำบรรยายที่สร้างขึ้น YouTube | ใช่ — ชัดเจน params.auto=false หรือ true | ไม่มีเอกสารตัวเลือกต้นทาง — โหมดเลือกการดึงข้อมูลดั้งเดิมเทียบกับการสร้าง AI |
| จัดการคำบรรยายที่ไม่พร้อมใช้งานอย่างชัดเจน | เพลงที่มีอยู่เท่านั้น — อาร์เรย์ภาษาส่งคืนแทร็กพร้อมข้อผิดพลาด ไม่มีการถอดเสียงใหม่ | เลือกทางเลือกดั้งเดิมหรือ AI — mode=auto สามารถสร้างคำพูดเป็นข้อความได้ ขีดจำกัดดั้งเดิมในการดึงคำอธิบายภาพที่มีอยู่ |

### ย้ายจากคำขอเดียวไปยังเวิร์กโฟลว์ที่ทำซ้ำได้

| คุณสมบัติ | FlashData | Supadata |
| --- | --- | --- |
| คำขอแบบโต้ตอบและพื้นหลัง | เรียลไทม์หรือ async — เลือกโหมดการดำเนินการและบันทึกงาน ID | ผลลัพธ์หรืองานการถอดเสียง — HTTP 200 ส่งคืนข้อมูล; HTTP 202 ส่งคืนงาน ID |
| ประมวลผลรายการวิดีโอที่เตรียมไว้ | คอนโซลชุด API หรือ Bulk Jobs — อัปโหลดไฟล์ ID เก็บรายการและส่วนผลลัพธ์ไว้ | อะซิงก์ batch API · Pro+ — ยอมรับรายการวิดีโอ เพลย์ลิสต์ หรือช่อง |
| รวบรวมเพลย์ลิสต์หรือช่องทั้งหมด | จัดหาวิดีโอที่ชัดเจน IDs — เตรียมรายการก่อนการประมวลผลเป็นชุดหรือจำนวนมาก | เพลย์ลิสต์หรือช่อง batch อินพุต — Regular videos; excludes Shorts and live วิดีโอ |
| เอาต์พุตสำหรับแอปพลิเคชันและ LLM | JSON ข้อความธรรมดา หรือ Markdown — เลือกรูปแบบการตอบกลับและเนื้อหา | JSON พร้อมข้อความหรือชิ้นส่วน — ใช้เนื้อหาการถอดเสียงในแอปพลิเคชันหรือข้อความแจ้งของคุณ |
| SDK ภาษา | Python, TypeScript และไป | Python และ JavaScript / TypeScript |
| MCP เข้าถึงโฮสต์ตัวแทน | ใช่ — รีโมท MCP ด้วย OAuth หรือคีย์ API | ใช่ — เซิร์ฟเวอร์ MCP พร้อมข้อมูลประจำตัว Supadata |
| ทดลองใช้งานแบบเป็นโปรแกรมก่อนลงชื่อสมัครเป็นเจ้าของ | ใช่ — คำขอถอดเสียงเนทีฟสูงสุด 100 · 72 ชั่วโมง | บัญชี API คีย์ก่อน — 100 เครดิตฟรีทุกเดือนหลังจากสมัคร |

Supadata รองรับการถอดเสียงที่สร้างโดย AI และแพลตฟอร์มโซเชียลที่หลากหลาย จุดสิ้นสุดคำบรรยายของ FlashData ดึงข้อมูลแทร็ก YouTube ที่มีอยู่ บริการทั้งสองมี MCP และ SDK

### รักษาภาระงานวิจัยขนาดเล็กให้อยู่ในราคาที่เอื้อมถึง

ชำระเงินสำหรับคำขอข้อมูล YouTube ที่คุณใช้ เพิ่มการสมัครสมาชิกในภายหลังหากอัตราที่ต่ำกว่าและยอดคงเหลือที่รวมอยู่นั้นเหมาะสมกับปริมาณของคุณ

[กำหนดราคาภาระงานของคุณ](#costs)

### รักษาแหล่งที่มาของคำอธิบายภาพให้ชัดเจน

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

[แมปโปรแกรมอ่านข้อความของคุณ](#migration)

### เติบโตจากวิดีโอเดียวไปสู่ไปป์ไลน์

ใช้รูปร่างคำขอเดียวกันสำหรับงาน realtime, async และ batch เพิ่ม Google ค้นหา ไปยังขั้นตอนการวิจัยโดยใช้บัญชีเดียวกันและยอดคงเหลือที่ใช้ร่วมกัน

[สร้างขั้นตอนต่อไป](#workflows)

<a id="costs"></a>
## กำหนดราคาเวิร์กโฟลว์วิดีโอที่สมบูรณ์

USD. การถอดเสียงเจ้าของภาษาหนึ่งรายการในภาษาเดียวหรือการค้นหาข้อมูลเมตาหนึ่งรายการคือหนึ่งคำขอและหนึ่งเครดิต Supadata ข้อมูลเมตาบวกกับการถอดเสียงแบบเนทีฟคือคำขอ 2 รายการต่อวิดีโอ FlashData ใช้แคตตาล็อกข้อมูลสด YouTube โดยใช้มูลค่าเครดิตที่รวมไว้ก่อนการใช้งานเพิ่มเติม อัตราต่อหน่วยที่แสดงเป็นอัตราการใช้งาน Supadata คือค่าธรรมเนียมแผนหารด้วยเบี้ยเลี้ยงรายเดือนเต็มจำนวน Basic เป็นรายปีเท่านั้น: $60 ชำระล่วงหน้า ซึ่งแสดงเป็น $5/เดือน เทียบเท่ากับ 300 เครดิตในแต่ละเดือน ไม่ใช่ 3,600 พร้อมใช้งานทันที แผน Supadata อื่นๆ ใช้ราคาปลีกรายเดือน การเติมเงินอัตโนมัติจะปิดอยู่ในการประมาณนี้จนกว่าจะเลือก เมื่อเลือก ชุดที่เผยแพร่ทั้งหมดที่เล็กที่สุดจะครอบคลุมส่วนที่ขาด ระยะเวลาการเติมอัตโนมัติจริงอาจซื้อเร็วกว่านี้ จำนวนการซื้อถือว่าไม่มียอดคงเหลือเริ่มต้น FlashData การเติมเงินเริ่มต้นที่ $10; การซื้ออาจทำให้มีเงินไว้ใช้ในภายหลัง Supadata เครดิตรายเดือนไม่โรลโอเวอร์ ไม่รวมเครดิตทดลองใช้ ภาษี การใช้งาน API อื่นๆ ส่วนลดรายปีสำหรับแผนอื่นๆ การสร้าง AI และการแปล หากคำขอเป็นศูนย์ ค่าธรรมเนียมแผนที่เลือกจะยังคงอยู่ และอัตราที่มีผลบังคับใช้จะไม่ได้กำหนดไว้

### FlashData YouTube แผนข้อมูล

| FlashData แผน | ต่อคำขอ 1,000 | ค่าบริการรายเดือน | จำนวนคำขอที่รวมต่อเดือน |
| --- | --- | --- | --- |
| ชำระตามการใช้งาน | $0.50 | $0.00 | 0 |
| Micro | $0.40 | $49.00 | 125,000 |
| Starter | $0.35 | $199.00 | 571,428 |
| Pro | $0.30 | $499.00 | 1,666,666 |
| Scale | $0.25 | $999.00 | 4,000,000 |
| Business | $0.20 | $1,999.00 | 10,000,000 |

[ราคาทั้งหมดของ YouTube Data](https://flashdata.dev/th/pricing/youtube-data)

### Supadata แผนการเผยแพร่

| Supadata แผน | วางแผนการชำระเงิน | เครดิต/เดือน | ต่อ 1,000 ที่เบี้ยเลี้ยงเต็มจำนวน | แพ็คเติมเงินอัตโนมัติ |
| --- | --- | --- | --- | --- |
| ฟรี | $0.00 / เดือน | 100 | $0.00 | ไม่สามารถใช้ได้ |
| Basic · annual only | $60.00 / ปี (เทียบเท่า$5.00 / เดือน) | 300 | $16.67 | $10.00 / 1,000 เครดิต |
| Pro · monthly | $17.00 / เดือน | 3,000 | $5.67 | $10.00 / 1,000 เครดิต |
| Mega · monthly | $47.00 / เดือน | 30,000 | $1.57 | $10.00 / 5,000 เครดิต |
| Giga · monthly | $297.00 / เดือน | 300,000 | $0.99 | $20.00 / 20,000 เครดิต |
| Supa · monthly | $897.00 / เดือน | 1,000,000 | $0.90 | $20.00 / 20,000 เครดิต |

### ตัวอย่าง: ข้อมูลเมตาพร้อมการถอดเสียงแบบเนทีฟสำหรับทุกๆ วิดีโอ

FlashData จ่ายตามที่คุณใช้เทียบกับ Supadata Mega ต่อเดือน โดยรวมการเติมเงินอัตโนมัติแล้ว นี่คือการเปรียบเทียบแผนที่ชัดเจนประการหนึ่ง เลือกแผนอื่นๆ ได้อย่างอิสระในเครื่องคิดเลข HTML

| วีดีโอ/เดือน | การร้องขอข้อมูล | FlashData การใช้งานตามแบบจำลอง | Supadata Mega + แพ็กเติมเงินทั้งหมด | แพ็คเติมเงิน |
| --- | --- | --- | --- | --- |
| 100 | 200 | $0.10 | $47.00 | 0 |
| 1,000 | 2,000 | $1.00 | $47.00 | 0 |
| 10,000 | 20,000 | $10.00 | $47.00 | 0 |
| 100,000 | 200,000 | $100.00 | $387.00 | 34 |

### การเข้าถึงฟรีและการสร้าง AI

Supadata เติมฟรี 100 เครดิตรายเดือน การถอดเสียงเป็นภาษาท้องถิ่นใช้หนึ่งหน่วยกิต การสร้าง AI ใช้สองเครดิตต่อนาที ทรานสคริปต์ที่สร้างความยาว 30 นาทีจึงใช้เครดิต 60 โหมดอัตโนมัติเริ่มต้นสามารถทริกเกอร์การสร้างได้ mode=native หลีกเลี่ยงทางเลือกนั้น การสร้าง การแปล และการค้นหาแบบขยายไม่รวมอยู่ในการเปรียบเทียบนี้

การสมัครใช้งานที่ได้รับการยืนยัน FlashData ที่มีสิทธิ์จะได้รับเบี้ยเลี้ยงเริ่มต้นสูงถึง 4,000 มาตรฐาน YouTube คำขอข้อมูล ไม่ใช่ระดับฟรีรายเดือน

<a id="migration"></a>
## ย้ายโปรแกรมอ่านการถอดเสียงแบบเนทีฟ

| เปลี่ยน | Supadata | FlashData | จะทำอย่างไร |
| --- | --- | --- | --- |
| คำขอ | GET /v1/transcript พร้อม url, lang, ข้อความและโหมด | POST /v1/queries/realtime พร้อมแหล่งที่มา video_id และพารามิเตอร์ | แยกอักขระ 11 YouTube ID คีย์ Supadata ไม่รับรองความถูกต้องของ FlashData |
| การยืนยันตัวตน | x-api-key: คีย์ Supadata ของคุณ | X-API-Key: คีย์ FlashData ของคุณ | สร้างหรือใช้ข้อมูลรับรองซ้ำโดยได้รับอนุญาต youtube_transcript ชื่อส่วนหัวไม่คำนึงถึงขนาดตัวพิมพ์ การเปลี่ยนแปลงข้อมูลประจำตัว |
| พื้นเมืองกับที่สร้างขึ้น | mode=native ดึงคำอธิบายภาพที่มีอยู่ รถยนต์สามารถถอยกลับไปเป็น AI ได้ สร้างใช้ AI เสมอ | youtube_transcript อ่านคำบรรยาย YouTube ที่มีอยู่ | ย้ายการดึงข้อมูลดั้งเดิมก่อน แยกขั้นตอนการแปลงคำพูดเป็นข้อความแยกต่างหากสำหรับวิดีโอที่ต้องถอดเสียงใหม่ |
| ที่มาของคำบรรยายภาพ | โหมดเลือกการดึงข้อมูลเทียบกับการสร้าง | params.auto=true เลือก YouTube คำบรรยายที่สร้างขึ้น false เลือกคำบรรยายที่ผู้อัปโหลดให้มา | การตั้งค่าอัตโนมัติเหล่านี้ไม่เท่ากัน FlashData อัตโนมัติจะไม่เริ่มการแปลงคำพูดเป็นข้อความ |
| ภาษา | lang เป็นที่ต้องการ ภาษาที่ไม่พร้อมใช้งานสามารถกลับไปเป็นภาษาแรกที่มีอยู่ได้ | params.language มีความชัดเจน auto=true ลองใช้ตัวแปร -orig จากนั้นตามด้วยรหัสที่ร้องขอ | ตรวจสอบ languageCode และ requestedLanguageCode FlashData จะไม่เลือกภาษาหรือแหล่งที่มาของคำบรรยายอื่นโดยไม่ได้ตั้งใจ |
| เซ็กเมนต์ | เนื้อหา []: ข้อความ ออฟเซ็ต และระยะเวลาเป็นมิลลิวินาที | results[0].segments[]: ข้อความ เริ่มต้นและสิ้นสุดในหน่วยวินาที | ออฟเซ็ต = รอบ (เริ่ม × 1000); ระยะเวลา = รอบ((สิ้นสุด - เริ่มต้น) × 1000) รักษาการทับซ้อนกันแทนที่จะเปลี่ยนตัวชี้นำ |
| ข้อความธรรมดา | text=true ส่งคืนเนื้อหาเป็นสตริง | ผลลัพธ์[0].fullText | อ่าน fullText เพื่อการสรุป และเก็บส่วนต่างๆ ไว้เพื่อใช้อ้างอิงการประทับเวลา |
| การค้นพบภาษา | availableLangs ในการตอบกลับการถอดเสียง | transcriptLanguages ใน youtube_metadata | ดึงข้อมูลเมตาเมื่อแอปของคุณต้องการรายการภาษาทั้งหมด อย่าประดิษฐ์ availableLangs จากหนึ่งแทร็กที่ส่งคืน |
| เสร็จสิ้น | HTTP 200 ผลลัพธ์ หรือ HTTP 202 + jobId | สถานะเรียลไทม์=done; async ส่งกลับ FlashData งาน IDs | จัดการสถานะของผู้ให้บริการแต่ละรายแยกกัน ทำงาน Supadata ที่มีอยู่ให้เสร็จเรียบร้อยก่อนที่จะย้ายงานใหม่ |

### 1. ตั้งค่าการเข้าถึง

สร้างหรือใช้คีย์ FlashData เดิมที่มีสิทธิ์ youtube_transcript ใน [คีย์ API](https://flashdata.dev/app/api-keys) เพิ่ม youtube_metadata หากต้องการทำงานเมทาดาทา ตรวจสอบ [เครดิตที่ใช้ได้](https://flashdata.dev/app/billing) หรือใช้ [สิทธิ์ทดลองใช้สำหรับเอเจนต์ที่เข้าเกณฑ์](#agents) เก็บคีย์ในตัวแปรสภาพแวดล้อมหรือที่เก็บข้อมูลลับ

Supadata คำขอดั้งเดิมถูกแทนที่:

```bash
# Existing Supadata call: use your saved SUPADATA_API_KEY.
curl --get --fail-with-body --silent --show-error \
  'https://api.supadata.ai/v1/transcript' \
  --header "x-api-key: $SUPADATA_API_KEY" \
  --data-urlencode 'url=https://www.youtube.com/watch?v=FUfGcZ092b0' \
  --data-urlencode 'lang=en' --data-urlencode 'text=false' \
  --data-urlencode 'mode=native'
```

FlashData เปลี่ยน JSON ร่างกายสำหรับ POST /v1/queries/realtime:

```json
{
  "source": "youtube_transcript",
  "video_id": "FUfGcZ092b0",
  "params": {
    "language": "en",
    "auto": true
  }
}
```

### 2. บันทึกสคริปต์ จากนั้นเรียกใช้

เลือก Python หรือ Bash แต่ละโฟลเดอร์เอาต์พุตใหม่ส่งหนึ่งคำขอ การใช้โฟลเดอร์ซ้ำจะอ่านเอาต์พุตที่บันทึกไว้โดยไม่ต้องเรียก API อีกครั้ง เวอร์ชันแชร์รูปแบบไฟล์ที่บันทึกไว้ เลือกวิดีโอที่มีแทร็กคำบรรยายที่ร้องขอ

#### Python

ต้องใช้ Python 3.10+ ติดตั้งไลบรารีด้วย python -m pip install requests ในโฟลเดอร์ทำงานใหม่ ให้บันทึกสคริปต์ฉบับเต็มด้านล่างเป็น youtube-migrate.py ก่อนเรียกใช้

```python
import argparse
import getpass
import json
import math
import os
import re
from pathlib import Path

import requests

parser = argparse.ArgumentParser()
parser.add_argument("operation", choices=["transcript", "metadata"])
parser.add_argument("video_id")
parser.add_argument("folder", type=Path)
parser.add_argument("--language", default="en")
parser.add_argument("--origin", choices=["auto", "manual"], default="auto")
args = parser.parse_args()
if not re.fullmatch(r"[A-Za-z0-9_-]{11}", args.video_id):
    raise SystemExit("Use an 11-character YouTube video ID")
source = "youtube_" + args.operation
params = ({"language": args.language, "auto": args.origin == "auto"}
          if args.operation == "transcript"
          else {"include_formats": False, "include_chapters": True})
body = {"source": source, "video_id": args.video_id, "params": params}
out = args.folder
if not out.exists():
    key = os.environ.get("FLASHDATA_API_KEY") or getpass.getpass("FlashData API key: ")
    if not key.strip():
        raise SystemExit("An API key is required")
    out.mkdir(parents=True)
    (out / "request.json").write_text(json.dumps(body), encoding="utf-8")
    try:
        response = requests.post(
            "https://data.flashdata.dev/v1/queries/realtime", json=body,
            headers={"X-API-Key": key, "Accept": "application/json"},
            timeout=120, allow_redirects=False,
        )
    except requests.RequestException:
        raise SystemExit("Outcome unknown. Keep this folder and check History before retrying.")
    (out / "response.json").write_bytes(response.content)
    (out / "http-status.txt").write_text(str(response.status_code), encoding="utf-8")
    (out / "retry-after.txt").write_text(response.headers.get("Retry-After", ""), encoding="utf-8")
else:
    print("Reading saved output; no API call.")

try:
    saved_request = json.loads((out / "request.json").read_text(encoding="utf-8"))
    status = (out / "http-status.txt").read_text(encoding="utf-8").strip()
except (OSError, ValueError):
    raise SystemExit("Incomplete attempt. Inspect this folder and History before retrying.")
if saved_request != body:
    raise SystemExit("This folder belongs to a different request. Use a new folder.")
if status != "200":
    raise SystemExit(f"HTTP {status}: inspect response.json and retry-after.txt")
data = json.loads((out / "response.json").read_text(encoding="utf-8"))
if not isinstance(data, dict) or data.get("status") != "done" or data.get("source") != source:
    raise SystemExit("Request did not complete successfully; inspect response.json")
results = data.get("results")
if not isinstance(results, list) or len(results) != 1 or not isinstance(results[0], dict):
    raise SystemExit("Expected one result; inspect response.json")
item = results[0]
if item.get("videoId") != args.video_id:
    raise SystemExit("Returned video does not match the request")
if args.operation == "transcript":
    allowed = {args.language}
    if args.origin == "auto" and not args.language.endswith("-orig"):
        allowed.add(args.language + "-orig")
    if item.get("languageCode") not in allowed or item.get("isAutoGenerated") is not params["auto"]:
        raise SystemExit("Returned caption language or origin does not match")
    if not isinstance(item.get("segments"), list):
        raise SystemExit("Expected caption segments")
    content = []
    for cue in item["segments"]:
        if not isinstance(cue, dict):
            raise SystemExit("Invalid caption segment")
        start, end, text = cue.get("start"), cue.get("end"), cue.get("text")
        if (type(start) not in (int, float) or type(end) not in (int, float)
                or not math.isfinite(start) or not math.isfinite(end)
                or start < 0 or end < start or not isinstance(text, str)):
            raise SystemExit("Invalid caption segment")
        content.append({"text": text, "offset": round(start * 1000),
                        "duration": round((end - start) * 1000)})
    normalized = {"content": content, "lang": item["languageCode"].removesuffix("-orig")}
else:
    normalized = {name: item.get(name) for name in (
        "videoId", "title", "channel", "duration", "viewCount", "likeCount",
        "commentCount", "hasTranscripts", "transcriptLanguages", "chapters")}
(out / "normalized.json").write_text(
    json.dumps(normalized, ensure_ascii=False, indent=2) + "\n", encoding="utf-8"
)
print(f"Saved {out}/normalized.json; actual usage: {json.dumps(data.get('usage'))}")

```

เรียกใช้จากโฟลเดอร์ทำงานนั้น:

```bash
python youtube-migrate.py transcript FUfGcZ092b0 transcript-001
```

ซึ่งจะเลือกคำบรรยายภาษาอังกฤษที่สร้างขึ้น YouTube เพิ่ม --origin คู่มือสำหรับแทร็กที่ผู้อัปโหลดให้มา หรือ --language CODE เพื่อเลือกภาษา

คำขอข้อมูลเมตาแยกต่างหากเพิ่มเติม:

```bash
python youtube-migrate.py metadata FUfGcZ092b0 metadata-001
```

#### Bash

ต้องใช้ Bash, cURL 7.76+ และ jq 1.6+ บันทึกสคริปต์ที่สมบูรณ์นี้เป็น youtube-migrate.sh ในโฟลเดอร์ทำงานของคุณก่อน running:

```bash
#!/usr/bin/env bash
set -euo pipefail
operation="${1:?Use: transcript|metadata VIDEO_ID OUTPUT_FOLDER [LANGUAGE] [auto|manual]}"
video_id="${2:?Set VIDEO_ID}"
out="${3:?Set OUTPUT_FOLDER}"
language="${4:-en}"
origin="${5:-auto}"
[[ "$operation" == transcript || "$operation" == metadata ]] || exit 1
[[ "$video_id" =~ ^[A-Za-z0-9_-]{11}$ ]] || exit 1
[[ "$origin" == auto || "$origin" == manual ]] || exit 1
body=$(jq -n --arg source "youtube_$operation" --arg id "$video_id" \
  --arg language "$language" --arg origin "$origin" '
  {source: $source, video_id: $id, params:
    (if $source == "youtube_transcript" then {language: $language, auto: ($origin == "auto")}
     else {include_formats: false, include_chapters: true} end)}')
if [[ ! -e "$out" ]]; then
  if [[ -z "${FLASHDATA_API_KEY:-}" ]]; then
    read -r -s -p 'FlashData API key: ' FLASHDATA_API_KEY; printf '\n'
  fi
  : "${FLASHDATA_API_KEY:?An API key is required}"
  mkdir -p -- "$out"
  printf '%s\n' "$body" > "$out/request.json"
  curl --fail-with-body --silent --show-error --max-time 120 \
    --request POST 'https://data.flashdata.dev/v1/queries/realtime' \
    --header "X-API-Key: $FLASHDATA_API_KEY" \
    --header 'Content-Type: application/json' --header 'Accept: application/json' \
    --data-binary "@$out/request.json" --output "$out/response.json" \
    --dump-header "$out/response-headers.txt" --write-out '%{http_code}' \
    > "$out/http-status.txt" || {
      printf 'Request failed. Keep the output folder and inspect History before retrying.\n' >&2
      exit 1
    }
else
  printf 'Reading saved output; no API call.\n'
fi
jq -e --argjson expected "$body" '. == $expected' "$out/request.json" >/dev/null
[[ "$(cat "$out/http-status.txt")" == 200 ]] || {
  printf 'Inspect the saved HTTP status, response and Retry-After header.\n' >&2; exit 1;
}
normalized=$(jq -e --argjson request "$body" '
  if .source != $request.source or .status != "done" then error("Request not done") else . end
  | .results | if type != "array" then error("Expected results")
    elif length != 1 then error("Expected one result") else .[0] end
  | if .videoId != $request.video_id then error("Wrong video") else . end
  | if $request.source == "youtube_metadata" then
      {videoId, title, channel, duration, viewCount, likeCount, commentCount,
       hasTranscripts, transcriptLanguages, chapters}
    else
      if (.languageCode != $request.params.language and
          ($request.params.auto != true or ($request.params.language | endswith("-orig")) or
           .languageCode != ($request.params.language + "-orig"))) or
          .isAutoGenerated != $request.params.auto then error("Wrong language or origin") else . end
      | {lang: (.languageCode | sub("-orig$"; "")), content: [.segments[] |
          if (.start | type) != "number" or (.end | type) != "number" or (.text | type) != "string"
          then error("Invalid caption segment")
          elif (.start | isfinite | not) or (.end | isfinite | not) or .start < 0 or .end < .start
          then error("Invalid caption timing")
          else {text, offset: (.start * 1000 | round), duration: ((.end - .start) * 1000 | round)} end]}
    end' "$out/response.json")
printf '%s\n' "$normalized" > "$out/normalized.json"
printf 'Saved %s/normalized.json; actual usage: ' "$out"
jq -c '.usage' "$out/response.json"

```

เรียกใช้จากโฟลเดอร์ทำงานนั้น:

```bash
bash youtube-migrate.sh transcript FUfGcZ092b0 transcript-001
```

อาร์กิวเมนต์เพิ่มเติมหลังโฟลเดอร์คือภาษาและต้นกำเนิด ตัวอย่างเช่น en manual เลือกคำบรรยายภาษาอังกฤษที่ผู้อัปโหลดให้มา

คำขอข้อมูลเมตาแยกต่างหากเพิ่มเติม:

```bash
bash youtube-migrate.sh metadata FUfGcZ092b0 metadata-001
```

สำหรับการเข้าถึงแบบทดลองใช้ชั่วคราว ให้เรียกใช้คำขอตามลำดับห่างกันอย่างน้อยหนึ่งวินาที

### 3. อ่านผลลัพธ์

response.json คงผลลัพธ์ดิบและการใช้งาน normalized.json แปลงวินาทีของการถอดเสียงเป็นออฟเซ็ต/duration มิลลิวินาที นี่คืออะแดปเตอร์เซ็กเมนต์ ไม่ใช่การตอบสนองที่เข้ากันได้กับ Supadata ที่สมบูรณ์: availableLangs ไม่ได้ถูกสร้างขึ้น เอาต์พุตข้อมูลเมตาจะรักษาค่าที่เป็นโมฆะ คำขอที่ล้มเหลวหรือถูกขัดจังหวะจะเก็บหลักฐานไว้และหยุด

ภาพประกอบ normalized.json:

```json
{
  "content": [
    {
      "text": "Example caption text.",
      "offset": 1250,
      "duration": 2250
    }
  ],
  "lang": "en"
}
```

[สคีมาบทถอดเสียง](https://flashdata.dev/th/docs/sources/youtube_transcript/reference.md)

<a id="workflows"></a>
## ข้อมูลเมตาและเวิร์กโฟลว์จำนวนมาก

| ข้อมูล | Supadata /v1/metadata | FlashData youtube_metadata |
| --- | --- | --- |
| ข้อมูลประจำตัวของวิดีโอ | id | ผลลัพธ์[0].videoId |
| ชื่อและคำอธิบาย | ชื่อคำอธิบาย | results[0].title, results[0].description |
| ช่อง | author.displayName; additionalData.channelId | ผลลัพธ์[0].channel; ผลลัพธ์[0].channelId |
| การมีส่วนร่วม | stats.views, stats.likes, stats.comments | ผลลัพธ์[0].viewCount, likeCount, commentCount |
| ระยะเวลา | media.duration (วินาที) | ผลลัพธ์[0].ระยะเวลา (วินาที) |
| ภาพขนาดย่อ | media.thumbnailUrl | ผลลัพธ์[0].ภาพขนาดย่อ[]; เลือกขนาดที่แอปของคุณต้องการ |
| วันที่ตีพิมพ์ | createdAt | ผลลัพธ์[0].uploadDate; ปรับรูปแบบให้เป็นมาตรฐานในแอปของคุณ |
| การค้นพบคำบรรยายภาพ | อ่าน availableLangs จากการตอบกลับการถอดเสียง | ผลลัพธ์[0].hasTranscripts และ transcriptLanguages |

### มีหลายภาษาในคำขอเดียว

ส่งอาร์เรย์ภาษาเพื่อรับแทร็กและข้อผิดพลาด แม้ว่าอาร์เรย์จะมีภาษาเดียวก็ตาม ตรวจสอบข้อผิดพลาดแม้ว่าสถานะจะเป็น done เพลงเหล่านี้เป็นเพลงที่มีอยู่ ไม่มีการแปลหรือสร้างคำบรรยาย

```json
{
  "source": "youtube_transcript",
  "video_id": "FUfGcZ092b0",
  "params": {
    "language": [
      "en",
      "es"
    ],
    "auto": true
  }
}
```

### เติมเต็มห้องสมุดการวิจัย

ดึงข้อมูลเมตาหนึ่งครั้ง บันทึกวิดีโอ ID และภาษาคำบรรยายที่ใช้ได้ จากนั้นดึงข้อมูลแทร็กที่คุณต้องการ ให้นับการมีส่วนร่วมที่เป็นโมฆะเป็น null แทนที่จะแปลงให้เป็นศูนย์

[YouTube แนวทางปฏิบัติที่ดีที่สุดของข้อมูล](https://flashdata.dev/th/docs/guides/youtube-data-guide/reference.md)

### ประมวลผลรายการวิดีโอ IDs

ขยายอินพุตของคุณให้เป็นวิดีโอที่มีเนื้อหาโจ่งแจ้ง IDs จากนั้นใช้ไฟล์เป็นกลุ่มหรือไฟล์จำนวนมาก FlashData ไม่ยอมรับ Supadata playlistId เป็นอินพุตดรอปอิน batch บันทึกสถานะและเอาต์พุตต่อรายการก่อนลองรายการ failed อีกครั้ง

[เอกสารอ้างอิงการประมวลผล Bulk](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md)

### ดำเนินการวิจัยตามกำหนดเวลา

ยืนยันข้อมูลประจำตัวของเจ้าของ วิดีโอจุดตรวจสอบ completed และอ่านเอาต์พุตที่บันทึกไว้เมื่อรีสตาร์ท หยุดการเข้าถึงที่ถูกเพิกถอนหรือยอดคงเหลือไม่เพียงพอ อย่าสร้างการทดลองอีกครั้งเพื่อทำงานตามกำหนดการต่อไป

[งานที่ทำเป็นประจำ](https://flashdata.dev/th/docs/guides/recurring-tasks/reference.md)

### Production การตัดสินใจในการโยกย้าย

- แก้ไขอินพุตเพลย์ลิสต์/channelไปยังวิดีโอโจ่งแจ้ง IDs ก่อน FlashData การประมวลผลไฟล์เป็นชุดหรือเป็นกลุ่ม Supadata playlistId ไม่ใช่อินพุตแบบดรอปอิน
- การค้นหา Supadata มีค่าใช้จ่ายหนึ่งเครดิตต่อ 20-หน้าผลลัพธ์ หรือ ceil(limit/20) แบบมีขีดจำกัด FlashData มาตรฐาน YouTube การค้นหารองรับผลลัพธ์สูงสุด 20 Extended Search มีอัตราแยกต่างหาก กรองแผนที่และไม่ถ่ายโอนโทเค็นหน้า
- Supadata บันทึกหน้าต่างผลลัพธ์งานการถอดเสียงหนึ่งชั่วโมง completed ระบายงานที่มีอยู่และจัดเก็บผลลัพธ์ก่อนที่จะย้ายงานใหม่ แยกงานเฉพาะของผู้ให้บริการ IDs ออกจากกัน
- เก็บสื่อข้ามแพลตฟอร์ม การดึงข้อมูลด้วย AI การแปล และการถอดเสียงไว้ในเส้นทางที่มีอยู่ เว้นแต่จะมีการใช้เวิร์กโฟลว์ที่เทียบเท่ากัน

<a id="agents"></a>
## ตัวแทนทดลองใช้งาน อ้างสิทธิ์ และใช้งานซ้ำ

ตัวแทนที่มีสิทธิ์สามารถเริ่มต้นด้วยเครดิต 1 สูงสุด 100 คำขอใบรับรองผลการเรียนดั้งเดิมเป็นเวลา 72 ชั่วโมง ข้อมูลเมตาและการถอดเสียงแบ่งปันค่าเผื่อนี้

1. ใช้การเข้าถึงที่มีอยู่ซ้ำก่อน หรือเริ่มต้นการทดลองใช้ที่มีสิทธิ์หนึ่งครั้งโดยมีสิทธิ์ที่จำเป็นเท่านั้น
2. ส่งคืนผลลัพธ์ที่เป็นประโยชน์ บันทึกเอาต์พุตดิบและการใช้งาน และเก็บโปรไฟล์และไดเร็กทอรีสถานะเดียวกัน
3. เจ้าของลงชื่อเข้าใช้หรือลงทะเบียน ยืนยันอีเมล และอนุมัติการอ้างสิทธิ์ ขอบเขต และการเข้าถึงยอดคงเหลือที่ใช้ร่วมกัน
4. ใช้ข้อมูลรับรองของเจ้าของบัญชีเดิมสำหรับงานประจำ เครดิตทดลองใช้ที่เหลือจะไม่ถูกโอน หยุดเมื่อสิทธิ์ถูกเพิกถอนหรือยอดคงเหลือไม่พอ อย่าสร้างสิทธิ์ทดลองใหม่เพื่อทำงานต่อ

```text
Migrate the native YouTube transcript part of this project from Supadata to FlashData.
Read https://flashdata.dev/auth.md and https://flashdata.dev/docs/sources/youtube_transcript/reference.md.
Reuse a saved FlashData credential before requesting an eligible temporary trial.
Use youtube_transcript permission and one explicit video ID, language and caption origin.
Do not map Supadata mode=auto to FlashData auto=true: the latter selects existing YouTube-generated captions.
Save the raw response and actual usage. Convert segment seconds to milliseconds if my reader expects offset/duration.
Do not fabricate captions or available languages. Report missing tracks and keep AI generation separate.
Ask the owner to claim access before recurring use. Store credentials outside chat and source control.
Reuse saved outputs on restart and stop after revocation; never create repeated trials to keep running.
```

[ทดลองใช้และเชื่อมโยงบัญชี](https://flashdata.dev/th/docs/guides/agent-onboarding/reference.md) · [CLI แบบสแตนด์อโลน](https://flashdata.dev/th/docs/guides/flashdata-cli/reference.md) · [การเชื่อมต่อ MCP](https://flashdata.dev/th/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>
## คำถามเกี่ยวกับการโยกย้าย

### FlashData สามารถแทนที่การถอดเสียง AI ของ Supadata ได้หรือไม่

แหล่งที่มาของการถอดเสียงและคำบรรยายของ FlashData ดึงคำบรรยายที่มีอยู่แล้วใน YouTube พวกเขาไม่ถอดเสียง แปลข้อความ หรือวิเคราะห์ภาพ ย้ายการดึงข้อมูลเนทิฟ YouTube ไปที่ FlashData; มีบริการแยกต่างหากสำหรับการแปลงคำพูดเป็นข้อความ วิดีโอข้ามแพลตฟอร์ม หรือการแยก AI เมื่อแอปพลิเคชันของคุณต้องการ

### คำขอหนึ่งซื้ออะไร

เครื่องคิดเลขครอบคลุมการถอดเสียงที่มีอยู่ในภาษาเดียวหรือการค้นหาข้อมูลเมตาของวิดีโอหนึ่งรายการ การดึงข้อมูลทั้งสองรายการใช้สองคำขอต่อวิดีโอ Supadata เรียกเก็บเงินแต่ละการดำเนินการเหล่านี้ด้วยเครดิตเดียว FlashData ใช้อัตราข้อมูล YouTube ของแผนที่เลือก การค้นหาแบบขยาย การถอดเสียงด้วย AI การแปล และการนำเสนอสื่ออยู่นอกเหนือการประมาณการนี้

### FlashData ถูกกว่าเสมอเหรอ?

เปรียบเทียบตามปริมาณงานจริงและแพ็กเกจที่เลือก แพ็กเกจ Free ของ Supadata ให้ 100 เครดิตทุกเดือน สิทธิ์ทดลองใช้ชั่วคราวสำหรับเอเจนต์ของ FlashData มีขีดจำกัดและวันหมดอายุ ไม่ใช่แพ็กเกจฟรีรายเดือน หากใช้งานน้อย สิทธิ์ฟรีอาจเพียงพอสำหรับทั้งงาน ค่าบริการแพ็กเกจ แพ็กเติมเงิน และยอดคงเหลือที่ไม่ได้ใช้ล้วนมีผลต่อจำนวนเงินที่คุณจ่าย

### Supadata รองรับ MCP และ SDK แล้วหรือยัง

ใช่ บริการทั้งสองรองรับการผสานรวม MCP และ Python/JavaScript FlashData ยังมี Go SDK แบบสแตนด์อโลน CLI และการทดลองใช้ตัวแทนชั่วคราวที่สามารถอ้างสิทธิ์ในการเข้าถึงแบบประจำได้ เลือกอินเทอร์เฟซที่โฮสต์ของคุณรองรับ MCP เพียงอย่างเดียวไม่ใช่เหตุผลที่จะเปลี่ยน

### จะเกิดอะไรขึ้นหากแทร็กคำบรรยายหายไป

ถือเป็นช่องว่างข้อมูล FlashData จะไม่สลับระหว่างคำบรรยายที่ผู้อัปโหลดให้มากับคำบรรยายที่สร้างโดย YouTube หรือสังเคราะห์การถอดเสียง สำหรับอาร์เรย์ภาษา ให้ตรวจสอบข้อผิดพลาดแม้ว่าคำขอจะเป็น done ก็ตาม Supadata สามารถสร้างการถอดเสียงในโหมดอัตโนมัติ ในขณะที่โหมดเนทิฟสามารถส่งคืน HTTP 206 สำหรับการถอดเสียงที่ไม่พร้อมใช้งาน เอกสารประกอบการเรียกเก็บเงินนั้นตอบกลับด้วยเครดิตเดียว

### ฉันสามารถคงรูปแบบการตอบสนองของแอปพลิเคชันที่มีอยู่ไว้ได้หรือไม่

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

[รับคีย์ API](https://flashdata.dev/signup)
