# Apify YouTube 데이터의 대안

FlashData를 Apify YouTube 행위자와 비교하세요. 행위자별 가격, 월별 사용 예산, 메타데이터 및 캡션 워크플로, 실행 가능한 Python 및 Bash 마이그레이션 예를 확인하세요.

배우부터 직접 영상 조회까지 달려갑니다. 알려진 IDs로 시작하여 애플리케이션 필드를 보존하고 나머지 파이프라인을 변경하기 전에 하나의 생산자를 이동하세요.

Apify 실제로 검토 2026-11-10. FlashData 요금 및 체험 수당은 현재 공개 카탈로그를 사용합니다.

- [특징](#features)
- [배우 가격](#actors)
- [비용 비교](#costs)
- [조회 마이그레이션](#migration)
- [데이터 세트 및 일정](#production)
- [AI 에이전트의 경우](#agents)
- [FAQ](#faq)

<a id="features"></a>
## 기능별 비교

### 타겟 조회를 경제적으로 유지

| 특징 | FlashData | Apify YouTube 배우 |
| --- | --- | --- |
| 월간 구독 없이 유료 사용량 | 예 — 종량제 크레딧 $10 충전 | 무료 예산과 유료 요금제 — $5/월 무료; Starter $19/월 $19 사용 |
| 1,000 알려진 동영상 IDs의 메타데이터 | $0.50 — 종량제 사용률 | $3.00 — streamers/youtube-scraper · Starter 요금, 플랜의 예산에서 공제 |
| 단일 비디오 조회 | 예 — 명시적 1개 video_id | 배우 의존적 — Streamers는 이를 지원합니다. API 도장은 현재 단일 영상을 제외합니다 URLs |

### 앱에 필요한 비디오를 찾고 강화하세요.

| 특징 | FlashData | Apify YouTube 배우 |
| --- | --- | --- |
| 검색 필터를 사용한 키워드 발견 | 예 — 날짜, 기간, 유형 및 정렬 필터 | 예 — searchQueries 및 정렬, 날짜 및 동영상 필터 |
| 제목, 채널 및 참여 데이터 | 예 — 동영상별 전용 메타데이터 조회 ID | 예 — 배우 데이터세트의 비디오 기록 |
| 캡션과 별도로 메타데이터 새로 고침 | 예 — 새로고침은 youtube_metadata만 요청하세요. | 예 — transcriptionAndSubtitle=NONE으로 실행 |

### 신청서에 대한 캡션 증거 준비

| 특징 | FlashData | Apify YouTube 배우 |
| --- | --- | --- |
| 여러 기존 캡션 언어 선택 | 최대 10 노골적인 언어 — 하나의 자막 텍스트 요청으로 언어별 오류를 추적합니다. | 주연: 하나의 언어 또는 임의 — 다양한 행위자는 다양한 입력을 노출할 수 있습니다. |
| 엄격한 캡션 출처를 선택하세요. | 업로더 또는 YouTube 생성 — params.auto 하나의 출발지를 선택합니다. 교차 출처 대체 없음 | 주연 : 원산지 선호 — preferAutoGeneratedSubtitles은 동일한 계약이 아닌 선호 사항입니다. |
| 출처 인용에 대한 타임스탬프가 있는 텍스트 | 정규화된 JSON 세그먼트 — start/end 시간(초)이 포함된 텍스트 | SRT, VTT 또는 XML 자막 — 인용 시점에 대해 선택한 자막 형식을 구문 분석합니다. |
| 요약을 위한 일반 텍스트 | fullText 세그먼트와 함께 | 일반 텍스트 자막 형식 — 또는 시간 제한 자막 출력을 구문 분석하고 결합합니다. |
| 기존 스크립트가 없는 동영상 | 누락된 트랙 신고 — 음성-텍스트 생성 없음 | 선택적 AI 전사 — 대체 또는 항상 기록 모드; 별도의 이용요금 |

### 더 적은 통합 코드로 워크플로 실행

| 특징 | FlashData | Apify YouTube 배우 |
| --- | --- | --- |
| Actor 리소스를 관리하지 않고 직접적인 결과 | 실시간 결과[] + 사용량 — 액터 ID, 빌드 또는 메모리 설정 없음 | 행위자 실행 + 입력 스키마 — 동기화 엔드포인트는 한 번의 HTTP 호출로 결과를 반환할 수도 있습니다. |
| 브라우저 콘솔에서 저장된 목록 처리 | Bulk Jobs 동영상-ID 파일 포함 — 진행 상황을 추적하고 매니페스트 및 결과 부분을 검색합니다. | URL 입력이 있는 액터 콘솔 — CSV 또는 Google 시트 가져오기 지원 |
| 클라이언트 연결이 끊긴 후의 백그라운드 결과 | 저장됨 async 또는 대량 작업 ID — 상태 확인 재개 및 completed 출력 검색 | 저장된 액터 실행 및 데이터세트 IDs — 실행을 검사하고 해당 데이터세트 항목을 검색합니다. |
| 애플리케이션 및 에이전트 출력 형식 | JSON, 일반 텍스트 또는 Markdown | 데이터 세트 내보내기 — JSON, CSV, Excel 및 기타 형식 |
| 반복수집 | 스케줄러 또는 에이전트 호스트 — 소유자 자격 증명 및 저장된 작업 상태 재사용 | 호스팅 배우 일정 — Cron, 시간대 설정 및 선택적 웹훅 |
| 메타데이터, 캡션 및 Google 하나의 API 계약으로 검색 | 단일 쿼리 API, 소스별 권한 — 공유 계정 잔액 소스별 가격 | 공유 플랫폼; 행위자별 스키마 — 관련 액터 입력 및 출력 선택 및 유지 |
| 자동화를 위한 CLI, SDK 및 MCP | 예 — 독립형 CLI; Python, TypeScript 및 Go SDK; MCP | 예 — Apify CLI, Python/JavaScript 클라이언트 및 MCP |

배우별 행은 다른 배우의 이름이 지정되지 않는 한 스트리머/youtube-scraper를 참조합니다. 두 서비스 모두 SDK CLI 및 MCP를 제공합니다. Apify 또한 사용자 정의 코드, 호스팅 일정 및 기타 웹사이트의 스크레이퍼를 실행합니다.

### 단일 동영상 조회를 작게 유지

비디오 ID를 전달하고 메타데이터를 직접 수신하세요. 작업에 플랫폼 구독이나 채널 크롤링이 필요하지 않은 경우 종량제 액세스를 사용하세요.

### 애플리케이션의 데이터 모델 유지

앱이 실제로 읽는 필드를 매핑하세요. null 개수를 유지하고 게시 날짜를 명시적으로 유지하며 이전에 데이터 세트 항목을 읽은 소비자를 위해 JSON 배열을 저장합니다.

### 검색을 강화와 별도로 유지

유용한 검색 워크플로를 계속하고, 해당 비디오 IDs를 중복 제거한 다음, FlashData를 사용하여 제품에 필요한 비디오만 강화하세요.

<a id="actors"></a>
## 단일 Apify YouTube 가격이 없습니다

행위자 작성자는 입력, 출력 및 가격 책정 모델을 선택합니다. 이 세 액터는 결과별 이벤트를 사용하지만 기능이 다릅니다. 아래 가격은 반환된 동영상 1,000당 USD입니다.

| 배우 | 무료 / 1,000 동영상 | Starter | Scale | Business | 그것을 선택하십시오 |
| --- | --- | --- | --- | --- | --- |
| streamers/youtube-scraper | $4.00 | $3.00 | $2.60 | $2.40 | 비디오 URLs, 검색 및 선택적인 기존 자막. 계산기의 배우입니다. |
| streamers/youtube-channel-scraper | $1.30 | $1.00 | $0.80 | $0.50 | 기본 영상 데이터를 활용한 채널 검색. 임의의 ID에 대한 전체 메타데이터 조회가 아닙니다. |
| apidojo/youtube-scraper | $0.50 | $0.50 | $0.50 | $0.50 | 검색 입력. 현재 README에서는 단일 동영상 URLs을 제외하고 입력당 최소 10 동영상이 필요합니다. 무료 데모: 5 실행/월, 최대 10 항목/run. |

셀프 서비스 월간 요금제: Starter는 Bronze, Scale는 Silver, Business는 Gold에 매핑됩니다. 더 저렴한 발견 행위자는 알려진 비디오 계산기로 대체되지 않습니다.

### 청구 가능한 이벤트를 확인하세요.

Apify는 이벤트당 지불, 사용량당 지불 및 결합 모델을 지원합니다. 스트리머/youtube-scraper의 경우 결과 이벤트 및 선택한 추가 기능을 계산합니다. 일반 컴퓨팅 수수료를 자동으로 추가하지 마세요. 자신의 Actor 실행의 이벤트 분석을 검사합니다.

### AI 전사에서 기존 자막 분리

주요 배우의 결과에는 기존 자막이 포함될 수 있습니다. AI 전사는 동영상당 시작된 분당 요금이 청구됩니다. Starter에서 10분 동영상은 $0.003 결과 이벤트 앞에 $0.41를 추가합니다. AI 요약, 설명, 채널 날짜 필터링에도 자체 이벤트 가격이 있습니다. FlashData 기존 트랙을 검색합니다. 누락된 캡션을 생성하지 않습니다.

### 검색을 강화와 별도로 유지

앱에 이미 알려진 비디오가 있으면 알려진 비디오 IDs를 사용하세요. 검색 크롤링을 통해 사용하지 않은 비디오를 검색할 수 있습니다. 예산 검색 및 후속 강화는 별도로 이루어집니다.

<a id="costs"></a>
## 단가와 월 수수료 비교

USD, 월간 목록 계획. 이 모델은 스트리머/youtube-scraper의 결과 이벤트, 입력당 하나의 반환된 비디오 ID를 사용하며 날짜 필터링 및 AI 추가 기능은 꺼집니다. 기존 자막은 ALWAYS_SUBTITLES 설정을 사용합니다. 메타데이터와 캡션은 하나의 Actor 결과이지만 두 개의 FlashData 요청입니다. FlashData 가격은 현재 YouTube 데이터 카탈로그를 기준으로 합니다. 추가 사용량이 추가되기 전에 각 계획에 포함된 전체 잔액이 이 워크플로에 할당됩니다. Apify $5 예산 내에서 무료로 정차합니다. 유료 플랜에는 포함된 예산보다 사용량이 추가됩니다. FlashData 잔고가 0인 구매에는 추가 크레딧이 필요할 때 $10 최소 충전이 포함됩니다. 세금, 연간 할인, 기타 행위자, 별도 저장/export 요금 및 failed 시도는 제외됩니다. 동영상이 전혀 없는 경우 선택한 유료 요금제에는 여전히 월별 요금이 있습니다. 동영상당 유효 비용은 정의되어 있지 않습니다.

### Apify 플랫폼 계획

| Apify 계획 | 월 요금 | 포함된 사용량/월 | 주연 / 1,000 동영상 | 이 예산 내 동영상 |
| --- | --- | --- | --- | --- |
| 무료 | $0.00 | $5.00 | $4.00 | 1,250 |
| Starter | $19.00 | $19.00 | $3.00 | 6,333 |
| Scale | $199.00 | $199.00 | $2.60 | 76,538 |
| Business | $999.00 | $999.00 | $2.40 | 416,250 |

이러한 수는 추가 기능이나 기타 플랫폼 사용 없이 결과 이벤트에 전체 예산을 할당합니다. 다른 배우에 대해 Apify를 유지하면 구독이 유지됩니다. 남은 예산과 증분 사용량을 비교하세요.

### 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).

### 실제 사례

FlashData 종량제 대 Apify Starter 및 스트리머/youtube-scraper. 메타데이터와 기존 자막은 하나의 배우 결과 이벤트이지만 2개의 FlashData 요청입니다. 이는 동일한 응답 필드에 대한 주장이 아니라 사용량 및 월별 비용 추정치입니다.

| 비디오 | 작업 흐름 | FlashData 요청 | FlashData 모델링된 사용법 | 액터 이벤트 사용법 | Apify 수수료 포함 월 비용 |
| --- | --- | --- | --- | --- | --- |
| 1,000 | 알려진 동영상의 메타데이터 IDs | 1,000 | $0.50 | $3.00 | $19.00 |
| 1,000 | 메타데이터 + 기존 캡션 | 2,000 | $1.00 | $3.00 | $19.00 |
| 10,000 | 알려진 동영상의 메타데이터 IDs | 10,000 | $5.00 | $30.00 | $30.00 |
| 10,000 | 메타데이터 + 기존 캡션 | 20,000 | $10.00 | $30.00 | $30.00 |
| 100,000 | 알려진 동영상의 메타데이터 IDs | 100,000 | $50.00 | $300.00 | $300.00 |
| 100,000 | 메타데이터 + 기존 캡션 | 200,000 | $100.00 | $300.00 | $300.00 |

FlashData 제로 잔액에서 구매 시 최소 충전 금액은 $10입니다. Apify의 수수료에는 이미 포함된 사용량이 포함되어 있습니다. 해당 사용법을 두 번 추가하지 마십시오. HTML 계산기를 사용하면 두 계획을 독립적으로 선택할 수 있습니다.

### 무료 이용

Apify 무료에는 $5 월별 공유 예산이 있습니다. 개별 배우 데모 제한도 적용될 수 있습니다. 위에 표시된 API Dojo Actor는 한 달에 5번의 데모 실행과 실행당 10개의 항목으로 무료로 제한됩니다.

FlashData signups는 4,000 표준 YouTube 자료 요구에 최대의 초기 허용을 받을 수 있습니다. 매월 재설정하지 않습니다.

<a id="migration"></a>
## 데이터세트 리더를 유지하세요. 하나의 조회 교체

알려진 공개 동영상 ID로 시작하세요. 이 예에서는 선택된 친숙한 Actor 필드를 JSON 배열로 작성하고 전체 FlashData 응답을 별도로 저장합니다.

### 1. 액세스 설정 및 요청 매핑

[API 열쇠](https://flashdata.dev/app/api-keys)에서 youtube_metadata 권한이 있는 키를 생성하거나 재사용하고 [사용 가능한 크레딧](https://flashdata.dev/app/billing)를 확인하세요. 상담원은 먼저 액세스 권한을 재사용하거나 적격 평가판을 사용해야 합니다. 채팅 외부에 키를 보관하세요.

마이그레이션 참조를 위한 기존 Actor 호출:

```bash
# The existing Actor call, shown for migration reference.
curl --fail-with-body --silent --show-error --max-time 310 \
  --request POST \
  'https://api.apify.com/v2/acts/streamers~youtube-scraper/run-sync-get-dataset-items' \
  --header "Authorization: Bearer $APIFY_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"startUrls":[{"url":"https://www.youtube.com/watch?v=FUfGcZ092b0"}],
    "maxResults":1,"maxResultsShorts":0,"maxResultStreams":0,
    "transcriptionAndSubtitle":"NONE","aiVideoDescription":false,"aiVideoSummary":false}'
```

FlashData JSON 본체 POST /v1/queries/realtime:

```json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": true
  }
}
```

Actor 동기화 엔드포인트는 이미 하나의 HTTP 응답으로 항목을 반환할 수 있습니다. 요청, 봉투 및 필드를 마이그레이션합니다. 불필요한 폴링을 추가하지 마십시오.

### 2. 스크립트를 저장한 후 실행하세요.

Python 또는 Bash를 선택하세요. 각각의 새 출력 폴더는 하나의 요청을 제출합니다. 폴더를 재사용하면 저장된 출력을 읽습니다. 중단되거나 failed 검사를 위해 정지를 시도합니다. 두 버전 모두 동일한 파일을 사용합니다.

#### Python

Python 3.10+가 필요합니다. python -m pip install requests로 의존성을 설치하세요. 새 작업 폴더에서 아래 전체 스크립트를 video-lookup.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("video_id")
parser.add_argument("folder", type=Path)
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")
body = {"source": "youtube_metadata", "video_id": args.video_id,
        "params": {"include_formats": False, "include_chapters": True}}
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 = 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 != 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") != body["source"]:
    raise SystemExit("Request did not complete successfully; inspect response.json")
items = data.get("results")
if not isinstance(items, list) or len(items) != 1 or not isinstance(items[0], dict):
    raise SystemExit("Expected one metadata result")
item = items[0]
if item.get("videoId") != args.video_id:
    raise SystemExit("Returned video does not match the request")
seconds = item.get("duration")
duration = None
if seconds is not None:
    if type(seconds) not in (int, float) or not math.isfinite(seconds) or seconds < 0:
        raise SystemExit("Invalid duration")
    whole = int(seconds)
    duration = f"{whole // 3600:02d}:{whole % 3600 // 60:02d}:{whole % 60:02d}"
mapped = [{
    "id": item["videoId"],
    "url": "https://www.youtube.com/watch?v=" + item["videoId"],
    "title": item.get("title"), "text": item.get("description"),
    "channelName": item.get("channel"), "channelId": item.get("channelId"),
    "viewCount": item.get("viewCount"), "likes": item.get("likeCount"),
    "commentsCount": item.get("commentCount"), "duration": duration,
    "uploadDateRaw": item.get("uploadDate"),
    "captionLanguages": item.get("transcriptLanguages"),
}]
(out / "dataset-items.json").write_text(
    json.dumps(mapped, ensure_ascii=False, indent=2) + "\n", encoding="utf-8"
)
print(f"Saved {out}/dataset-items.json; actual usage: {json.dumps(data.get('usage'))}")

```

해당 폴더에서 실행하여 ID를 데이터세트의 공개 동영상으로 바꿉니다.

```bash
python video-lookup.py FUfGcZ092b0 video-001
```

#### Bash

Bash, cURL 7.76+ 및 jq 1.6+가 필요합니다. 아래의 전체 스크립트를 작업 폴더에 video-lookup.sh로 저장하세요.

```bash
#!/usr/bin/env bash
set -euo pipefail
video_id="${1:?Use: VIDEO_ID OUTPUT_FOLDER}"
out="${2:?Set OUTPUT_FOLDER}"
[[ "$video_id" =~ ^[A-Za-z0-9_-]{11}$ ]] || { echo 'Invalid video ID' >&2; exit 1; }
body=$(jq -n --arg id "$video_id" '{source: "youtube_metadata", video_id: $id,
  params: {include_formats: false, include_chapters: true}}')
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 this 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 status, response and Retry-After header.\n' >&2; exit 1;
}
mapped=$(jq -e --arg id "$video_id" '
  def pad: tostring | if length < 2 then "0" + . else . end;
  def hms:
    if . == null then null
    elif type != "number" then error("Invalid duration")
    elif (isfinite | not) or . < 0 then error("Invalid duration")
    else floor | [(./3600 | floor | pad), ((.%3600)/60 | floor | pad), (.%60 | pad)] | join(":") end;
  if .source != "youtube_metadata" 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 != $id then error("Wrong video") else . end
  | [{id: .videoId, url: ("https://www.youtube.com/watch?v=" + .videoId),
      title, text: .description, channelName: .channel, channelId,
      viewCount, likes: .likeCount, commentsCount: .commentCount,
      duration: (.duration | hms), uploadDateRaw: .uploadDate,
      captionLanguages: .transcriptLanguages}]' "$out/response.json")
printf '%s\n' "$mapped" > "$out/dataset-items.json"
printf 'Saved %s/dataset-items.json; actual usage: ' "$out"
jq -c '.usage' "$out/response.json"

```

해당 폴더에서 실행하십시오.

```bash
bash video-lookup.sh FUfGcZ092b0 video-001
```

### 3. 저장된 출력 읽기

비디오-001/dataset-items.json는 애플리케이션 리더를위한 배열입니다. response.json은 원래 결과 및 사용을 유지합니다. 이것은 Apify Dataset API가 아닌 필드 어댑터입니다. 그것은 dataset ID를 만들지 않습니다, 알 수없는 메트릭스 또는 직물 주석 또는 monetization 필드.

예시 dataset-items.json:

```json
[
  {
    "id": "FUfGcZ092b0",
    "url": "https://www.youtube.com/watch?v=FUfGcZ092b0",
    "title": "Example video",
    "text": "Example description",
    "channelName": "Example channel",
    "channelId": "UC_EXAMPLE",
    "viewCount": 1200,
    "likes": null,
    "commentsCount": null,
    "duration": "00:03:17",
    "uploadDateRaw": "2025-01-15",
    "captionLanguages": [
      "en",
      "es"
    ]
  }
]
```

| 기존 배우 필드 | FlashData 메타데이터 | 마이그레이션 작업 |
| --- | --- | --- |
| 아이디 / URL | videoId | ID를 유지하고 정식 YouTube 시계 URL를 구성하세요. |
| 제목 / 텍스트 | 제목/설명 | 독자가 배우의 필드 이름을 기대하는 경우 설명을 텍스트에 매핑하세요. |
| channelName / channelId | 채널 / channelId | 이름과 ID을 유지하세요. 표시 이름에서 채널 핸들을 유추하지 마십시오. |
| 좋아요 / commentsCount / viewCount | likeCount / commentCount / viewCount | 누락된 값을 null로 유지하세요. 누락된 측정항목은 0이 아닙니다. |
| 기간(종종 HH:MM:SS) | 지속 시간(초) | 이 예에서는 초를 HH:MM:SS 문자열로 변환하고 null을 유지합니다. |
| 날짜(절대적이거나 상대적일 수 있음) | uploadDate | 이 예에서는 uploadDateRaw을 유지합니다. 정규화된 날짜를 채우기 전에 자신만의 날짜 파서를 추가하세요. |
| 자막[] / transcriptionUrl | 별도의 youtube_transcript 또는 youtube_captions 요청 | 기존 트랙과 생성된 음성-텍스트 변환은 앱에 대한 서로 다른 입력입니다. |
| 행위자 전용 강화 필드 | 자동으로 상응하는 항목 없음 | 댓글, 채널 확장, AI 생성 분석을 위한 별도의 강화 단계를 유지하세요. |

[메타데이터 스키마](https://flashdata.dev/ko/docs/sources/youtube_metadata/reference.md).

### 자막 의도 전달

| 주연 배우 입력 | FlashData 이주 |
| --- | --- |
| ALWAYS_SUBTITLES | 기존 트랙에 대해 별도의 youtube_transcript 또는 youtube_captions 요청을 추가하세요. |
| subtitlesLanguage | params.language를 사용하세요. 최대 10 언어 배열은 트랙과 언어별 오류를 반환합니다. |
| preferAutoGeneratedSubtitles | 이것은 환경 설정입니다. FlashData params.auto는 원본 간 대체 없이 YouTube 생성 또는 업로더 제공 캡션을 엄격하게 선택합니다. |
| TRANSCRIPTION_AS_FALLBACK / ALWAYS_TRANSCRIBE | 음성-텍스트를 별도로 유지하십시오. FlashData는 누락된 트랙을 생성하지 않습니다. |
| 자막[].srt / transcriptionUrl | 타임스탬프가 있는 세그먼트를 매핑하거나 파일 형식을 명시적으로 지정합니다. 생성된 일반 텍스트 URL는 타임스탬프가 적용된 세그먼트 배열이 아닙니다. |

[타임스탬프 캡션 레시피](https://flashdata.dev/ko/docs/guides/timestamped-captions-recipe/reference.md).

<a id="production"></a>
## 데이터세트, 긴 running 작업 및 일정

도구가 Apify 데이터세트 IDs 및 일정에 의존하는 경우 맞춤 액터를 오케스트레이터로 유지하세요. 그 안에서 FlashData를 호출하고 매핑된 항목을 해당 데이터세트에 쓰세요. FlashData 사용량과 함께 배우의 런타임 및 저장 공간에 대한 예산을 책정하세요. 위 모델의 계산기는 FlashData 호출을 직접 수행합니다.

| 우려 | Apify | FlashData |
| --- | --- | --- |
| 요청 | 배우 ID + 빌드/input 옵션; 선택적 저장된 작업 | 소스 + video_id + 매개변수; 액터 빌드 또는 메모리 옵션 없음 |
| 동기 결과 | run-sync-get-dataset-items는 항목 배열을 반환합니다. 문서화된 HTTP 제한은 300초입니다. | 실시간 응답에는 상태, 결과[] 및 사용량이 있습니다. 필드를 매핑하기 전에 결과 추출 |
| 긴-running 작업 | 실행 시작, 실행 저장 ID, 터미널 상태 대기, 읽기 defaultDatasetId | async 또는 batch 작업을 제출하고 ID를 저장하고 상태를 폴링하고 결과를 검색합니다. |
| 출력 저장 | URL에서 참조하는 데이터세트 항목과 선택적 키-값 레코드 | 응답을 저장하거나 내구성 있는 저장소로 내보냅니다. Apify 데이터세트 ID는 FlashData 직업 ID이 아닙니다. |
| 반복되는 작업 | Apify 일정 시작 배우/Tasks; 웹후크는 다운스트림 소비자에게 알립니다. | 애플리케이션, cron, CI 또는 에이전트 호스트를 사용하여 FlashData로 전화하세요. 일정과 소비자를 함께 마이그레이션 |

### 기존 데이터 세트 이동

생산자를 전환하기 전에 기존 데이터세트의 모든 페이지를 내보냅니다. 여전히 필요한 참조 자막 파일을 유지하세요. 이미 수집된 출력을 다운로드하기 위해 액터를 다시 실행하지 마세요.

[결과 저장 및 재사용](https://flashdata.dev/ko/docs/guides/save-results/reference.md)

### 비디오 라이브러리 새로 고침

비디오 IDs를 제거하고 각 결과를 확인하고 입력-출력 IDs을 유지합니다. 더 큰 목록에는 일괄 처리 또는 대량 처리를 사용합니다. 오류를 검사한 후 failed 항목을 다시 시도하세요.

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

### 예정된 작업을 예측 가능하게 유지

시간대, 케이던스, 자격 증명 및 출력 대상을 가져옵니다. 이전 제작자를 폐기하기 전에 하나의 completed 일정 창을 녹화하여 일정이 중복되어 중복 작업이 생성되지 않도록 합니다.

[반복 작업 실행](https://flashdata.dev/ko/docs/guides/recurring-tasks/reference.md)

### 컷오버 체크리스트

1. 정확한 행위자, 빌드, 작업 입력, 청구 가능한 이벤트, 출력 필드 및 다운스트림 소비자를 기록합니다.
2. 기존 실행을 비우고 모든 데이터 세트 페이지를 내보냅니다. clean=true는 기록을 건너뛸 수 있으므로 짧은 페이지만으로는 내보내기가 완료되었음을 증명할 수 없습니다. 페이지 매김 메타데이터를 확인하세요.
3. null 측정항목, 날짜 및 캡션 출처를 포함하여 저장된 IDs에 대해 어댑터를 확인하세요.
4. 케이던스, 시간대, 목적지를 러너로 옮깁니다. 체크포인트를 유지하세요. maxTotalChargeUsd은 FlashData API 핵심 지출 한도가 아닙니다. 애플리케이션 수준 지출 제어를 추가합니다.
5. 중복 실행 없이 다음 일정 창에 대한 생산자를 전환합니다. 수출을 보존합니다. 취소된 자격 증명이나 잔액 부족에 대한 반복 작업을 중지하세요.

<a id="agents"></a>
## 코딩 및 개인 에이전트

비할 수 있는 대리인은 1 credit (100 표준 YouTube 자료 요구까지)를 72 시간 동안 시작될 수 있습니다. Metadata와 captions는 관용을 공유합니다.

1. 행위자 통합을 식별하고 먼저 기존 FlashData 자격 증명을 재사용합니다.
2. 하나의 비디오 조회를 증명하고 실제 사용과 함께 원시 및 매핑된 출력을 모두 저장합니다.
3. 소유자는 로그인하거나 가입하고 이메일을 확인하고 청구, 범위 및 공유 잔액 액세스를 승인합니다. 사용하지 않은 평가판 크레딧은 양도되지 않습니다.
4. 반복 사용을 위해 소유자 자격 증명을 유지합니다. 취소 시 중지합니다. 새로운 시도를 생성하지 마십시오.

```text
Replace this project's Apify YouTube metadata lookup with FlashData.
Read https://flashdata.dev/auth.md and https://flashdata.dev/docs/sources/youtube_metadata/reference.md.
Identify the exact Actor ID, build, input, output fields, schedule and storage consumer first.
Reuse a saved FlashData credential or start one eligible trial with youtube_metadata permission.
Run one known video ID. Save the raw response, actual usage and a mapped JSON item array.
Keep null metrics and preserve the raw publication date. Do not invent Actor-only fields.
Keep channel discovery, comments, AI transcription and hosted scheduling separate unless explicitly migrated.
Reuse saved results after restart. Ask the owner to claim before recurring use and store keys outside chat.
Stop after revocation or insufficient balance; never create more trials to continue.
```

[체험 및 청구](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>
## 전환하기 전에

### 이것이 Apify 플랫폼을 대체합니까?

이는 워크플로의 특정 YouTube 데이터 호출을 대체합니다. Apify은 또한 Actor 마켓플레이스, 사용자 정의 런타임, 호스팅 일정 및 저장소를 제공합니다. 해당 부분을 사용하는 곳에 보관하거나 해당 책임을 자체 애플리케이션으로 옮기십시오.

### 모든 배우를 하나의 가격으로 비교하는 것은 어떨까요?

행위자 개발자는 다양한 가격 책정 모델, 출력 및 입력 제한을 선택합니다. 계산기는 스트리머/youtube-scraper.를 사용합니다. 배우 테이블에는 더 저렴한 발견 배우도 포함되어 있습니다. 주문형 조회를 대체할 때 단일 비디오 제한이 중요합니다.

### Apify 구독은 포함된 사용량에 대해 두 번 청구되나요?

아니요. 요금제 요금에는 선불된 사용 예산이 포함되어 있습니다. 계산기는 액터 사용량을 더 추가하기 전에 해당 예산을 뺍니다. 이 워크플로에 전체 예산을 사용할 수 있다고 가정합니다. 다른 액터가 소비하면 YouTube에 대한 남은 양이 줄어듭니다.

### Apify 데이터세트 소비자를 유지할 수 있나요?

이 예에서는 익숙한 필드 이름을 선택하여 JSON 배열을 작성합니다. Apify 데이터 세트를 생성하거나 ID를 실행하지 않습니다. 새 파일을 직접 읽거나, 자체 저장소를 통해 게시하거나, 기존 소비자를 위해 이러한 매핑된 항목을 데이터 세트에 쓰는 사용자 정의 액터를 유지하세요.

### 자막과 AI 전사는 어떻게 되나요?

Apify의 주연 배우는 기존 자막과 AI 전사 옵션을 제공합니다. FlashData 기존 YouTube 트랙을 검색합니다. 메타데이터와 캡션을 별도로 요청하고, 반환된 언어와 출처를 확인하고, 음성-텍스트 또는 AI 요약 단계를 별도로 유지하세요.

### 기존 일정이나 실행 지출 한도가 이전되나요?

아니요. 선택한 러너에서 일정을 다시 만들고 애플리케이션 수준 예산 확인을 추가하세요. Apify maxTotalChargeUsd 설정은 FlashData API 핵심 지출 한도가 아닙니다. 소유자 키는 공유 계정 잔액을 사용합니다.
