# FlashData YouTube Download API

YouTube 비디오 또는 오디오를 클라우드 스토리지에 다운로드하십시오. 해상도, 형식 및 클립 지속을 선택하고, 다음 완료를 통해 비동기 작업을 추적합니다.

Canonical 참고: https://flashdata.dev/ko/docs/sources/youtube_download
평가: 2026-10-23

끝점: POST https://data.flashdata.dev/v1/queries
인증: X-API-Key: YOUR_API_KEY
모드: [Async](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/ko/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/ko/docs/reference/bulk-processing/reference.md)

필수 소스 권한: youtube_download

YOUR_API_KEY를 API 키로 교체하여 소스 권한 및 사용 가능한 크레딧을 제공합니다. 서버 또는 에이전트 호스트에 대한 요청을 실행합니다.

[인증 설정](https://flashdata.dev/ko/docs/guides/headers-and-authentication/reference.md)

[1개의 영상을 다운로드하고 납품을 확인합니다](https://flashdata.dev/ko/docs/guides/download-video-recipe/reference.md)

[YouTube 동영상 다운로드 API — Python 예제](https://github.com/flashdatadev/youtube-video-download-api)

<a id="quickstart"></a>

## 자주 묻는 질문

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_download",
    "video_id": "jNQXAC9IVRw",
    "params": {
        "download_type": "audio_video",
        "video_quality": "<=720",
        "output_format": "mp4",
        "storage": {
            "storage_type": "s3",
            "storage_url": "your-media-bucket",
            "access_key": "YOUR_ACCESS_KEY",
            "secret_key": "YOUR_SECRET_KEY",
            "region": "us-east-1",
        },
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "youtube_download",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "download_type": "audio_video",
    "video_quality": "<=720",
    "output_format": "mp4",
    "storage": {
      "storage_type": "s3",
      "storage_url": "your-media-bucket",
      "access_key": "YOUR_ACCESS_KEY",
      "secret_key": "YOUR_SECRET_KEY",
      "region": "us-east-1"
    }
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## 제품 설명

<a id="parameters-group-0"></a>

### 요청 본문

| 제품 설명 | 유형 | 필수 | 기본값 | 의 특징 |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | 이름 * | — | youtube_download로 설정.  |
| <a id="parameter-video_id"></a> video_id | string | 이름 * | 설정하기 | 11-character YouTube 비디오 ID, FUfGcZ092b0와 같은. 문자, 숫자, 밑줄 및 하이픈을 허용한다. 최소한도 길이: 11. 최대 길이: 11. 본: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-params"></a> params | object | 이름 * | — | 이 요구를 위한 Settings.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | 의 아니 | 설정하기 | Async 및 배치만. 공공 HTTPS 완료 URL 포트에 443, 최대 2,048 문자. 사용자 자격 또는 URL 파편이 없습니다. Omit, null 또는 알림이 없는 빈 문자열을 사용하십시오. 일괄 처리에서, 각 쿼리에 설정, 외부 params.  |

<a id="parameters-group-1"></a>

### 비디오 및 오디오

| 제품 설명 | 유형 | 필수 | 기본값 | 의 특징 |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-download_type"></a> params.download_type | string | 의 아니 | "audio_video" | audio_video는 비디오와 오디오를 병합; 비디오는 비디오를 만 선택합니다; 오디오는 오디오를 만 선택합니다. 허용된: "audio_video", "video", "audio". 최소한도 길이: 1. 최대 길이: 11. |
| <a id="parameter-params-video_quality"></a> params.video_quality | string | 의 아니 | "<=720" | 영상 해결책 선택. 오디오 전용 다운로드를 위한 Omit. 수용 인원: "best", "worst", "<=144", "==144", ">=144", "<=360", "==360", ">=360", "<=480", "==480", ">=480", "<=720", "==720", ">=720", "<=1080", "==1080", ">=1080", "<=1440", "==1440", ">=1440", "<=2160", "==2160", ">=2160", "<=4320", "==4320", ">=4320". 최소한도 길이: 1. 최대 길이: 40. |
| <a id="parameter-params-fps"></a> params.fps | string | 의 아니 | 설정하기 | 프레임 속도 제약: >=, <= 또는 ==는 1에서 240로 값을 따랐습니다. 오디오 전용 다운로드를 위한 Omit. 최소한도 길이: 1. 최대 길이: 6. 본: ^(?:>=\|<=\|==)(?:[1-9]\d?\|1\d\d\|2[0-3]\d\|240)$ |
| <a id="parameter-params-audio_language"></a> params.audio_language | string | 의 아니 | "default" | 오디오 트랙 선택. audio_video 및 오디오에 적용됩니다. 허용: "default", "original". 최소한도 길이: 1. 최대 길이: 8. |
| <a id="parameter-params-audio_quality"></a> params.audio_quality | string | 의 아니 | "best" | kbps, 또는 최고의 오디오 전용 비트레이트. 숫자 선택은 문자열로 보내야 합니다. Omit 용 비디오 다운로드. 허용된: "best", "320", "256", "192", "128". 최소한도 길이: 1. 최대 길이: 10. |
| <a id="parameter-params-output_format"></a> params.output_format | string | 의 아니 | mp4 (video) / m4a (audio) | 비디오: mp4, webm 또는 mkv. 오디오: m4a, mp3 또는 opus. 허용: "mp4", "webm", "mkv", "m4a", "mp3", "opus". 최소한도 길이: 1. 최대 길이: 10. |
| <a id="parameter-params-yt_dlp_format"></a> params.yt_dlp_format | string | 의 아니 | 설정하기 | 고급 형식 선택기, 1에서 1,024 문자를 트리밍 백스페이스 후. 제어 문자가 거부됩니다. video_quality, fps 및 audio_language를 인수하여 값이 무시됩니다. 출력 형식과 클립핑은 여전히 적용됩니다. 최소한도 길이: 1. 최대 길이: 1024. |
| <a id="parameter-params-upload_metadata"></a> params.upload_metadata | boolean | 의 아니 | false | 저장에 미디어 파일을 따라 메타 데이터 JSON 파일을 업로드하십시오.  |

<a id="parameters-group-2"></a>

### 클리핑

| 제품 설명 | 유형 | 필수 | 기본값 | 의 특징 |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-start_at"></a> params.start_at | string | 의 아니 | 설정하기 | H: MM: SS 또는 HH: MM: SS 체재, 00:00:00에서 12:00:00에. end_at만 공급할 때 00:00:00로 기본값. 최소한도 길이: 1. 최대 길이: 8. 본: ^\d{1,2}:[0-5]\d:[0-5]\d$ |
| <a id="parameter-params-end_at"></a> params.end_at | string | 의 아니 | 설정하기 | H: MM: SS 또는 HH: MM: SS 체재, 12:00:00까지. start_at 보다는 나중에 있어야 합니다. 최소한도 길이: 1. 최대 길이: 8. 본: ^\d{1,2}:[0-5]\d:[0-5]\d$ |

<a id="parameters-group-3"></a>

### 관련 상품

| 제품 설명 | 유형 | 필수 | 기본값 | 의 특징 |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-storage"></a> params.storage | object | 이름 * | — | 완료된 미디어 파일에 대한 목적지. 나열된 저장 필드 만 허용됩니다.  |
| <a id="parameter-params-storage-storage_type"></a> params.storage.storage_type | string | 이름 * | — | 저장 공급자: s3, s3_compatible, oss, gcs, azure, cos, bos 또는 tos.  |
| <a id="parameter-params-storage-storage_url"></a> params.storage.storage_url | string | 이름 * | — | 비 빈 버킷 또는 컨테이너 이름, 최대 1,024 문자. 주변 whitespace가 제거됩니다. s3를 위해, URL 또는 폴더 경로 없이 유효한 AWS 물통 이름을 사용하십시오; 폴더는 object_prefix에 속합니다.  |
| <a id="parameter-params-storage-object_prefix"></a> params.storage.object_prefix | string | 의 아니 | "YYYYMMDD" | 오브젝트 키 접두사, 1에서 512 문자. 각 슬래시 분리된 세그먼트는 ASCII 편지, 손가락, 점, underscores 및 hyphens를 받아들입니다; 빈 세그먼트, . 및 .. 거부됩니다. 주요 슬래시 없음. 흰색 공간과 한 번의 트레일 슬래시가 제거됩니다. YYYYMMDD는 archive/YYYYMMDD.를 포함한 UTC 업로드 날짜를 사용합니다.  |
| <a id="parameter-params-storage-access_key"></a> params.storage.access_key | string | 의 아니 | — | S3, S3 호환, OSS, COS, BOS 또는 TOS에 대한 액세스 키; secret_key와 결합.  |
| <a id="parameter-params-storage-secret_key"></a> params.storage.secret_key | string | 의 아니 | — | S3, S3 호환, OSS, COS, BOS 또는 TOS에 대한 비밀 키.  |
| <a id="parameter-params-storage-endpoint_url"></a> params.storage.endpoint_url | string | 의 아니 | — | S3 호환 스토리지 또는 OSS에 대한 공개 HTTPS 엔드 포인트. COS, BOS 및 TOS는 지역에서 그것을 파생합니다.  |
| <a id="parameter-params-storage-region"></a> params.storage.region | string | 의 아니 | — | COS, BOS 및 TOS에 필요한 경우, S3 및 S3 호환 다운로드에 대한 공급도 있습니다. COS 버킷 이름은 APPID를 포함합니다.  |
| <a id="parameter-params-storage-service_account"></a> params.storage.service_account | object | 의 아니 | — | GCS 서비스 계정: project_id, client_email 및 PEM private_key.  |
| <a id="parameter-params-storage-account_name"></a> params.storage.account_name | string | 의 아니 | — | Azure 저장 계정 이름. storage_url의 컨테이너 이름을 사용합니다.  |
| <a id="parameter-params-storage-sas_token"></a> params.storage.sas_token | string | 의 아니 | — | expiry와 서명을 가진 쓰기 가능하게 한 Azure 콘테이너 SAS.  |

<a id="response"></a>

## 결과보기

작업이 완료되면 JSON를 결과 링크에서 response.json를 저장하십시오. read-response.py로 저장하고 python read-response.py를 실행하십시오. 미디어를 다운로드하거나 다른 요청을 작성하지 않고 파일 세부 사항을 읽습니다.

### read-response.py

```python
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = {name: result.get(name) for name in (
    "file_url", "file_size", "md5", "duration", "output_format"
)}
# Use your storage credentials to access the media at file_url.
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## 샘플 제출

기록된 예; 분야 및 조사는 근원에 달려 있고 요구한 입력.
```json
{
  "id": "job_d265c693-950e-40bf-a13e-a432044d99ba",
  "source": "youtube_download",
  "status": "pending",
  "usage": {
    "credits": 0
  },
  "created_at": "2026-09-16T07:51:13.139Z",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_d265c693-950e-40bf-a13e-a432044d99ba",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_d265c693-950e-40bf-a13e-a432044d99ba/results",
      "method": "GET"
    }
  ]
}
```

## 응답 분야

| - 연혁 | 유형 | 의 특징 |
| --- | --- | --- |
| id | string | ID를 다운로드하십시오. |
| source | string | youtube_download. |
| status | string | 작업이 허용되면 종료됩니다. |
| created_at | string | ISO 8601 형식의 작업 생성 시간. |
| usage.credits | number | 제출시 0. 다운로드는 완료 후 전달된 데이터 볼륨에 의해 충전됩니다. |
| links | array | 작업 상태에 대한 자기 링크를 따르고 완성 된 출력에 대한 결과 링크. |
| links[].rel | string | 자기 또는 결과. |
| links[].href | string | URL는 동일한 API 열쇠로 조회할 수 있습니다. |
| links[].method | string | GET. |

- 다운로드는 배경 작업으로 실행됩니다. 제출 응답은 ID를 포함; 그것은 미디어 파일을 포함하지 않습니다. 완료 될 때까지 작업 상태를 따르고, 그 결과가 저장에 전달된 파일을 설명합니다. 다운로드 제출 /v1/queries 또는 /v1/queries/batch; /v1/queries/realtime 다운로드 요청을받지 않습니다.

## 응답 형식

응답은 기본적으로 JSON를 사용합니다. 이 선택적인 우두머리를 가진 다른 체재를 선택하십시오.

- Accept: application/json (기본 정보) 또는 text/plain. 일반 텍스트는 읽기 가능한 동일한 필드를 제공하며 들여쓰는 레이아웃을 나타냅니다.
- X-Respond-With: markdown. 원래 필드에 대 한 unset를 남겨 주세요. Markdown는 응답 체재로 작동합니다.

Markdown 형식의 다운로드가 나타났습니다. 미디어 파일은 원래 형식을 유지합니다. 영수증 및 작업 상태 지원 Accept 만.

아래 필드는 기본 JSON 응답을 설명합니다.

[요청 및 응답 형식 예](https://flashdata.dev/ko/docs/guides/response-formats/reference.md#completed-results)

<a id="storage"></a>

## 관련 상품

단일 작업 및 Batch 다운로드는 params.storage; Bulk는 options.storage를 다운로드합니다. storage_url는 물통 또는 콘테이너 이름입니다. 액세스를 작성하고 서버에 보관하는 자격 증명.

### s3

access_key 및 secret_key를 공급하여 액세스를 작성합니다. 버킷의 AWS 지역에 지역을 설정합니다.

```json
{
  "storage_type": "s3",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "us-east-1"
}
```

### s3_compatible

access_key, secret_key 및 공공 HTTPS endpoint_url 공급. 당신의 공급자에 의해 요구되는 대로 지역을 놓으십시오; Cloudflare R2는 자동차를 이용합니다.

```json
{
  "storage_type": "s3_compatible",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "endpoint_url": "https://YOUR_ACCOUNT_ID.r2.cloudflarestorage.com",
  "region": "auto"
}
```

### azure

account_name 및 sas_token, 쓰기 권한 (sp 포함), 리소스 sr = c, expiry se, version sv 및 서명 sig. storage_url는 컨테이너 이름입니다. endpoint_url, access_key 또는 secret_key를 보내지 마십시오.

```json
{
  "storage_type": "azure",
  "storage_url": "your-media-container",
  "account_name": "yourstorageaccount",
  "sas_token": "sv=2023-11-03&sr=c&sp=w&se=2099-01-01T00%3A00%3A00Z&sig=YOUR_SAS_SIGNATURE"
}
```

### bos

access_key, secret_key 및 지역 공급: bj, su 또는 hkg. endpoint는 omitted 때 지역에서 파생됩니다. 점 없이 물통 이름을 사용하십시오.

```json
{
  "storage_type": "bos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "bj"
}
```

### cos

access_key, secret_key 및 ap-hongkong와 같은 ap-* 지역을 공급하십시오. storage_url는 APPID suffix를 포함해야 합니다. endpoint_url를 보내지 마십시오; 그것은 지역에서 파생됩니다.

```json
{
  "storage_type": "cos",
  "storage_url": "your-media-bucket-1234567890",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "ap-hongkong"
}
```

### gcs

project_id, client_email (a .gserviceaccount.com 주소) 및 서비스 계정에서 PEM private_key와 함께 service_account 공급. 계정은 물통에 접근을 쓸 수 있어야 합니다. access_key, secret_key, 지역 또는 endpoint_url를 보내지 마십시오.

```json
{
  "storage_type": "gcs",
  "storage_url": "your-media-bucket",
  "service_account": {
    "project_id": "your-project-id",
    "client_email": "uploader@your-project-id.iam.gserviceaccount.com",
    "private_key": "-----BEGIN PRIVATE KEY-----\nYOUR_PRIVATE_KEY\n-----END PRIVATE KEY-----\n"
  }
}
```

### oss

access_key, secret_key 및 버킷 지역의 공개 HTTPS endpoint_url를 공급하십시오.

```json
{
  "storage_type": "oss",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "endpoint_url": "https://oss-cn-hongkong.aliyuncs.com"
}
```

### tos

access_key, secret_key 및 cn-, ap-, eu- 또는 us- 접두사로 지역 공급하십시오. endpoint는 omitted 때 지역에서 파생됩니다. 점 없이 물통 이름을 사용하십시오.

```json
{
  "storage_type": "tos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "cn-beijing"
}
```

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## API 기초

이 소스의 매개 변수를 사용 위의 요청 빌더와 예제. Python 및 cURL 예제를 공유 제출, 상태 및 결과 단계에 사용됩니다. Batch 바디는 쿼리를 포함하는 JSON 객체입니다. 각 항목은 자신의 직업 ID를 반환합니다.

- [Async 요청 및 영수증](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [작업 상태 확인](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [완료된 결과를 읽으십시오](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON 요청](https://flashdata.dev/ko/docs/reference/batch-and-bulk/reference.md#batch)
- [Bulk 처리 API](https://flashdata.dev/ko/docs/reference/bulk-processing/reference.md)
- [이 소스의 Bulk 워크플로우 구축](https://flashdata.dev/ko/docs/reference/bulk-processing/reference.md?source=youtube_download#playground)
- [고객 OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## 보상 알림

- [완료 webhooks를 수신하고 확인](https://flashdata.dev/ko/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## 관련 상품

- [오류와 상태 코드](https://flashdata.dev/ko/docs/errors/reference.md#status-codes)
- [재발행](https://flashdata.dev/ko/docs/errors/reference.md#retries)

<a id="delivery"></a>

## 파일 납품

다운로드는 실시간 지원하지 않습니다.

미디어는 구성 된 저장소에 업로드; 결과 JSON는 그 파일을 설명합니다. 개인 미디어는 저장 인증을 사용합니다. JSON 결과는 완료 후 24 시간을 만료; 미디어는 저장 보존 정책을 따릅니다.

## 관련 API

- [YouTube 비디오 메타 데이터 API](https://flashdata.dev/ko/docs/sources/youtube_metadata/reference.md)
- [YouTube Transcript API](https://flashdata.dev/ko/docs/sources/youtube_transcript/reference.md)
