문서 둘러보기
API 참조
YouTube Download API
YouTube 비디오 또는 오디오를 클라우드 스토리지에 다운로드하십시오. 해상도, 형식 및 클립 지속을 선택하고, 다음 완료를 통해 비동기 작업을 추적합니다.
YouTube 동영상 다운로드 API — Python 예제
요청 구성
11-character ID 비디오에서 URL, 전체 URL.
고급 미디어 옵션
형식 선택기 overrides 품질, 프레임 속도 및 오디오 언어 선택. 산출 체재 및 클립은 아직도 적용합니다. 클립 끝은 시작을 따라야 합니다; 경계는 omitted 일 수 있습니다.
관련 상품
공백은 UTC 업로드 날짜 (YYYYMMDD)를 사용합니다.
코드를 실행하기 전에 서버에서 저장 자격 증명을 추가하십시오. 파일 업로드 권한이 필요합니다.
공급자 credentials와 저장 필요조건Markdown는 완료된 결과에 적용합니다. 영수증 및 작업 상태는 원래 필드를 유지합니다.
https://data.flashdata.dev/v1/queries제품 설명
제품 정보 source 으로 video_id 최고 수준에서. Source 옵션은 params. 선택적인 분야는 omitted 일 수 있습니다.
요청 본문
sourcestring / 필수- youtube_download로 설정.
video_idstring / 필수- 11-character YouTube 비디오 ID, FUfGcZ092b0와 같은. 문자, 숫자, 밑줄 및 하이픈을 허용한다.정확히 11 이름 *기본 정보:
설정하기수용된 체재
^[A-Za-z0-9_-]{11}$ paramsobject / 필수- 이 요구를 위한 Settings.
callback_urlstring · nullable / 선택 사항- Async 및 배치만. 공공 HTTPS 완료 URL 포트에 443, 최대 2,048 문자. 사용자 자격 또는 URL 파편이 없습니다. Omit, null 또는 알림이 없는 빈 문자열을 사용하십시오. 일괄 처리에서, 각 쿼리에 설정, 외부 params.기본 정보:
설정하기
비디오 및 오디오
params.download_typestring / 선택 사항- audio_video는 비디오와 오디오를 병합; 비디오는 비디오를 만 선택합니다; 오디오는 오디오를 만 선택합니다.1 으로 11 이름 *가치:
audio_video / video / audio기본 정보:"audio_video" params.video_qualitystring / 선택 사항- 영상 해결책 선택. 오디오 전용 다운로드를 위한 Omit.1 으로 40 이름 *가치:
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기본 정보:"<=720" params.fpsstring / 선택 사항- 프레임 속도 제약: >=, <= 또는 ==는 1에서 240로 값을 따랐습니다. 오디오 전용 다운로드를 위한 Omit.1 으로 6 이름 *기본 정보:
설정하기수용된 체재
^(?:>=|<=|==)(?:[1-9]\d?|1\d\d|2[0-3]\d|240)$ params.audio_languagestring / 선택 사항- 오디오 트랙 선택. audio_video 및 오디오에 적용됩니다.1 으로 8 이름 *가치:
default / original기본 정보:"default" params.audio_qualitystring / 선택 사항- kbps, 또는 최고의 오디오 전용 비트레이트. 숫자 선택은 문자열로 보내야 합니다. Omit 용 비디오 다운로드.1 으로 10 이름 *가치:
best / 320 / 256 / 192 / 128기본 정보:"best" params.output_formatstring / 선택 사항- 비디오: mp4, webm 또는 mkv. 오디오: m4a, mp3 또는 opus.1 으로 10 이름 *가치:
mp4 / webm / mkv / m4a / mp3 / opus기본 정보:mp4 (video) / m4a (audio) params.yt_dlp_formatstring / 선택 사항- 고급 형식 선택기, 1에서 1,024 문자를 트리밍 백스페이스 후. 제어 문자가 거부됩니다. video_quality, fps 및 audio_language를 인수하여 값이 무시됩니다. 출력 형식과 클립핑은 여전히 적용됩니다.1 으로 1,024 이름 *기본 정보:
설정하기 params.upload_metadataboolean / 선택 사항- 저장에 미디어 파일을 따라 메타 데이터 JSON 파일을 업로드하십시오.
true또는false기본 정보:false
클리핑
params.start_atstring / 선택 사항- 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$ params.end_atstring / 선택 사항- H: MM: SS 또는 HH: MM: SS 체재, 12:00:00까지. start_at 보다는 나중에 있어야 합니다.1 으로 8 이름 *기본 정보:
설정하기수용된 체재
^\d{1,2}:[0-5]\d:[0-5]\d$
관련 상품
params.storageobject / 필수- 완료된 미디어 파일에 대한 목적지. 나열된 저장 필드 만 허용됩니다.
params.storage.storage_typestring / 필수- 저장 공급자: s3, s3_compatible, oss, gcs, azure, cos, bos 또는 tos.
params.storage.storage_urlstring / 필수- 비 빈 버킷 또는 컨테이너 이름, 최대 1,024 문자. 주변 whitespace가 제거됩니다. s3를 위해, URL 또는 폴더 경로 없이 유효한 AWS 물통 이름을 사용하십시오; 폴더는 object_prefix에 속합니다.
params.storage.object_prefixstring / 선택 사항- 오브젝트 키 접두사, 1에서 512 문자. 각 슬래시 분리된 세그먼트는 ASCII 편지, 손가락, 점, underscores 및 hyphens를 받아들입니다; 빈 세그먼트, . 및 .. 거부됩니다. 주요 슬래시 없음. 흰색 공간과 한 번의 트레일 슬래시가 제거됩니다. YYYYMMDD는 archive/YYYYMMDD.를 포함한 UTC 업로드 날짜를 사용합니다.기본 정보:
"YYYYMMDD" params.storage.access_keystring / 선택 사항- S3, S3 호환, OSS, COS, BOS 또는 TOS에 대한 액세스 키; secret_key와 결합.
params.storage.secret_keystring / 선택 사항- S3, S3 호환, OSS, COS, BOS 또는 TOS에 대한 비밀 키.
params.storage.endpoint_urlstring / 선택 사항- S3 호환 스토리지 또는 OSS에 대한 공개 HTTPS 엔드 포인트. COS, BOS 및 TOS는 지역에서 그것을 파생합니다.
params.storage.regionstring / 선택 사항- COS, BOS 및 TOS에 필요한 경우, S3 및 S3 호환 다운로드에 대한 공급도 있습니다. COS 버킷 이름은 APPID를 포함합니다.
params.storage.service_accountobject / 선택 사항- GCS 서비스 계정: project_id, client_email 및 PEM private_key.
params.storage.account_namestring / 선택 사항- Azure 저장 계정 이름. storage_url의 컨테이너 이름을 사용합니다.
params.storage.sas_tokenstring / 선택 사항- expiry와 서명을 가진 쓰기 가능하게 한 Azure 콘테이너 SAS.
응답
요청 빌더는 Async 또는 Batch로 다운로드를 제출하고 필요한 경우 params.storage. HTTP 200 으로 status: pending 합격을 확인, 배송하지. Batch는 영상 ID 당 1개의 일 영수증을 반환합니다.
제출하기 usage.credits 는 0. 다운로드는 성공적인 납품 후에 전달된 매체 양에 의해 청구됩니다; 선택적인 metadata 파일은 다운로드 요금에 추가하지 않습니다.
의논하기 job.status 까지 completed, 그 결과 JSON를 검색합니다. 미디어 세부 정보 읽기 results[0], 업로드된 객체의 포함 file_url, 파일 크기 및 체크섬.
결과보기
작업이 완료되면 JSON를 결과 링크에서 response.json를 저장하십시오. read-response.py로 저장하고 python read-response.py를 실행하십시오. 미디어를 다운로드하거나 다른 요청을 작성하지 않고 파일 세부 사항을 읽습니다.
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))Status에는 미디어 세부 정보가 포함될 수 있습니다 job.result. Default JSON 작업 흐름을 사용할 때 사용 가능하고 그렇지 않으면 rel: results 링크; 인라인 결과가 항상 존재하지 않습니다.
모든 제출 응답 필드
| - 연혁 | 의 특징 |
|---|---|
idstring | ID를 다운로드하십시오. |
sourcestring | youtube_download. |
statusstring | 작업이 허용되면 종료됩니다. |
created_atstring | ISO 8601 형식의 작업 생성 시간. |
usage.creditsnumber | 제출시 0. 다운로드는 완료 후 전달된 데이터 볼륨에 의해 충전됩니다. |
linksarray | 작업 상태에 대한 자기 링크를 따르고 완성 된 출력에 대한 결과 링크. |
links[].relstring | 자기 또는 결과. |
links[].hrefstring | URL는 동일한 API 열쇠로 조회할 수 있습니다. |
links[].methodstring | GET. |
완료된 미디어 파일 필드
| - 연혁 | 의 특징 |
|---|---|
results[0].file_urlstring | 저장에 있는 미디어 파일의 위치. |
results[0].file_sizeinteger | 미디어 파일 크기 바이트. |
results[0].downloaded_bytesinteger | 결제에 사용되는 미디어 바이트를 전달합니다. |
results[0].md5string | 미디어 파일의 MD5 체크섬. |
results[0].resolutionstring · nullable | 오디오 전용 출력 또는 사용할 수없는 높이의 비디오 해상도 또는 null. |
results[0].durationnumber · nullable | 몇 초 동안 지속됩니다. |
results[0].output_formatstring | 출력 파일 형식. |
results[0].fpsnumber · nullable | 가능한 경우 프레임 속도. |
results[0].video_codecstring · nullable | 사용할 때 비디오 코덱. |
results[0].audio_codecstring · nullable | 사용할 때 오디오 코덱. |
results[0].dynamic_rangestring · nullable | 사용할 때 비디오 동적 범위. |
results[0].metadataobject · optional | 메타데이터 file_url, file_size 및 md5 upload_metadata는 true입니다. Metadata 바이트는 다운로드 요금에서 제외됩니다. |
위의 필드는 기본 JSON 응답을 설명합니다. 형식 옵션은 전송 기록에 적용, 미디어 파일이 아닙니다. JSON, 일반 텍스트 및 Markdown 형식.
Async 및 배치 수명주기
제출은 영수증을 반환, 결과가 아닙니다. Async는 한 일을 만듭니다; 배치는 분리된 일을 안으로 돌려보냅니다 queries[] 모든 허용된 쿼리에 대 한. 각 직무를 독립적으로 추적하고 검색합니다.
제출하기 data.flashdata.dev; 작업 상태 및 결과 읽기 api.flashdata.dev 동일한 X-API-Key로. API 기본 예제는 Python 및 cURL를 사용합니다.
1. 작업 IDs 저장
Async로 하나의 다운로드를 제출하거나 Batch 쿼리 배열 내부의 여러 다운로드 요청을 넣어. 각 항목은 params.storage를 필요로 합니다. 모든 반환 작업 ID 저장.
2. 본문 바로가기
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: 지연 및 존경을 가진 오염Retry-After현재 위치completed: fetch 결과.failed: 검사job.error.job.status를 읽으십시오, 제출 영수증의 상태는 아닙니다.
일 상태 API 참고3. Fetch 결과
GET https://api.flashdata.dev/v2/jobs/{jobId}/results완료 후 결과를 확인한 다음 302 저장 URL 키를 사용하지 않고 API 저장을 읽습니다. 24 시간 내에 JSON를 저장하십시오.
JSON는 당신의 저장에 배달된 매체를 설명합니다. 미디어 파일 접근.
결과 다운로드 API 참조
오염 및 기존 결과를 fetching하는 것은 쿼리 크레딧을 사용하지 않습니다. 퇴직시간은 업무 취소를 하지 않습니다. ID 대신 중복 청구 가능한 작업을 제출합니다. 오류 코드 및 재시동 행동.
완료 웹훅
자주 묻는 질문
설치하기 callback_url async 요청의 최고 수준에서, 또는 각 질의 안 배치에서, 밖에 params. 별도의 webhook-registration 요청이 필요하지 않습니다.
포트 443에 공공 HTTPS URL를 사용하십시오. FlashData POSTs 각 작업에 대한 알림 completed 또는 failed; 이벤트 포함 링크, 그 결과 자체.
Acknowledge 및 검증
을 읽다 2xx 이벤트를 수락 한 후. 으로 Deduplicate delivery_id, 또한 보내진 것과 같이 X-Delivery-Id. Redirects는 다음과 같습니다.
실패한 납품은 exponential backoff, 까지 재기합니다 8는 총 시도 가장 많이 완료 후 24 시간. 추락으로 오염을 지키십시오.
Callbacks는 할당되지 않습니다. ID, 소스 및 터미널 상태를 확인 인증된 상태 endpoint 알림을 처리하기 전에. 납품 ID는 deduplication를 위해, 정정성의 증거 아닙니다.
webhook 이벤트 및 필드 보기
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "youtube_download",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| - 연혁 | 의 특징 |
|---|---|
delivery_idstring | 안정적인 납품 식별자. 이 값을 사용하여 알림을 삭제; 또한 X-Delivery-Id 헤더에 보내집니다. |
idstring | 작업 ID. |
sourcestring | 요청된 데이터 소스. |
statusstring | 완료 또는 실패. |
linksarray | 상태 및 결과 링크. 알림은 결과 내용이나 API 키가 포함되지 않습니다. |
links[].relstring | 자기 또는 결과. |
links[].hrefstring | 절대 관리 API URL; 당신의 API 열쇠로 정정. |
links[].methodstring | GET. |
Bulk 파일 처리
라인 당 하나의 비디오 ID를 업로드하고 소스와 Bulk 작업을 만듭니다.: youtube_download. 공유 옵션은 모든 ID 파일에 적용됩니다.
필요한 저장 목적지를 넣어 options.storage 및 미디어 설정 options. Single-job 및 Batch는 대신 params.storage를 다운로드합니다.
미디어 파일은 클라우드 스토리지에 전달됩니다. 완료된 Bulk 결과는 다운로드를 설명하는 결과가 나타납니다. Bulk 작업 전체가 완료된 후 24 시간 내에 나타날과 부품을 저장하십시오.
Bulk 처리 API · Python 및 cURL · Batch JSON 요청
관련 상품
제품정보 params.storage 각 다운로드 요청에. 설치하기 storage_url 당신의 물통 또는 콘테이너 이름 및 공급 credentials는 접근을 씁니다. 서버에서 저장 자격 유지.
{
"storage_type": "s3_compatible",
"storage_url": "your-media-bucket",
"object_prefix": "archive/YYYYMMDD",
"endpoint_url": "https://your-s3-endpoint.example.com",
"region": "your-provider-region",
"access_key": "<storage-access-key>",
"secret_key": "<storage-secret-key>"
}object_prefix 기본값으로 YYYYMMDD, UTC 업로드 날짜로 대체. 고정 디렉토리 또는 템플릿을 사용하여 archive/YYYYMMDD.
s3- access_key 및 secret_key를 공급하여 액세스를 작성합니다. 버킷의 AWS 지역에 지역을 설정합니다.
s3 이름 *
{ "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는 자동차를 이용합니다.
s3_compatible 이름 *
{ "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를 보내지 마십시오.
azure 이름 *
{ "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 때 지역에서 파생됩니다. 점 없이 물통 이름을 사용하십시오.
bos 이름 *
{ "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를 보내지 마십시오; 그것은 지역에서 파생됩니다.
cos 이름 *
{ "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를 보내지 마십시오.
gcs 이름 *
{ "storage_type": "gcs", "storage_url": "your-media-bucket", "service_account": { "project_id": "your-project-id", "client_email": "[email protected]", "private_key": "-----BEGIN PRIVATE KEY-----\nYOUR_PRIVATE_KEY\n-----END PRIVATE KEY-----\n" } } oss- access_key, secret_key 및 버킷 지역의 공개 HTTPS endpoint_url를 공급하십시오.
oss 이름 *
{ "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 때 지역에서 파생됩니다. 점 없이 물통 이름을 사용하십시오.
tos 이름 *
{ "storage_type": "tos", "storage_url": "your-media-bucket", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "region": "cn-beijing" }
결과의 file_url 당신의 저장에 있는 목표를 식별합니다. 개인 개체는 저장 공급자의 허가 또는 서명한 URL를 요구합니다; FlashData API 열쇠는 당신의 물통에 접근을 보조하지 않습니다.
전체 제출, 투표 및 다운로드 워크플로우를 위해, 참조 YouTube 오디오를 Amazon S3에 다운로드.
파일 납품
작업의 rel: results endpoint 기본값은 리다이렉트로 결과 JSON, MP4 다운로드가 아닙니다. FlashData는 당신이 공급한 물통 또는 콘테이너에 실제적인 매체를 업로드합니다. 미디어 보존은 버킷의 정책을 따릅니다. 작업의 결과 JSON는 완료 후 24 시간을 만료합니다.
results[0].file_url 객체를 식별하지만 자동으로 공개 또는 서명되지 않습니다 URL. 스토리지 SDK와 개인 미디어에 액세스하거나 자체 서버에서 짧은 라이브 서명 URL를 생성합니다. 저장 공급자에 FlashData API 열쇠를 보내지 마십시오.
지원하다 upload_metadata 관련 기사 {video_id}_meta.json 같은 접두사에서 동반자. 해당 위치와 체크섬은 아래에서 나타날 수 있습니다. results[0].metadata.
콘솔의 브라우저 다운로드 모드는 별도입니다. Public API는 자신의 저장을 다운로드합니다; 콘솔 전용 포함하지 마십시오 browser_delivery 설정.
오류 복구
업로드 실패 또는 저장 403, 공급자, 물통, 지역, 엔드포인트 및 객체 쓰기 권한을 확인합니다. 부정적 또는 개인 file_url 업로드 실패를 의미하지 않습니다 : 저장 공급자를 통해 객체를 확인하십시오.
제거 또는 사용 가능한 비디오는 오염에 의해 복구 될 수 없습니다. 사용 가능한 형식의 경우, 검사 Metadata 형식, 안락한 질 constraints는 또는 진보된 selector를 제거합니다. 오디오 전용 요청은 m4a, mp3 또는 opus; 영상 요구는 요구합니다 mp4, webm 또는 mkv.
결과 JSON가 만료되면 전달된 미디어에 대한 버킷을 먼저 체크하십시오. 다시 새 다운로드를 생성하고 다른 충전 할 수 있습니다. 오래된 결과를 복구하지 않습니다 JSON.
인증, 균형, 요청 정보 및 속도 제한 실패를 위해, 공유 오류 참조를 사용합니다. 제출 시간표는 여전히 일자리를 만들 수 있습니다; 재발하기 전에 기존 작업을 확인하십시오.
단계별 가이드: 1개의 영상을 다운로드하고 납품을 확인합니다
요금
| 계획하기 | 사용법 비율배달되는 GB 당 | 이름 * | 청구 기간 당 크레딧 포함 |
|---|---|---|---|
| 사용량 기반 결제 | US$0.10 | 월 이용료 없음 | 필요할 때 충전 |
| Micro | US$0.08 | US$49.00 / 월별 월별 | 1,000 크레딧 (US$50.00의 API 사용) 포함 |
| Starter | US$0.07 | US$199.00 / 월별 월별 | 4,000 크레딧 (US$200.00의 API 사용) 포함 |
| Pro | US$0.06 | US$499.00 / 월별 월별 | 10,000 크레딧 (US$500.00의 API 사용) 포함 |
| Scale | US$0.05 | US$999.00 / 월별 월별 | 20,000 크레딧 (US$1,000.00의 API 사용) 포함 |
| Business | US$0.04 | US$1,999.00 / 월별 월별 | 40,000 크레딧 (US$2,000.00의 API 사용) 포함 |
계정당 하나의 요금제. 세 제품이 크레딧을 공유합니다. 포함된 크레딧으로 처리한 사용량에는 다시 과금하지 않습니다.
현재 가격 및 계획 제한