Chuyển đến nội dung
VI
Lấy khóa API
Duyệt tài liệu

Tham chiếu API

YouTube Download API

Lấy khóa API

Tải về YouTube Video hoặc âm thanh đến kho lưu trữ đám mây. Chọn độ phân giải, định dạng và đoạn clip trong suốt, rồi theo dõi công việc tiện ích qua việc hoàn thành.

API tải video YouTube — ví dụ Python

Tạo yêu cầu

Hạt 11- Hồ sơ. ID từ video URLkhông phải là toàn bộ URL.

Tùy chọn phương tiện cấp cao

Trình chọn định dạng: chất lượng, tốc độ khung và khả năng chọn âm thanh. Định dạng xuất và giới hạn kẹp vẫn còn áp dụng. Cắt kết thúc & phải theo bắt đầu; một trong hai bị hạn chế.

Đích kho lưu trữ

Trống dùng ngày tải lên UTC (YYYYMMD).

Thêm thông tin lưu trữ của bạn vào máy phục vụ trước khi chạy mã. Họ cần sự cho phép để tải lên tập tin.

Yêu cầu cấp phát và lưu trữ
Bổ sung hoàn chỉnhTải về móc, xác thực và tra cứu

Markdown áp dụng cho kết quả hoàn tất. Hóa đơn và địa vị công việc giữ những cánh đồng nguyên thủy của họ.

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']}")
Hóa đơn công việc, rồi thăm dò kết quảX-API-Key Xác thực

Tham số

Gởi source và video_id Ở tầng cao nhất. Tùy chọn nguồn thuộc về params. Có thể bỏ qua trường tùy chọn.

Nội dung yêu cầu

sourcestring / Bắt buộc
Thiết lập youtube_download.
video_idstring / Bắt buộc
Hạt 11- Hồ sơ. YouTube video IDNhư FUfGcZ092b0. Chấp nhận chữ cái, số, điểm nhấn và dấu gạch nối.
Chính xác 11 Ký tựMặc định: Chưa đặt
Định dạng đã chấp nhận^[A-Za-z0-9_-]{11}$
paramsobject / Bắt buộc
Settings cho yêu cầu này.
callback_urlstring · nullable / Không bắt buộc
Async và chỉ một mẻ. Chung HTTPS hoàn tất URL trên cổng 443Đến 2,048 các nhân vật. Không có phân khúc người dùng hay URL. Omit, dùng null hoặc chuỗi rỗng không cho thông báo nào. Trong một mẻ, đặt nó trên mỗi câu hỏi, bên ngoài các tham số.
Mặc định: Chưa đặt

Ảnh động và âm thanh

params.download_typestring / Không bắt buộc
audio_video Kết hợp video và âm thanh; video chỉ chọn video; âm thanh chỉ chọn âm thanh.
1 phải 11 Ký tựGiá trị: audio_video / video / audioMặc định: "audio_video"
params.video_qualitystring / Không bắt buộc
Lựa chọn độ phân giải video. Chỉ dùng để tải về âm thanh.
1 phải 40 Ký tựGiá trị: 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 / >=4320Mặc định: "<=720"
params.fpsstring / Không bắt buộc
& Hạn chế độ cao khung: >=, <= hay == theo sau bởi một giá trị từ 1 phải 240. Chỉ dùng để tải về âm thanh.
1 phải 6 Ký tựMặc định: Chưa đặt
Định dạng đã chấp nhận^(?:>=|<=|==)(?:[1-9]\d?|1\d\d|2[0-3]\d|240)$
params.audio_languagestring / Không bắt buộc
Chọn âm thanh. Ứng dụng cho audio_video và âm thanh.
1 phải 8 Ký tựGiá trị: default / originalMặc định: "default"
params.audio_qualitystring / Không bắt buộc
Chỉ bị cắn bởi tiếng kbps, hoặc tốt nhất. Các phần tử phải được lựa chọn theo chuỗi. Omit cho việc tải video.
1 phải 10 Ký tựGiá trị: best / 320 / 256 / 192 / 128Mặc định: "best"
params.output_formatstring / Không bắt buộc
Video:mp4, webm hoặc mkv. Âm thanh: m4a,mp3 hoặc opus.
1 phải 10 Ký tựGiá trị: mp4 / webm / mkv / m4a / mp3 / opusMặc định: mp4 (video) / m4a (audio)
params.yt_dlp_formatstring / Không bắt buộc
Trình chọn định dạng cấp cao, từ 1 phải 1,024 ký tự sau khi cắt bỏ không gian trắng. Các nhân vật điều khiển bị từ chối. Ghi đè video_quality, fps và audio_language, mà giá trị được bỏ qua; định dạng xuất và cắt xén vẫn được áp dụng.
1 phải 1.024 Ký tựMặc định: Chưa đặt
params.upload_metadataboolean / Không bắt buộc
Tải siêu dữ liệu lên JSON Hồ sơ bên cạnh hồ sơ truyền thông trong kho của anh.
true hay falseMặc định: false

Gỡ bỏ

params.start_atstring / Không bắt buộc
Bắt đầu với H:MM:SS hoặc HH:MM:SS định dạng, từ 00:00:00 phải 12:00:00. Mặc định 00:00:00 chỉ khi end_at được cung cấp.
1 phải 8 Ký tựMặc định: Chưa đặt
Định dạng đã chấp nhận^\d{1,2}:[0-5]\d:[0-5]\d$
params.end_atstring / Không bắt buộc
Clip kết thúc trong H:MM:SS hoặc HH:MM định dạngSS, đến 12:00:00. Chắc trễ hơn rồi. start_at.
1 phải 8 Ký tựMặc định: Chưa đặt
Định dạng đã chấp nhận^\d{1,2}:[0-5]\d:[0-5]\d$

Đích kho lưu trữ

params.storageobject / Bắt buộc
Đích cho tập tin phương tiện đã hoàn tất. Chỉ có những khu kho lưu trữ được chấp nhận.
params.storage.storage_typestring / Bắt buộc
Nhà cung cấp kho: S3, s3_compatible, oss, gcs, azure, cos, bos hoặc tos.
params.storage.storage_urlstring / Bắt buộc
Không rỗng xô hoặc tên hộp, đến 1,024 các nhân vật. Bao quanh không gian trắng đã bị phá hủy. Đối với s3, sử dụng một tên xô AWS hợp lệ mà không có một URL hoặc đường dẫn thư mục; thư mục thuộc về object_prefix.
params.storage.object_prefixstring / Không bắt buộc
Tiền tố quan trọng đối tượng, 1 phải 512 các nhân vật. Mỗi đoạn cắt ngang chấp nhận chữ cái, chữ số, chấm, dấu gạch nối và dấu gạch nối; đoạn trống, và... bị từ chối. Không được chém đầu. Bao quanh không gian trắng và một dấu vết được gỡ bỏ. YYYMMD sử dụng ngày tải lên UTC, bao gồm trong archive/YYYYMMDD.
Mặc định: "YYYYMMDD"
params.storage.access_keystring / Không bắt buộc
Phím truy cập cho S3, S3- Tương đương, OSS, COS, BOS hoặc TOS; kết hợp với secret_key.
params.storage.secret_keystring / Không bắt buộc
Chìa khóa bí mật cho S3, S3- Hợp lý, OSS, COS, BOS hay TOS.
params.storage.endpoint_urlstring / Không bắt buộc
Chung HTTPS điểm kết thúc cho S3- Kho lưu trữ hoặc OSS tương ứng. COS, BOS và TOS lấy nó từ khu vực.
params.storage.regionstring / Không bắt buộc
Cần thiết cho COS, BOS và TOS; cũng cung cấp cho S3 và S3- Tải về tương ứng. Tên xô COS bao gồm APPID.
params.storage.service_accountobject / Không bắt buộc
GCS Tài khoản dịch vụ: project_id, client_email PEM private_key.
params.storage.account_namestring / Không bắt buộc
Azure tên tài khoản lưu trữ. Dùng tên hộp chứa trong storage_url.
params.storage.sas_tokenstring / Không bắt buộc
Ghi Azure Công-te-nơ có dấu và dấu hiệu.

Phản hồi

Yêu cầu người xây dựng tải về Async hay Batch và yêu cầu params.storage. HTTP 200 có status: pending Xác nhận chấp nhận, chứ không phải giao hàng. Batch trả lại một biên nhận công việc cho mỗi video ID.

Chịu phục usage.credits là 0. Tải về được biên dịch bằng âm lượng truyền thông sau khi giao hàng thành công; các tập tin siêu dữ liệu tùy chọn không thêm vào tài khoản tải về.

Thăm dò job.status Cho đến completed, Sau đó lấy lại kết quả. JSON. Đọc chi tiết phương tiện tại results[0], tính cả đối tượng đã tải lên file_url, cỡ tập tin và tổng kiểm tra.

Đọc kết quả

Sau khi xong việc, hãy cứu lấy JSON từ kết quả của nó kết nối như response.json. Lưu cái này vào read-response.py và chạy python read-response.py. Nó đọc chi tiết tập tin mà không cần tải về phương tiện truyền thông hay yêu cầu khác.

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

Trạng thái có thể bao gồm chi tiết phương tiện vào job.result. Mặc định JSON lưu lượng công việc sử dụng chúng khi có thể và nếu khác theo các rel: results liên kết; không cho rằng kết quả trực tiếp là luôn luôn có mặt.

Tất cả các trường đáp ứng
Tìm kiếmMô tả
idstringTải về ID.
sourcestringyoutube_download.
statusstringChờ đợi khi công việc được chấp nhận.
created_atstringThời gian tạo việc làm theo định dạng ISO 8601.
usage.creditsnumber0 đang phục tùng. Tải về được tính bằng số lượng dữ liệu sau khi hoàn tất.
linksarrayTheo liên kết tự liên kết đến trạng thái công việc và liên kết kết kết quả cho kết xuất hoàn tất.
links[].relstringbản thân hoặc kết quả.
links[].hrefstringURL để truy vấn cùng một kiểu API Chìa khóa.
links[].methodstringGET.
Hoàn tất các trường tập tin phương tiện
Tìm kiếmMô tả
results[0].file_urlstringVị trí của tập tin truyền thông trong kho của bạn.
results[0].file_sizeintegerCỡ tập tin phương tiện theo byte.
results[0].downloaded_bytesintegerTruyền thông được dùng để tính tiền.
results[0].md5stringMD5 kiểm tra tổng của tập tin truyền thông.
results[0].resolutionstring · nullableĐộ phân giải phim ảnh, hoặc null cho đầu ra âm thanh hay độ cao không sẵn sàng.
results[0].durationnumber · nullableThời gian trong giây nếu có thể.
results[0].output_formatstringĐịnh dạng tập tin xuất.
results[0].fpsnumber · nullableTỷ lệ khung nếu có.
results[0].video_codecstring · nullableBộ mã phim khi có thể.
results[0].audio_codecstring · nullableBộ mã âm thanh khi sẵn sàng.
results[0].dynamic_rangestring · nullablePhạm vi quay phim khi có thể.
results[0].metadataobject · optionalSiêu dữ liệu file_url, file_size và md5 khi upload_metadata là true. Siêu dữ liệu byte được loại trừ khỏi việc tải về.

Các trường trên mô tả giá trị mặc định JSON Trả lời đi. Các tùy chọn định dạng được áp dụng cho hồ sơ gửi, không phải tập tin phương tiện. JSON, văn bản đơn giản và Markdown Định dạng.

Async & mẻ xe đạp cứu hộ

Không có kết quả, không có gì. Async tạo ra một công việc; một mẻ cung cấp một công việc riêng biệt trong queries[] Cho mỗi yêu cầu được chấp nhận. Theo dõi và lấy lại mỗi công việc một cách độc lập.

Gởi tới data.flashdata.dev; đọc tình trạng công việc và kết quả từ api.flashdata.dev với cùng một X-API-Key. Liên kết API Các ví dụ cơ bản dùng Python và cURL.

  1. 1. Lưu công việc IDs

    Gửi một tập tin tải về Asynchoặc đặt nhiều yêu cầu tải về bên trong một Batch Hàng loạt các cửa hàng. Mỗi lối vào đều cần params.storage. Lưu mọi công việc trở về ID.

    Async yêu cầu và biên lai · Batch yêu cầu cơ thể

  2. 2. Kiểm tra trạng thái

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

    pending / processing: cuộc thăm dò với một sự chậm trễ và kính trọng Retry-After khi có mặt. completed: Tìm kết quả đi. failed: thanh tra job.error.

    Đọc job.status, không phải là địa chỉ biên nhận.

    Kiểm tra trạng thái %s Python và cURL

    Trạng thái công việc API tham chiếu
  3. 3. Lấy kết quả

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

    Sau khi hoàn thành, xác thực kết quả đọc, sau đó lấy các 302 kho URL Không có bạn API Chìa khóa. Cứu lấy JSON bên trong 24 Giờ hoàn thành.

    JSON mô tả các phương tiện truyền thông được chuyển đến kho của bạn. Truy cập tập tin đa phương tiện.

    Lấy kết quả l· Python và cURL · Định dạng phản hồi

    Tải về kết quả API tham chiếu

Làm ô nhiễm và thu thập kết quả hiện có không làm mất tín dụng truy vấn. Thời hạn bầu cử không hủy bỏ công việc: Giữ nó ID Thay vì nộp bản sao. Lỗi mã và hành vi thử lại.

Webhook khi hoàn tất

Đăng ký mỗi yêu cầu

Đặt callback_url ở cấp độ cao nhất của một yêu cầu đặc biệt, hoặc bên trong mỗi truy vấn trong một mẻ đá, bên ngoài params. Không cần yêu cầu duy trì webhoook riêng biệt.

Dùng công chúng HTTPS URL trên cổng 443. FlashData PST một thông báo cho mỗi công việc với tới completed hay failed; sự kiện này chứa các liên kết, chứ không phải kết quả chính nó.

Xác nhận và xác nhận

Trả lại 2xx sau khi chấp nhận sự kiện này. Bị hủy bỏ bởi delivery_id, cũng gửi như X-Delivery-Id. Không theo dõi sự chuyển hướng.

Việc giao hàng lại thất bại thử với số mũ ngược lại, lên đến 8 Tổng cố gắng và nhiều nhất Giờ 24 sau khi hoàn tất. Tiếp tục bỏ phiếu như một sự phản đối.

Cuộc gọi lại không được ký. Xác nhận công việc ID, nguồn và thiết bị cuối thông qua các máy chủ Điểm kết thúc trạng thái xác thực trước khi xử lý thông báo. Giao hàng. ID không phải bằng chứng về tính xác thực.

Sự kiện webhook và các trường mẫu
Thông báo hoàn tất tưởng tượng
{
  "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"
    }
  ]
}
Tìm kiếmMô tả
delivery_idstringBộ nhận dạng giao hàng ổn định. Thông báo hủy bỏ sử dụng giá trị này; nó cũng được gửi vào X-Delivery-Id Đầu trang.
idstringJob ID.
sourcestringĐã yêu cầu nguồn dữ liệu.
statusstringhoàn thành hoặc thất bại.
linksarrayTình trạng và kết quả liên kết. Thông báo không bao gồm nội dung hoặc phím API.
links[].relstringbản thân hoặc kết quả.
links[].hrefstringQuản lý tuyệt đối API URL; Xác thực với của bạn API Chìa khóa.
links[].methodstringGET.

Hợp đồng mạng và URL hạn chế

Bulk xử lý tập tin

Tải lên một video ID mỗi dòng và tạo ra Bulk công việc có mã nguồn: youtube_download. Tùy chọn chia sẻ được áp dụng cho mỗi tùy chọn ID Trong hồ sơ.

Đặt địa điểm cất giữ yêu cầu vào options.storage và thiết lập phương tiện trong options. Công việc đơn lẻ và Batch tải về params.storage Thay vào đó.

Các tập tin phương tiện được chuyển tới kho lưu trữ đám mây của bạn. Hoàn tất Bulk kết quả là có danh sách và kết quả là những phần miêu tả việc tải về. Lưu danh sách và các phần bên trong 24 Hàng giờ sau toàn bộ Bulk Công việc hoàn tất.

Bulk xử lý API · Python và cURL · Batch JSON yêu cầu

Xây dựng a Bulk dòng làm việc cho nguồn này · Tạm dừng, tiếp tục và phục hồi

Tải video hàng loạt — bộ công cụ Python

Đích kho lưu trữ

Bao gồm params.storage trong mỗi yêu cầu tải về. Đặt storage_url đến xô hoặc tên hộp và giấy ủy nhiệm cung cấp với quyền ghi. Giữ hồ sơ lưu trữ trên máy chủ.

params.storage · S3- Điểm đến tương ứng
{
  "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 mặc định YYYYMMDD, thay thế bằng UTC upload date. Dùng một thư mục cố định hoặc một mẫu như archive/YYYYMMDD.

s3
Cung cấp access_key và secret_key với quyền ghi. Đặt khu vực vào khu vực AWS.
s3 ví dụ
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
Cung cấp access_key, secret_key và công chúng HTTPS endpoint_url. Đặt vùng như được yêu cầu bởi nhà cung cấp của bạn; Cloudflare R2 sử dụng xe hơi.
s3_compatible ví dụ
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
Cung cấp account_name và sas_token, một container SaS với quyền ghi (sp bao gồm w), tài nguyên sr=c, expiry se, phiên bản sv và sig chữ ký. storage_url là tên container. Đừng gửi endpoint_url, access_key hay secret_key.
azure ví dụ
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
Cung cấp access_key, secret_key và khu vực: bj, su hoặc hkg. Điểm cuối được lấy từ vùng bị bỏ qua. Dùng tên xô không dấu vết.
bos ví dụ
params.storage · bos
{
  "storage_type": "bos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "bj"
}
cos
Cung cấp access_key, secret_key và một khu vực ap-*, chẳng hạn như ap-Hongkong. storage_url Phải bao gồm hậu tố APPID. Đừng gửi endpoint_url; nó bắt nguồn từ vùng.
cos ví dụ
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
Cung cấp service_account có project_id, client_email (a.gserviceaccount.com địa chỉ) và PEM private_key từ tài khoản của anh. Chắc là tài khoản có ghi vào xô. Không gửi access_key, secret_keyvùng hoặc endpoint_url.
gcs ví dụ
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
Cung cấp access_key, secret_key và khu vực xô xô công cộng HTTPS endpoint_url.
oss ví dụ
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
Cung cấp access_key, secret_key và khu vực với một tiền tố cn-, ap-, eu-hoặc chúng ta. Điểm cuối được lấy từ vùng bị bỏ qua. Dùng tên xô không dấu vết.
tos ví dụ
params.storage · tos
{
  "storage_type": "tos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "cn-beijing"
}

Kết quả file_url Xác định một vật thể trong kho của bạn. Các vật dụng cá nhân cần phải có sự cho phép của nhà cung cấp lưu trữ hoặc một chữ ký URL; các FlashData API Chìa khóa không cho phép truy cập vào xô của bạn.

Để hoàn toàn phục tùng, bỏ phiếu và tải về công việc, xem Tải về YouTube âm thanh cho Amazon S3.

Gửi tập tin

Công việc là rel: results mặc định kết thúc tới chuyển tiếp tới kết quả JSON, không phải là một máy bay MP4. FlashData tải các phương tiện truyền thông lên xô hoặc container mà bạn cung cấp. Số lượng phương tiện lưu giữ theo chính sách xô của bạn; kết quả công việc JSON Hết hạn 24 hàng giờ sau khi hoàn thành.

results[0].file_url Xác định đối tượng nhưng không tự động là một công chúng hay ký tự URL. Truy cập vào các phương tiện riêng với kho lưu trữ của bạn SDKhoặc tạo ra một chữ ký ngắn hạn URL trên máy chủ riêng của anh. Không được gửi FlashData API Chìa khóa của nhà cung cấp kho của anh.

Bật upload_metadata để tải lên a {video_id}_meta.json đồng hành trong cùng một tiền tố. Vị trí của nó và kiểm tra tổng xuất hiện dưới results[0].metadata.

Chế độ tải về bàn điều khiển là riêng biệt. Chung API tải về sử dụng kho riêng của bạn; không bao gồm chỉ bàn giao tiếp browser_delivery thiết lập.

Đang phục hồi lỗi

Để tải lên thất bại hoặc lưu trữ 403, Kiểm tra nhà cung cấp, xô, khu vực, điểm kết thúc và quyền viết đồ vật. Một sự riêng tư và không thể tiếp cận file_url không có nghĩa là việc tải lên bị lỗi: kiểm tra đối tượng qua nhà cung cấp lưu trữ của bạn.

Không thể lấy lại một đoạn video bị gỡ bỏ hay không có sẵn bằng cách bỏ phiếu. Định dạng không sẵn sàng, thanh tra Định dạng siêu dữ liệu, các hạn chế chất lượng thư giãn hoặc loại bỏ bộ chọn cấp cao. Cần thiết yêu cầu chỉ âm thanh m4a, mp3 hay opus; yêu cầu video mp4, webm hay mkv.

Nếu kết quả JSON đã hết hạn, trước tiên kiểm tra xô của bạn cho các phương tiện truyền thông giao hàng. Phục hồi tạo một bản tải về mới và có thể đòi lại một tính năng khác; nó không phục hồi kết quả cũ JSON.

Để xác thực, số dư, lỗi định vị và tỷ lệ thất bại, hãy dùng tham chiếu lỗi được chia sẻ. Thời hạn nộp có lẽ đã tạo một công việc; kiểm tra công việc đã có trước khi thử lại.

Lỗi và mã trạng thái · Khi nào cần thử lại · Giới hạn

Hướng dẫn từng bước một: Tải một video và xác nhận giao hàng

Giá

Gói dịch vụĐơn giá sử dụngmỗi GB được giaoĐăng kýBao gồm cả tín dụng mỗi thời gian thanh toán
Trả theo mức sử dụng0,10 US$Không có phí hàng thángNạp thêm khi cần
Micro0,08 US$49,00 US$ / tháng1.000 Tín dụng (50,00 US$ Tháng Ba API sử dụng) bao gồm
Starter0,07 US$199,00 US$ / tháng4.000 Tín dụng (200,00 US$ Tháng Ba API sử dụng) bao gồm
Pro0,06 US$499,00 US$ / tháng10.000 Tín dụng (500,00 US$ Tháng Ba API sử dụng) bao gồm
Scale0,05 US$999,00 US$ / tháng20.000 Tín dụng (1.000,00 US$ Tháng Ba API sử dụng) bao gồm
Business0,04 US$1.999,00 US$ / tháng40.000 Tín dụng (2.000,00 US$ Tháng Ba API sử dụng) bao gồm

Một gói tài khoản. Tín dụng dùng chung cho cả ba sản phẩm. Mức sử dụng được tín dụng trong gói chi trả sẽ không bị tính phí lần nữa.

Giá cả hiện tại và giới hạn kế hoạch