# Supadata Thay thế cho dữ liệu YouTube

So sánh chi phí bản ghi và siêu dữ liệu YouTube, tính năng phụ đề gốc và quyền truy cập của tác nhân. Di chuyển từ Supadata với các ví dụ Python và Bash có thể chạy được.

Supadata sự kiện được xem xét 2026-11-10. FlashData giá cả và trợ cấp dùng thử sử dụng danh mục công khai hiện tại của nó.

- [Tính năng](#features)
- [So sánh chi phí](#costs)
- [Di chuyển bản ghi](#migration)
- [Siêu dữ liệu & số lượng lớn](#workflows)
- [Dành cho tác nhân AI](#agents)
- [Câu hỏi thường gặp](#faq)

<a id="features"></a>
## So sánh tính năng

Dành cho các ứng dụng và tác nhân thu thập chú thích và siêu dữ liệu YouTube hiện có.

### Tiếp tục thanh toán YouTube truy xuất tiết kiệm

| tính năng | FlashData | Supadata |
| --- | --- | --- |
| Sử dụng trả phí mà không cần đăng ký | Có — Tín dụng thanh toán khi bạn di chuyển; mua hàng từ $10 | Gói trả phí — Basic: $60/năm · Pro: $17/tháng |
| Bản ghi gốc hoặc siêu dữ liệu · giá mỗi 1,000 | $0.50 — Thanh toán theo nhu cầu · không tính phí hàng tháng | $5.67 trên Pro — $17 / 3,000 included credits; full allowance đã qua sử dụng |
| Hàng loạt không có gói hàng tháng | Lên tới 100 truy vấn / Lô — Chìa khóa chủ sở hữu trả tiền khi bạn sử dụng; giới hạn dùng thử là riêng biệt | Pro trở lên — Điểm cuối video và bản ghi batch |

### Tìm video và xây dựng thư viện nghiên cứu

| tính năng | FlashData | Supadata |
| --- | --- | --- |
| Tìm video theo chủ đề | Có — Tìm kiếm từ khóa với các bộ lọc ngày, thời lượng, loại và sắp xếp | Có — Tìm kiếm video, kênh và danh sách phát bằng các bộ lọc |
| Làm mới siêu dữ liệu video mà không cần tìm nạp phụ đề | Có — Tiêu đề, kênh, thời lượng, hình thu nhỏ và số lượng tương tác | Có — Điểm cuối siêu dữ liệu riêng biệt với các trường tác giả, phương tiện và số liệu thống kê |
| Ngôn ngữ phụ đề trong siêu dữ liệu video | Có — hasTranscripts và transcriptLanguages | Trong bản ghi phản hồi — availableLangs; lược đồ siêu dữ liệu riêng biệt |

### Giữ bản ghi hữu ích cho việc trích dẫn và phân tích

| tính năng | FlashData | Supadata |
| --- | --- | --- |
| Văn bản được đánh dấu thời gian cho các trích dẫn nguồn | JSON phân đoạn tính bằng giây — Văn bản có thời gian bắt đầu và kết thúc | JSON khối tính bằng mili giây — Văn bản có độ lệch và thời lượng |
| Toàn văn và dấu thời gian từ cùng một phản hồi | Có — fullText và các phân đoạn được trả về cùng nhau | Chọn văn bản hoặc các đoạn — text=true trả về một chuỗi; mặt khác hãy tham gia các phần trong ứng dụng của bạn |
| Nhiều ngôn ngữ phụ đề hiện có trong một yêu cầu | Lên tới 10 ngôn ngữ — Các bản nhạc và lỗi theo ngôn ngữ | Một ngôn ngữ ưa thích — tham số lang trên điểm cuối của bản ghi |
| Chọn phụ đề do người tải lên cung cấp hoặc YouTube tạo | Có — Rõ ràng params.auto=false hoặc true | Không có tài liệu về bộ chọn nguồn gốc — chế độ chọn truy xuất gốc so với tạo AI |
| Xử lý rõ ràng các chú thích không có sẵn | Chỉ các bản nhạc hiện có — Mảng ngôn ngữ trả về các bản nhạc cộng với lỗi; không có phiên âm mới | Chọn dự phòng gốc hoặc AI — mode=auto có thể tạo giọng nói thành văn bản; truy xuất giới hạn gốc cho phụ đề hiện có |

### Chuyển từ một yêu cầu sang quy trình làm việc lặp lại

| tính năng | FlashData | Supadata |
| --- | --- | --- |
| Yêu cầu tương tác và nền | Thời gian thực hoặc async — Chọn chế độ thực hiện và lưu công việc ID | Kết quả hoặc bảng điểm công việc — HTTP 200 trả về dữ liệu; HTTP 202 trả lại công việc ID |
| Xử lý danh sách video đã chuẩn bị | Bảng điều khiển hàng loạt API hoặc Bulk Jobs — Tải lên tệp ID; giữ các phần kê khai và kết quả | Không đồng bộ batch API · Pro+ — Chấp nhận danh sách video, danh sách phát hoặc kênh |
| Thu thập toàn bộ danh sách phát hoặc kênh | Cung cấp video rõ ràng IDs — Chuẩn bị danh sách trước khi xử lý hàng loạt hoặc hàng loạt | Danh sách phát hoặc kênh đầu vào batch — Regular videos; excludes Shorts and live video |
| Đầu ra cho các ứng dụng và LLM | JSON, văn bản thuần túy hoặc Markdown — Chọn câu trả lời và định dạng nội dung | JSON với văn bản hoặc đoạn — Sử dụng nội dung bảng điểm trong đơn đăng ký hoặc lời nhắc của bạn |
| SDK ngôn ngữ | Python, TypeScript và Đi | Python và JavaScript / TypeScript |
| MCP quyền truy cập cho máy chủ tác nhân | Có — Điều khiển từ xa MCP bằng OAuth hoặc phím API | Có — máy chủ MCP có thông tin xác thực Supadata |
| Dùng thử có lập trình trước khi đăng ký chủ sở hữu | Có — Lên tới 100 yêu cầu bảng điểm gốc · 72 giờ | Chìa khóa tài khoản API trước tiên — 100 tín dụng miễn phí mỗi tháng sau khi đăng ký |

Supadata hỗ trợ phiên âm do AI tạo và nhiều nền tảng xã hội. Điểm cuối chú thích của FlashData truy xuất các bản nhạc YouTube hiện có. Cả hai dịch vụ đều cung cấp MCP và SDK.

### Giữ khối lượng công việc nghiên cứu nhỏ ở mức giá phải chăng

Trả tiền cho YouTube yêu cầu dữ liệu bạn sử dụng. Hãy thêm đăng ký sau nếu tỷ lệ thấp hơn và số dư đi kèm phù hợp với khối lượng của bạn.

[Định giá khối lượng công việc của bạn](#costs)

### Giữ nguồn phụ đề rõ ràng

Chọn phụ đề do YouTube tạo hoặc do người tải lên cung cấp, giữ nguyên ngôn ngữ được trả về và giữ nguyên dấu thời gian cho các trích dẫn. Yêu cầu các bản nhạc hiện có bằng nhiều ngôn ngữ mà không tạo ra tính năng chuyển lời nói thành văn bản mới.

[Ánh xạ trình đọc bản ghi của bạn](#migration)

### Phát triển từ một video thành một kênh truyền thông

Sử dụng hình dạng yêu cầu tương tự cho công việc realtime, async và batch. Thêm Google Tìm kiếm vào quy trình nghiên cứu bằng cùng một tài khoản và số dư chung.

[Xây dựng bước tiếp theo](#workflows)

<a id="costs"></a>
## Định giá quy trình làm việc video hoàn chỉnh

USD. Một bản ghi gốc bằng một ngôn ngữ hoặc một bản tra cứu siêu dữ liệu là một yêu cầu và một tín dụng Supadata. Siêu dữ liệu cộng với bản ghi gốc là hai yêu cầu cho mỗi video. FlashData sử dụng danh mục dữ liệu YouTube trực tiếp của mình, áp dụng giá trị tín dụng đi kèm trước khi sử dụng thêm. Tỷ lệ đơn vị được hiển thị của nó là tỷ lệ sử dụng; Supadata's là phí chương trình chia cho toàn bộ trợ cấp hàng tháng. Basic chỉ dành cho hàng năm: $60 trả trước, hiển thị là $5/tháng tương đương với 300 tín dụng mỗi tháng, không phải 3,600 có sẵn ngay lập tức. Các gói Supadata khác sử dụng giá niêm yết hàng tháng. Tính năng Tự động nạp lại bị tắt trong ước tính này cho đến khi được chọn; khi được chọn, toàn bộ gói được xuất bản nhỏ nhất sẽ bù đắp phần thiếu hụt. Thời gian nạp tiền tự động thực tế có thể mua sớm hơn. Số tiền mua giả định không có số dư ban đầu. FlashData nạp tiền bắt đầu từ $10; việc mua hàng có thể để lại tiền cho lần sau. Supadata tín dụng hàng tháng không được chuyển đổi. Tín dụng dùng thử, thuế, cách sử dụng API khác, giảm giá hàng năm cho các gói khác, tạo và dịch thuật AI đều bị loại trừ. Khi không có yêu cầu nào, phí gói đã chọn vẫn giữ nguyên và tỷ lệ hiệu quả không được xác định.

### FlashData YouTube Gói dữ liệu

| kế hoạch FlashData | Mỗi 1,000 yêu cầu | Phí hằng tháng | Số yêu cầu đi kèm mỗi tháng |
| --- | --- | --- | --- |
| Thanh toán theo mức sử dụng | $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 |

[Bảng giá YouTube Data đầy đủ](https://flashdata.dev/vi/pricing/youtube-data)

### Supadata kế hoạch được công bố

| kế hoạch Supadata | Gói thanh toán | Tín chỉ/tháng | Mỗi 1,000 với mức trợ cấp đầy đủ | Gói nạp tiền tự động |
| --- | --- | --- | --- | --- |
| Miễn phí | $0.00 / tháng | 100 | $0.00 | Không có sẵn |
| Basic · annual only | $60.00 / năm (tương đương $5.00 / tháng) | 300 | $16.67 | $10.00 / 1,000 tín dụng |
| Pro · monthly | $17.00 / tháng | 3,000 | $5.67 | $10.00 / 1,000 tín dụng |
| Mega · monthly | $47.00 / tháng | 30,000 | $1.57 | $10.00 / 5,000 tín dụng |
| Giga · monthly | $297.00 / tháng | 300,000 | $0.99 | $20.00 / 20,000 tín dụng |
| Supa · monthly | $897.00 / tháng | 1,000,000 | $0.90 | $20.00 / 20,000 tín dụng |

### Ví dụ: siêu dữ liệu cộng với bản ghi gốc cho mỗi video

FlashData thanh toán theo mức sử dụng so với Supadata Mega hàng tháng, bao gồm tính năng Tự động nạp tiền. Đây là một so sánh kế hoạch rõ ràng; chọn các kế hoạch khác một cách độc lập trong máy tính HTML.

| Video / tháng | Yêu cầu dữ liệu | FlashData cách sử dụng được mô hình hóa | Supadata Mega + toàn bộ gói nạp tiền | Gói nạp tiền |
| --- | --- | --- | --- | --- |
| 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 |

### Truy cập miễn phí và tạo AI

Supadata Nạp tiền miễn phí 100 tín dụng hàng tháng. Bảng điểm gốc của nó sử dụng một tín chỉ; Thế hệ AI sử dụng hai tín chỉ mỗi phút. Do đó, bản ghi được tạo trong 30 phút sử dụng tín dụng 60. Chế độ tự động mặc định có thể kích hoạt việc tạo; mode=native tránh dự phòng đó. Việc tạo, dịch thuật và Tìm kiếm mở rộng được loại trừ khỏi so sánh này.

Những người đăng ký FlashData đã được xác minh đủ điều kiện có thể nhận được khoản trợ cấp ban đầu lên tới 4,000 tiêu chuẩn YouTube Yêu cầu dữ liệu. Đây không phải là cấp độ miễn phí hàng tháng.

<a id="migration"></a>
## Di chuyển trình đọc bản ghi gốc

| Thay đổi | Supadata | FlashData | phải làm gì |
| --- | --- | --- | --- |
| Yêu cầu | GET /v1/transcript với url, lang, văn bản và chế độ | POST /v1/queries/realtime với nguồn, video_id và thông số | Lấy ID YouTube gồm 11 ký tự. Khóa Supadata không dùng để xác thực với FlashData. |
| Xác thực | x-api-key: khóa Supadata của bạn | X-API-Key: khóa FlashData của bạn | Tạo hoặc sử dụng lại thông tin xác thực với quyền youtube_transcript. Tên tiêu đề không phân biệt chữ hoa chữ thường; thông tin xác thực thay đổi. |
| Gốc so với được tạo | mode=native truy xuất các chú thích hiện có; auto có thể quay trở lại AI; tạo luôn sử dụng AI | youtube_transcript đọc chú thích YouTube hiện có | Di chuyển truy xuất gốc trước tiên. Giữ một bước chuyển giọng nói thành văn bản riêng cho những video cần phiên âm mới. |
| Nguồn gốc phụ đề | chế độ chọn truy xuất so với tạo | params.auto=true chọn chú thích do YouTube tạo; false chọn phụ đề do người tải lên cung cấp | Các cài đặt tự động này không tương đương. FlashData tự động không bao giờ bắt đầu chuyển lời nói thành văn bản. |
| Ngôn ngữ | lang được ưa thích; ngôn ngữ không có sẵn có thể quay trở lại ngôn ngữ có sẵn đầu tiên | params.language là rõ ràng; auto=true thử biến thể -orig rồi mã được yêu cầu | Kiểm tra languageCode và requestedLanguageCode. FlashData không âm thầm chọn ngôn ngữ khác hoặc nguồn gốc chú thích. |
| Phân đoạn | nội dung []: văn bản, độ lệch và thời lượng tính bằng mili giây | kết quả[0].segments[]: văn bản, bắt đầu và kết thúc sau vài giây | offset = round(start × 1000); duration = round((end − start) × 1000). Giữ nguyên phần chồng lấn, không dịch chuyển các đoạn phụ đề. |
| Văn bản thuần túy | text=true trả về nội dung dưới dạng chuỗi | kết quả[0].fullText | Đọc fullText để tóm tắt và giữ lại các phân đoạn để trích dẫn dấu thời gian. |
| Khám phá ngôn ngữ | availableLangs trong phản hồi bảng điểm | transcriptLanguages trong youtube_metadata | Tìm nạp siêu dữ liệu khi ứng dụng của bạn cần danh sách ngôn ngữ đầy đủ. Không phát minh ra availableLangs từ một bản nhạc được trả về. |
| Hoàn thành | kết quả HTTP 200 hoặc HTTP 202 + jobId | Trạng thái thời gian thực=done; async trả lại bài nộp FlashData công việc IDs | Xử lý riêng từng trạng thái của nhà cung cấp. Hoàn thành Supadata công việc hiện có ở đó trước khi chuyển công việc mới. |

### 1. Thiết lập quyền truy cập

Tạo hoặc dùng lại khóa FlashData có quyền youtube_transcript trong [Khóa API](https://flashdata.dev/app/api-keys). Thêm youtube_metadata cho tác vụ siêu dữ liệu tùy chọn. Kiểm tra [Số dư tín dụng khả dụng](https://flashdata.dev/app/billing) hoặc dùng [quyền dùng thử dành cho tác nhân đủ điều kiện](#agents). Lưu khóa trong biến môi trường hoặc kho bí mật.

Supadata yêu cầu gốc được thay thế:

```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 thay thế JSON phần thân cho POST /v1/queries/realtime:

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

### 2. Lưu tập lệnh, sau đó chạy nó

Chọn Python hoặc Bash. Mỗi thư mục đầu ra mới gửi một yêu cầu; việc sử dụng lại thư mục sẽ đọc kết quả đã lưu mà không cần lệnh gọi API khác. Các phiên bản chia sẻ định dạng tệp đã lưu. Chọn một video có phụ đề được yêu cầu.

#### Python

Yêu cầu Python 3.10+. Cài đặt thư viện bằng python -m pip install requests. Trong thư mục làm việc mới, lưu toàn bộ tập lệnh bên dưới thành youtube-migrate.py trước khi chạy.

```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'))}")

```

Chạy từ thư mục làm việc đó:

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

Thao tác này sẽ chọn phụ đề tiếng Anh do YouTube tạo. Thêm --origin hướng dẫn sử dụng cho bản nhạc do người tải lên cung cấp hoặc --language MÃ để chọn ngôn ngữ.

Yêu cầu siêu dữ liệu riêng biệt tùy chọn:

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

#### Bash

Yêu cầu Bash, cURL 7.76+ và jq 1.6+. Lưu tập lệnh hoàn chỉnh này dưới dạng youtube-migrate.sh trong thư mục làm việc của bạn trước running nó:

```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"

```

Chạy từ thư mục làm việc đó:

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

Các đối số tùy chọn sau thư mục là ngôn ngữ và nguồn gốc; ví dụ: hướng dẫn sử dụng chọn phụ đề tiếng Anh do người tải lên cung cấp.

Yêu cầu siêu dữ liệu riêng biệt tùy chọn:

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

Để có quyền truy cập dùng thử tạm thời, hãy chạy các yêu cầu tuần tự cách nhau ít nhất một giây.

### 3. Đọc đầu ra

response.json bảo toàn kết quả thô và cách sử dụng. normalized.json chuyển đổi số giây của phân đoạn bản ghi thành offset/duration mili giây. Đây là bộ chuyển đổi phân đoạn, không phải là phản hồi hoàn chỉnh tương thích với Supadata: availableLangs không phải là giả mạo. Đầu ra siêu dữ liệu bảo toàn các giá trị null. Các yêu cầu không thành công hoặc bị gián đoạn sẽ giữ lại bằng chứng của chúng và dừng lại.

Minh họa normalized.json:

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

[Lược đồ bản chép lời](https://flashdata.dev/vi/docs/sources/youtube_transcript/reference.md)

<a id="workflows"></a>
## Siêu dữ liệu và quy trình làm việc hàng loạt

| dữ liệu | Supadata /v1/metadata | FlashData youtube_metadata |
| --- | --- | --- |
| Nhận dạng video | id | kết quả[0].videoId |
| Tiêu đề và mô tả | tiêu đề, mô tả | kết quả[0].tiêu đề, kết quả[0].mô tả |
| Kênh | author.displayName; additionalData.channelId | kết quả[0].channel; kết quả[0].channelId |
| Tương tác | stats.views, stats.likes, stats.comments | kết quả[0].viewCount, likeCount, commentCount |
| Thời lượng | media.duration (giây) | kết quả[0].duration (giây) |
| Hình thu nhỏ | media.thumbnailUrl | kết quả[0].hình thu nhỏ[]; chọn kích thước ứng dụng của bạn cần |
| Ngày xuất bản | createdAt | kết quả[0].uploadDate; bình thường hóa định dạng của nó trong ứng dụng của bạn |
| Khám phá phụ đề | Đọc availableLangs từ bản ghi phản hồi | kết quả[0].hasTranscripts và transcriptLanguages |

### Một số ngôn ngữ hiện có trong một yêu cầu

Gửi một mảng ngôn ngữ để nhận các bản nhạc và lỗi, ngay cả đối với một mảng chỉ chứa một ngôn ngữ. Kiểm tra lỗi ngay cả khi trạng thái là done. Đây là những bản nhạc hiện có, chưa được dịch hoặc tạo phụ đề.

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

### Làm phong phú thư viện nghiên cứu

Tìm nạp siêu dữ liệu một lần, lưu video ID và các ngôn ngữ phụ đề có sẵn, sau đó truy xuất bản nhạc bạn cần. Giữ số lượt tương tác có thể vô hiệu là null thay vì chuyển đổi chúng thành 0.

[YouTube Thực tiễn tốt nhất về dữ liệu](https://flashdata.dev/vi/docs/guides/youtube-data-guide/reference.md)

### Xử lý danh sách video IDs

Expand your input into explicit video IDs, then use Batch or a bulk file. FlashData does not accept a Supadata playlistId as a drop-in batch input. Lưu trạng thái và đầu ra của mỗi mục trước khi thử lại failed mục.

[Tài liệu tham chiếu xử lý Bulk](https://flashdata.dev/vi/docs/reference/bulk-processing/reference.md)

### Thực hiện nghiên cứu theo lịch trình

Duy trì thông tin xác thực của chủ sở hữu, điểm kiểm tra video completed và đọc đầu ra đã lưu khi khởi động lại. Dừng vì quyền truy cập bị thu hồi hoặc số dư không đủ; không tạo bản dùng thử khác để tiếp tục công việc đã lên lịch.

[Tác vụ định kỳ](https://flashdata.dev/vi/docs/guides/recurring-tasks/reference.md)

### Production quyết định di chuyển

- Giải quyết danh sách phát/channel đầu vào thành video rõ ràng IDs trước FlashData Xử lý tệp hàng loạt hoặc hàng loạt; Supadata playlistId không phải là đầu vào thả vào.
- Supadata tìm kiếm tốn một tín dụng cho mỗi trang kết quả 20 hoặc trần (giới hạn/20) có giới hạn. FlashData tiêu chuẩn YouTube Tìm kiếm hỗ trợ lên tới 20 kết quả; Tìm kiếm mở rộng có tỷ lệ riêng. Bộ lọc bản đồ và không chuyển mã thông báo trang.
- Supadata ghi lại cửa sổ kết quả công việc bảng điểm completed kéo dài một giờ. Loại bỏ các công việc hiện có ở đó và lưu trữ kết quả trước khi di chuyển công việc mới. Giữ riêng công việc dành riêng cho nhà cung cấp IDs.
- Giữ phương tiện đa nền tảng, trích xuất AI, dịch thuật và phiên âm âm thanh trên đường dẫn hiện có của chúng trừ khi quy trình làm việc tương đương đã được triển khai.

<a id="agents"></a>
## Dùng thử tác nhân, yêu cầu và sử dụng định kỳ

Các tác nhân đủ điều kiện có thể bắt đầu với 1 tín chỉ, tối đa 100 yêu cầu bảng điểm gốc trong 72 giờ. Siêu dữ liệu và bảng điểm chia sẻ phụ cấp này.

1. Sử dụng lại quyền truy cập hiện có trước; nếu không thì hãy bắt đầu một bản dùng thử đủ điều kiện chỉ với các quyền cần thiết.
2. Trả về một kết quả hữu ích, lưu kết quả thô và cách sử dụng, đồng thời giữ nguyên hồ sơ và thư mục trạng thái.
3. Chủ sở hữu đăng nhập hoặc đăng ký, xác minh email và phê duyệt yêu cầu, phạm vi và quyền truy cập số dư chung.
4. Dùng lại thông tin xác thực của chủ tài khoản cho tác vụ định kỳ. Tín dụng dùng thử chưa sử dụng không được chuyển sang tài khoản. Dừng khi quyền bị thu hồi hoặc số dư không đủ; không tạo đợt dùng thử khác để tiếp tục.

```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.
```

[Dùng thử và liên kết tài khoản](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md) · [CLI độc lập](https://flashdata.dev/vi/docs/guides/flashdata-cli/reference.md) · [Kết nối MCP](https://flashdata.dev/vi/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>
## Câu hỏi di chuyển

### FlashData có thể thay thế bản phiên âm AI của Supadata không?

Nguồn bản ghi và phụ đề của FlashData truy xuất phụ đề đã có trên YouTube. Họ không phiên âm âm thanh, dịch văn bản hoặc thực hiện phân tích hình ảnh. Di chuyển truy xuất gốc YouTube sang FlashData; giữ một dịch vụ riêng để trích xuất giọng nói thành văn bản, video đa nền tảng hoặc AI khi ứng dụng của bạn cần.

### Một yêu cầu mua gì?

Máy tính bao gồm một bản ghi hiện có bằng một ngôn ngữ hoặc một bản tra cứu siêu dữ liệu video. Việc tìm nạp cả hai sử dụng hai yêu cầu cho mỗi video. Supadata lập hoá đơn cho mỗi hoạt động này bằng một tín chỉ. FlashData sử dụng tốc độ dữ liệu YouTube của gói đã chọn. Tìm kiếm mở rộng, phiên âm AI, dịch thuật và phân phối phương tiện truyền thông nằm ngoài ước tính này.

### Có phải FlashData luôn rẻ hơn không?

So sánh khối lượng công việc thực tế của bạn và các kế hoạch đã chọn. Supadata bao gồm 100 tín dụng mỗi tháng miễn phí. Thời gian dùng thử tác nhân tạm thời của FlashData có ​​giới hạn và hết hạn; nó không phải là cấp độ miễn phí hàng tháng. Ở mức khối lượng thấp, trợ cấp miễn phí có thể bao gồm toàn bộ nhiệm vụ. Phí gói trả phí, gói nạp tiền và số dư chưa sử dụng sẽ ảnh hưởng đến số tiền bạn phải trả.

### Supadata đã hỗ trợ MCP và SDK chưa?

Vâng. Cả hai dịch vụ đều hỗ trợ tích hợp MCP và Python/JavaScript. FlashData cũng cung cấp bản Go SDK, độc lập CLI và bản dùng thử tác nhân tạm thời có thể được yêu cầu để truy cập định kỳ. Chọn giao diện mà máy chủ của bạn hỗ trợ; MCP không phải là lý do để chuyển đổi.

### Điều gì xảy ra nếu thiếu phụ đề?

Hãy coi nó như một khoảng trống dữ liệu. FlashData không chuyển đổi giữa phụ đề do người tải lên cung cấp và phụ đề do YouTube tạo hoặc tổng hợp bản ghi. Đối với mảng ngôn ngữ, hãy kiểm tra lỗi ngay cả khi yêu cầu là done. Supadata có thể tạo bản ghi ở chế độ tự động, trong khi chế độ gốc có thể trả về HTTP 206 đối với bản ghi không có sẵn; tài liệu của nó lập hoá đơn phản hồi ở một khoản tín dụng.

### Tôi có thể giữ nguyên hình dạng phản hồi của ứng dụng hiện có không?

Giữ bộ chuyển đổi của riêng bạn. Ví dụ này chuyển đổi các phân đoạn FlashData thành các mục nội dung có độ lệch và thời lượng tính bằng mili giây nhưng không yêu cầu phản hồi hoàn chỉnh tương thích với Supadata. Đọc siêu dữ liệu FlashData nếu bạn cần các ngôn ngữ có sẵn và di chuyển trạng thái công việc, xử lý lỗi và cách sử dụng một cách rõ ràng.

[Lấy khóa API](https://flashdata.dev/signup)
