본문으로 건너뛰기
KO
API 키 받기
문서 둘러보기

API 참조

YouTube Download API

API 키 받기

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

YouTube 동영상 다운로드 API — Python 예제

요청 구성

11-character ID 비디오에서 URL, 전체 URL.

고급 미디어 옵션

형식 선택기 overrides 품질, 프레임 속도 및 오디오 언어 선택. 산출 체재 및 클립은 아직도 적용합니다. 클립 끝은 시작을 따라야 합니다; 경계는 omitted 일 수 있습니다.

관련 상품

공백은 UTC 업로드 날짜 (YYYYMMDD)를 사용합니다.

코드를 실행하기 전에 서버에서 저장 자격 증명을 추가하십시오. 파일 업로드 권한이 필요합니다.

공급자 credentials와 저장 필요조건
웹훅Webhook 페이로드, 검증 및 재량

Markdown는 완료된 결과에 적용합니다. 영수증 및 작업 상태는 원래 필드를 유지합니다.

POSThttps://data.flashdata.dev/v1/queries
import gzip
import json
import random
import time
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_download",
    "video_id": "jNQXAC9IVRw",
    "params": {
        "download_type": "audio_video",
        "video_quality": "<=720",
        "audio_language": "default",
        "upload_metadata": False,
        "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",
        },
    },
}

def api_get(url):
    request = urllib.request.Request(url, headers={"X-API-Key": api_key})
    with urllib.request.urlopen(request, timeout=60) as response:
        return json.load(response), response.headers

class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, request, file_pointer, code, message, headers, new_url):
        return None

def read_result(url):
    request = urllib.request.Request(url, headers={"X-API-Key": api_key})
    try:
        with urllib.request.build_opener(NoRedirect).open(request, timeout=60):
            raise RuntimeError("Expected a result redirect")
    except urllib.error.HTTPError as response:
        if response.code != 302 or not response.headers.get("Location"):
            raise
        storage_url = response.headers["Location"]
        response.close()
    # Never forward the API key to storage.
    with urllib.request.urlopen(urllib.request.Request(storage_url, headers={"Accept-Encoding": "gzip"}), timeout=60) as response:
        content = response.read()
        if response.headers.get("Content-Encoding") == "gzip":
            content = gzip.decompress(content)
        return json.loads(content)

def link(job, relation):
    return next(item["href"] for item in job["links"] if item["rel"] == relation)

request = urllib.request.Request(
    "https://data.flashdata.dev/v1/queries",
    data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
    headers={"Content-Type": "application/json", "X-API-Key": api_key},
    method="POST",
)
with urllib.request.urlopen(request, timeout=120) as response:
    submission = json.load(response)
jobs = submission.get("queries", [submission])
for submitted in jobs:
    print("Job:", submitted["id"])
    deadline = time.monotonic() + 300
    while time.monotonic() < deadline:
        status, headers = api_get(link(submitted, "self"))
        job = status.get("job", status)
        if job["status"] == "completed":
            result = job.get("result") if submitted["source"] == "youtube_download" and job.get("result") is not None else read_result(link(submitted, "results"))
            print(json.dumps(result, ensure_ascii=False, indent=2))
            break
        if job["status"] == "failed":
            raise RuntimeError(f"{submitted['id']}: {job.get('error', 'Job failed')}")
        hint = headers.get("Retry-After", "1")
        delay = max(1, min(5, int(hint))) if hint.isdigit() else 5
        time.sleep(min(delay * random.uniform(1, 1.2), max(0, deadline - time.monotonic())))
    else:
        raise TimeoutError(f"Still running; save this job ID: {submitted['id']}")
작업 영수증, 그 결과에 대한 설문 조사X-API-Key 인증

제품 설명

제품 정보 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를 실행하십시오. 미디어를 다운로드하거나 다른 요청을 작성하지 않고 파일 세부 사항을 읽습니다.

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 링크; 인라인 결과가 항상 존재하지 않습니다.

모든 제출 응답 필드
- 연혁의 특징
idstringID를 다운로드하십시오.
sourcestringyoutube_download.
statusstring작업이 허용되면 종료됩니다.
created_atstringISO 8601 형식의 작업 생성 시간.
usage.creditsnumber제출시 0. 다운로드는 완료 후 전달된 데이터 볼륨에 의해 충전됩니다.
linksarray작업 상태에 대한 자기 링크를 따르고 완성 된 출력에 대한 결과 링크.
links[].relstring자기 또는 결과.
links[].hrefstringURL는 동일한 API 열쇠로 조회할 수 있습니다.
links[].methodstringGET.
완료된 미디어 파일 필드
- 연혁의 특징
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. 1. 작업 IDs 저장

    Async로 하나의 다운로드를 제출하거나 Batch 쿼리 배열 내부의 여러 다운로드 요청을 넣어. 각 항목은 params.storage를 필요로 합니다. 모든 반환 작업 ID 저장.

    Async 요청 및 영수증 · Batch 요구 몸

  2. 2. 본문 바로가기

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: 지연 및 존경을 가진 오염 Retry-After 현재 위치 completed: fetch 결과. failed: 검사 job.error.

    job.status를 읽으십시오, 제출 영수증의 상태는 아닙니다.

    상태 확인 · Python 및 cURL

    일 상태 API 참고
  3. 3. Fetch 결과

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    완료 후 결과를 확인한 다음 302 저장 URL 키를 사용하지 않고 API 저장을 읽습니다. 24 시간 내에 JSON를 저장하십시오.

    JSON는 당신의 저장에 배달된 매체를 설명합니다. 미디어 파일 접근.

    흠집 결과 · Python 및 cURL · 응답 형식

    결과 다운로드 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[].methodstringGET.

웹훅 계약 및 URL 제한

Bulk 파일 처리

라인 당 하나의 비디오 ID를 업로드하고 소스와 Bulk 작업을 만듭니다.: youtube_download. 공유 옵션은 모든 ID 파일에 적용됩니다.

필요한 저장 목적지를 넣어 options.storage 및 미디어 설정 options. Single-job 및 Batch는 대신 params.storage를 다운로드합니다.

미디어 파일은 클라우드 스토리지에 전달됩니다. 완료된 Bulk 결과는 다운로드를 설명하는 결과가 나타납니다. Bulk 작업 전체가 완료된 후 24 시간 내에 나타날과 부품을 저장하십시오.

Bulk 처리 API · Python 및 cURL · Batch JSON 요청

이 소스의 Bulk 워크플로우 구축 · 일시 중지, 재시작 및 복구

동영상 일괄 다운로드 — Python 툴킷

관련 상품

제품정보 params.storage 각 다운로드 요청에. 설치하기 storage_url 당신의 물통 또는 콘테이너 이름 및 공급 credentials는 접근을 씁니다. 서버에서 저장 자격 유지.

params.storage · S3 호환 대상
{
  "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 이름 *
params.storage · 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 이름 *
params.storage · 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 이름 *
params.storage · 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 이름 *
params.storage · 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 이름 *
params.storage · 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 이름 *
params.storage · 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 이름 *
params.storage · 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 이름 *
params.storage · 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월 이용료 없음필요할 때 충전
MicroUS$0.08US$49.00 / 월별 월별1,000 크레딧 (US$50.00의 API 사용) 포함
StarterUS$0.07US$199.00 / 월별 월별4,000 크레딧 (US$200.00의 API 사용) 포함
ProUS$0.06US$499.00 / 월별 월별10,000 크레딧 (US$500.00의 API 사용) 포함
ScaleUS$0.05US$999.00 / 월별 월별20,000 크레딧 (US$1,000.00의 API 사용) 포함
BusinessUS$0.04US$1,999.00 / 월별 월별40,000 크레딧 (US$2,000.00의 API 사용) 포함

계정당 하나의 요금제. 세 제품이 크레딧을 공유합니다. 포함된 크레딧으로 처리한 사용량에는 다시 과금하지 않습니다.

현재 가격 및 계획 제한