# Supadata YouTube 데이터의 대안

YouTube 스크립트 및 메타데이터 비용, 기본 캡션 기능, 상담원 액세스를 비교해 보세요. 실행 가능한 Python 및 Bash 예제를 사용하여 Supadata에서 마이그레이션하세요.

Supadata 사실을 검토했습니다 2026-11-10. FlashData 가격 및 시험 수당은 현재 공개 카탈로그를 사용합니다.

- [특징](#features)
- [비용 비교](#costs)
- [자막 텍스트 마이그레이션](#migration)
- [메타데이터 및 대량](#workflows)
- [AI 에이전트의 경우](#agents)
- [FAQ](#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 언어 — 트랙 및 언어별 오류 | 선호하는 언어 1개 — 자막 텍스트 엔드포인트의 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 에이전트 호스트에 대한 액세스 | 예 — OAuth 또는 API 키를 사용한 원격 MCP | 예 — 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 생성 및 번역은 제외됩니다. 요청이 0이면 선택한 플랜 수수료가 유지되며 유효 요율은 정의되지 않습니다.

### 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 데이터 가격](https://flashdata.dev/ko/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 크레딧. 기본 자막 텍스트는 1학점을 사용합니다. AI 생성은 분당 2크레딧을 사용합니다. 따라서 30분 생성된 자막 텍스트는 60 크레딧을 사용합니다. 기본 자동 모드는 생성을 트리거할 수 있습니다. mode=native는 해당 폴백을 방지합니다. 생성, 번역 및 확장 검색은 이 비교에서 제외됩니다.

적격한 검증된 FlashData 가입은 최대 4,000 표준 YouTube 데이터 요청에 대한 초기 허용량을 받을 수 있습니다. 월별 무료 등급이 아닙니다.

<a id="migration"></a>
## 기본 자막 텍스트 판독기 마이그레이션

| 변경 | Supadata | FlashData | 해야 할 일 |
| --- | --- | --- | --- |
| 요청 | GET /v1/transcript URL, 언어, 텍스트 및 모드 포함 | 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 자동은 음성-텍스트 변환을 시작하지 않습니다. |
| 언어 | 언어가 선호됩니다. 사용할 수 없는 언어는 사용 가능한 첫 번째 언어로 대체될 수 있습니다. | params.language은 명시적입니다. auto=true -orig 변형을 시도한 다음 요청된 코드를 시도합니다. | languageCode 및 requestedLanguageCode를 확인하세요. FlashData는 다른 언어나 캡션 출처를 자동으로 선택하지 않습니다. |
| 세그먼트 | content[]: 텍스트, 오프셋 및 기간(밀리초) | 결과[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. 액세스 설정

[API 열쇠](https://flashdata.dev/app/api-keys)에서 youtube_transcript 권한이 있는 FlashData 키를 생성하거나 재사용합니다. 선택적 메타데이터 작업을 위해 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+가 필요합니다. 이 전체 스크립트를 작업 폴더의 running 이전에 youtube-migrate.sh로 저장하세요.

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

임시 평가판 액세스의 경우 최소 1초 간격으로 순차적으로 요청을 실행하세요.

### 3. 출력 읽기

response.json 원시 결과와 사용법을 보존합니다. normalized.json 기록 세그먼트 초를 오프셋/duration 밀리초로 변환합니다. 이는 완전한 Supadata 호환 응답이 아닌 세그먼트 어댑터입니다. availableLangs는 제작되지 않았습니다. 메타데이터 출력은 null 허용 값을 유지합니다. 실패하거나 중단된 요청은 증거를 유지하고 중지됩니다.

예시 normalized.json:

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

[자막 텍스트 스키마](https://flashdata.dev/ko/docs/sources/youtube_transcript/reference.md)

<a id="workflows"></a>
## 메타데이터 및 대량 워크플로

| 데이터 | Supadata /v1/metadata | FlashData youtube_metadata |
| --- | --- | --- |
| 비디오 아이덴티티 | id | 결과[0].videoId |
| 제목 및 설명 | 제목, 설명 | 결과[0].제목, 결과[0].설명 |
| 채널 | author.displayName; additionalData.channelId | 결과[0].channel; 결과[0].channelId |
| 참여 | stats.views, stats.likes, stats.comments | 결과[0].viewCount, likeCount, commentCount |
| 기간 | media.duration (초) | 결과[0].기간(초) |
| 썸네일 | media.thumbnailUrl | 결과[0].thumbnails[]; 앱에 필요한 크기를 선택하세요 |
| 출판일 | createdAt | 결과[0].uploadDate; 앱에서 형식을 정규화하세요. |
| 캡션 검색 | 스크립트 응답에서 availableLangs 읽기 | 결과[0].hasTranscripts 및 transcriptLanguages |

### 한 번의 요청으로 여러 기존 언어

하나의 언어가 포함된 배열의 경우에도 트랙과 오류를 수신하려면 언어 배열을 보냅니다. 상태가 done인 경우에도 오류를 검사합니다. 이는 번역되거나 생성된 캡션이 아닌 기존 트랙입니다.

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

### 연구 도서관을 풍부하게 하라

메타데이터를 한 번 가져오고 동영상 ID 및 사용 가능한 캡션 언어를 저장한 다음 필요한 트랙을 검색하세요. Null 허용 참여 수를 0으로 변환하는 대신 null로 유지하세요.

[YouTube 데이터 모범 사례](https://flashdata.dev/ko/docs/guides/youtube-data-guide/reference.md)

### 동영상 목록 처리 IDs

입력 내용을 노골적인 동영상 IDs으로 확장한 다음 배치 또는 대량 파일을 사용하세요. FlashData는 Supadata playlistId를 드롭인 batch 입력으로 허용하지 않습니다. failed 항목을 재시도하기 전에 항목별 상태 및 출력을 저장하세요.

[대량 처리 참조](https://flashdata.dev/ko/docs/reference/bulk-processing/reference.md)

### 일정에 따라 조사 실행

소유자 자격 증명, 체크포인트 completed 비디오를 유지하고 다시 시작할 때 저장된 출력을 읽습니다. 액세스가 취소되었거나 잔액이 부족하여 중지합니다. 예약된 작업을 계속하기 위해 다른 시도를 만들지 마십시오.

[반복되는 상담원 작업](https://flashdata.dev/ko/docs/guides/recurring-tasks/reference.md)

### Production 이전 결정

- FlashData 이전에 재생목록/channel 입력을 노골적인 동영상 IDs로 해결합니다. 일괄 또는 대량 파일 처리; Supadata playlistId는 드롭인 입력이 아닙니다.
- Supadata 검색 비용은 20-결과 페이지당 1크레딧 또는 한도가 있는 ceil(한도/20)입니다. FlashData 표준 YouTube 검색은 최대 20 결과를 지원합니다. 확장 검색에는 별도의 요율이 있습니다. 지도 필터를 사용하고 페이지 토큰을 전송하지 않습니다.
- Supadata는 1시간 동안의 completed 기록 작업 결과 창을 기록합니다. 새 작업을 마이그레이션하기 전에 기존 작업을 비우고 결과를 저장하세요. 제공업체별 작업 IDs을 별도로 유지하세요.
- 동등한 워크플로우가 구현되지 않은 한 크로스 플랫폼 미디어, AI 추출, 번역 및 오디오 전사를 기존 경로에 유지합니다.

<a id="agents"></a>
## 대리인 평가판, 청구 및 반복 사용

적격 대리인은 1 크레딧으로 시작하여 72시간 동안 최대 100 원어민 자막 텍스트를 요청할 수 있습니다. 메타데이터와 기록은 이 허용치를 공유합니다.

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/ko/docs/guides/agent-onboarding/reference.md) · [독립형 CLI](https://flashdata.dev/ko/docs/guides/flashdata-cli/reference.md) · [MCP 연결](https://flashdata.dev/ko/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>
## 마이그레이션 질문

### FlashData가 Supadata의 AI 전사를 대체할 수 있나요?

FlashData의 스크립트 및 캡션 소스는 YouTube에 이미 있는 캡션을 검색합니다. 오디오를 복사하거나 텍스트를 번역하거나 시각적 분석을 수행하지 않습니다. 기본 YouTube 검색을 FlashData로 이동합니다. 애플리케이션에 필요할 때 음성-텍스트 변환, 크로스 플랫폼 비디오 또는 AI 추출을 위한 별도의 서비스를 유지하세요.

### 한 번의 요청으로 무엇을 구매하나요?

계산기는 하나의 언어로 된 하나의 기존 자막 텍스트 또는 하나의 비디오 메타데이터 조회를 다룹니다. 둘 다 가져오는 데에는 동영상당 두 개의 요청이 사용됩니다. Supadata는 이러한 각 작업에 대해 1크레딧으로 요금을 청구합니다. FlashData는 선택한 요금제의 YouTube 데이터 속도를 사용합니다. 확장 검색, AI 전사, 번역 및 미디어 전달은 이 추정치에 포함되지 않습니다.

### FlashData는 항상 더 저렴합니까?

실제 워크로드와 선택한 계획을 비교하세요. Supadata에는 매달 100 크레딧이 무료로 제공됩니다. FlashData의 임시 에이전트 평가판은 제한되어 있으며 만료됩니다. 월별 무료 등급이 아닙니다. 볼륨이 낮을 경우 무료 할당량으로 전체 작업을 처리할 수 있습니다. 지불된 요금제 수수료, 재충전 팩 및 미사용 잔액은 귀하가 지불하는 금액에 영향을 미칩니다.

### Supadata는 이미 MCP 및 SDK를 지원합니까?

그렇습니다. 두 서비스 모두 MCP 및 Python/JavaScript 통합을 지원합니다. FlashData은 또한 Go SDK, 독립 실행형 CLI 및 반복 액세스를 요청할 수 있는 임시 에이전트 평가판을 제공합니다. 호스트가 지원하는 인터페이스를 선택하십시오. MCP만으로는 전환 이유가 되지 않습니다.

### 캡션 트랙이 없으면 어떻게 되나요?

데이터 공백으로 처리하십시오. FlashData는 업로더가 제공한 캡션과 YouTube이 생성한 캡션 간에 전환하거나 스크립트를 합성하지 않습니다. 언어 배열의 경우 요청이 done인 경우에도 오류를 검사합니다. Supadata는 자동 모드에서 스크립트를 생성할 수 있고, 기본 모드에서는 사용할 수 없는 스크립트에 대해 HTTP 206를 반환할 수 있습니다. 1 크레딧으로 응답하는 문서 청구서입니다.

### 기존 애플리케이션 응답 형태를 유지할 수 있나요?

자신만의 어댑터를 보관하세요. 이 예에서는 FlashData 세그먼트를 오프셋과 지속 시간(밀리초)을 사용하여 콘텐츠 항목으로 변환하지만 완전한 Supadata 호환 응답을 요구하지는 않습니다. 사용 가능한 언어가 필요한 경우 FlashData 메타데이터를 읽고 작업 상태, 오류 및 사용 처리를 명시적으로 마이그레이션하세요.

[API 키 받기](https://flashdata.dev/signup)
