Przejdź do treści
PL
Uzyskaj klucz API
Przeglądaj dokumentację

Dokumentacja API

YouTube Download API

Uzyskaj klucz API

Pobierz YouTube wideo lub audio do pamięci masowej w chmurze. Wybierz rozdzielczość, format i czas trwania klipu, a następnie śledź asynchroniczną pracę poprzez ukończenie.

API pobierania filmów z YouTube — przykłady w Pythonie

Utwórz żądanie

11- znak ID z wideo URL, a nie pełny URL.

Zaawansowane opcje medialne

Wybór formatu nadwyższa jakość, szybkość ramek i wybór języka audiojęzycznego. Format wyjściowy i granice klipów nadal obowiązują. Koniec klipu musi być następujący po starcie; można pominąć jedno z tych wiązań.

Miejsce przechowywania

Blank używa daty przesyłania UTC (RRRRMMDD).

Przed uruchomieniem kodu dodaj swoje dane uwierzytelniające na serwerze. Potrzebują pozwolenia na przesyłanie plików.

Kwalifikacje dostawców i wymogi dotyczące przechowywania
Dokończenie haka internetowegoŁadunek użyteczny, weryfikacja i ponowna kontrola haka

Markdown stosuje się do zakończonych wyników. Wpływy i status pracy zachowują swoje oryginalne pola.

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']}")
Rachunek pracy, a następnie ankieta na wynikiUwierzytelnianie X-API-Key

Parametry

Wyślij source oraz video_id na najwyższym poziomie. Opcje źródłowe należą do params. Można pominąć pola opcjonalne.

Treść żądania

sourcestring / Wymagane
Ustaw na youtube_download.
video_idstring / Wymagane
11- znak YouTube wideo ID, takich jak FUfGcZ092b0. Akceptuje litery, liczby, podkreślenia i mifeny.
Dokładnie 11 znakiDomyślnie: Nieustawione
Format zaakceptowany^[A-Za-z0-9_-]{11}$
paramsobject / Wymagane
Settings dla tego wniosku.
callback_urlstring · nullable / Opcjonalne
Async i tylko partia. Publiczne ukończenie HTTPS URL na porcie 443, do znaków 2,048. Brak danych uwierzytelniających użytkownika lub fragmentu URL. Omit, użyj null lub pustego łańcucha bez powiadomienia. W partii, ustawić to na każdym zapytaniu, na zewnątrz params.
Domyślnie: Nieustawione

Wideo i audio

params.download_typestring / Opcjonalne
audio_video łączy wideo i audio; wideo wybiera tylko wideo; audio wybiera tylko audio.
1 do 11 znakiWartości: audio_video / video / audioDomyślnie: "audio_video"
params.video_qualitystring / Opcjonalne
Wybór rozdzielczości wideo. Omit do pobrania tylko audio.
1 do 40 znakiWartości: 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 / >=4320Domyślnie: "<=720"
params.fpsstring / Opcjonalne
Ograniczenie frame- rate: > =, < = lub = = po którym następuje wartość od 1 do 240. Omit do pobrania tylko audio.
1 do 6 znakiDomyślnie: Nieustawione
Format zaakceptowany^(?:>=|<=|==)(?:[1-9]\d?|1\d\d|2[0-3]\d|240)$
params.audio_languagestring / Opcjonalne
Wybór ścieżki dźwiękowej. Dotyczy audio_video i audio.
1 do 8 znakiWartości: default / originalDomyślnie: "default"
params.audio_qualitystring / Opcjonalne
Audio- tylko bitrate w kbps, lub najlepiej. Wybory numeryczne muszą być przesyłane jako struny. Omit do pobrania wideo.
1 do 10 znakiWartości: best / 320 / 256 / 192 / 128Domyślnie: "best"
params.output_formatstring / Opcjonalne
Wideo: mp4, webm lub mkv. Audio: m4a, mp3 lub opus.
1 do 10 znakiWartości: mp4 / webm / mkv / m4a / mp3 / opusDomyślnie: mp4 (video) / m4a (audio)
params.yt_dlp_formatstring / Opcjonalne
Zaawansowany selektor formatu, od 1 do znaków 1,024 po przycinaniu spacji białych. Znaki kontrolne są odrzucane. Overrides video_quality, fps i audio_language, których wartości są następnie ignorowane; format wyjściowy i wyciskanie nadal mają zastosowanie.
1 do 1024 znakiDomyślnie: Nieustawione
params.upload_metadataboolean / Opcjonalne
Wyślij plik metadanych JSON obok pliku mediów w Twoim magazynie.
true lub falseDomyślnie: false

Wycinanie

params.start_atstring / Opcjonalne
Clip start in H: MM: SS or HH: MM: SS format, od 00:00:00 do 12:00:00. Domyślne wartości 00:00:00, gdy tylko jest dostępny end_at.
1 do 8 znakiDomyślnie: Nieustawione
Format zaakceptowany^\d{1,2}:[0-5]\d:[0-5]\d$
params.end_atstring / Opcjonalne
Koniec klipu w H: MM: SS lub HH: MM: SS format, do 12:00:00. Musi być później niż start_at.
1 do 8 znakiDomyślnie: Nieustawione
Format zaakceptowany^\d{1,2}:[0-5]\d:[0-5]\d$

Miejsce przechowywania

params.storageobject / Wymagane
Miejsce przeznaczenia wypełnionych plików medialnych. Dopuszczalne są tylko wymienione pola pamięci.
params.storage.storage_typestring / Wymagane
Dostawca przechowywania: s3, s3_compatible, oss, gcs, azure, cos, bos lub tos.
params.storage.storage_urlstring / Wymagane
Niepuste wiadro lub nazwa pojemnika, do znaków 1,024. Otoczenie Whitespace jest usuwane. Dla s3 użyj poprawnej nazwy wiadra AWS bez ścieżki URL lub folderu; foldery należą do object_prefix.
params.storage.object_prefixstring / Opcjonalne
Przedrostek z kluczem obiektowym, znaki 1 do 512. Każdy segment oddzielony od slash- akceptuje litery, cyfry, kropki, podkreślenia i hypheny ASCII; puste segmenty, i.. są odrzucane. Żadnego cięcia. Otaczające się białe spacje i jeden ślad ukośnik są usuwane. RRRRMMDD używa daty wysłania UTC, w tym w archive/YYYYMMDD.
Domyślnie: "YYYYMMDD"
params.storage.access_keystring / Opcjonalne
Klucz dostępu dla S3, S3- kompatybilny z OSS, COS, BOS lub TOS; połączony z secret_key.
params.storage.secret_keystring / Opcjonalne
Sekretny klucz dla S3, S3- kompatybilny, OSS, COS, BOS lub TOS.
params.storage.endpoint_urlstring / Opcjonalne
Ogólny punkt końcowy HTTPS dla przechowywania zgodnego z S3- lub OSS. COS, BOS i TOS pochodzą z regionu.
params.storage.regionstring / Opcjonalne
Wymagane dla COS, BOS i TOS; również dostarczyć dla S3 i S3- pobieranie. Nazwy wiader COS zawierają APID.
params.storage.service_accountobject / Opcjonalne
Konto usługowe GCS: project_id, client_email i PEM private_key.
params.storage.account_namestring / Opcjonalne
Nazwa konta Azure. Należy użyć nazwy kontenera w storage_url.
params.storage.sas_tokenstring / Opcjonalne
Kontener Azure SAS z możliwością zapisu wraz z wygaśnięciem i podpisem.

Odpowiedź

Budowniczy składa pliki do pobrania za pomocą Async lub Batch i wymaga params.storage. HTTP 200 z status: pending Potwierdza akceptację, a nie dostawę. Batch zwraca jeden paragon za wideo ID.

Składanie usage.credits en 0. Pliki do pobrania są rozliczane przez dostarczony wolumin mediów po pomyślnej dostawie; opcjonalne pliki metadanych nie dodają do pobierania opłat.

Badanie job.status do completed, następnie pobrać wynik JSON. Przeczytaj szczegóły mediów na stronie results[0], w tym wrzucony obiekt file_url, rozmiar pliku i suma kontrolna.

Przeczytaj wynik

Po zakończeniu zadania, zapisz JSON z linka wyników jako response.json. Zapisz to jako read-response.py i uruchom python read-response.py. Odczytuje szczegóły plików bez pobierania mediów lub innych wniosków.

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 może zawierać szczegóły mediów w job.result. Domyślne przepływy robocze JSON wykorzystują je, gdy są dostępne i w inny sposób postępują zgodnie z rel: results link; nie zakładaj, że wynik inline jest zawsze obecny.

Wszystkie pola odpowiedzi na zgłoszenie
PoleOpis
idstringPobierz zadanie ID.
sourcestringyoutube_download.
statusstringw oczekiwaniu na przyjęcie pracy.
created_atstringCzas tworzenia miejsc pracy w formacie ISO 8601.
usage.creditsnumber0 w momencie składania. Pliki do pobrania są pobierane przez dostarczoną ilość danych po zakończeniu.
linksarrayPodążaj za własnym linkiem dla statusu zadania i za linkiem wyników dla zakończonego wyjścia.
links[].relstringsiebie lub wyników.
links[].hrefstringURL do zapytania tym samym klawiszem API.
links[].methodstringGET.
Ukończone pola plików mediów
PoleOpis
results[0].file_urlstringLokalizacja pliku medialnego w Twoim magazynie.
results[0].file_sizeintegerRozmiar pliku w bajtach.
results[0].downloaded_bytesintegerDostawa bajtów medialnych wykorzystywanych do rozliczeń.
results[0].md5stringMD5 suma kontrolna pliku medialnego.
results[0].resolutionstring · nullableRozdzielczość wideo lub null dla wyjścia audio- lub niedostępnej wysokości.
results[0].durationnumber · nullableCzas trwania w sekundach, jeśli jest dostępny.
results[0].output_formatstringFormat pliku wyjściowego.
results[0].fpsnumber · nullableRamka, kiedy jest dostępna.
results[0].video_codecstring · nullableKodek wideo, gdy jest dostępny.
results[0].audio_codecstring · nullableKod audio, gdy jest dostępny.
results[0].dynamic_rangestring · nullableZasięg dynamiczny wideo, gdy jest dostępny.
results[0].metadataobject · optionalMetadane file_url, file_size i md5, gdy upload_metadata jest true. Metadane bajtów są wyłączone z pobierania opłat.

Powyższe pola opisują domyślną odpowiedź JSON. Opcje formatowania odnoszą się do zapisu dostawy, a nie do pliku multimedialnego. Formaty JSON, proste teksty i Markdown.

Async i cykl życia serii

Składanie zwraca pokwitowanie, nie wyniki. Async tworzy jedno zadanie; wsadowe zwraca osobne zadanie w queries[] dla każdego akceptowanego zapytania. Śledź i odzyskaj każdą pracę niezależnie.

Prześlij do data.flashdata.dev; odczyt statusu pracy i wyniki api.flashdata.dev z tym samym X-API-Key. API podstawowe przykłady używać Python i cURL.

  1. 1. Zapisz zadanie IDs

    Prześlij jeden pobierz za pomocą Async lub umieść wiele żądań pobierania wewnątrz tablicy zapytań Batch. Każdy wpis wymaga params.storage. Zapisz każdą zwróconą pracę ID.

    Async wniosek i odbiór · Organ wnioskujący Batch

  2. 2. Sprawdź status

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

    pending / processing: ankieta z opóźnieniem i szacunkiem Retry-After gdy jest obecny. completed: pobrać wyniki. failed: Kontrola job.error.

    Przeczytaj job.status, a nie status potwierdzenia zgłoszenia.

    Sprawdź status · Python i cURL

    Status zatrudnienia API
  3. 3. Wyniki pobierania

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

    Po zakończeniu, uwierzytelnić wynik odczytywany, a następnie pobrać 302 pamięci URL bez klucza API. Zapisać JSON w ciągu 24 godzin po zakończeniu.

    JSON opisuje nośniki dostarczone do Państwa magazynu. Dostęp do plików medialnych.

    Wyniki pobierania · Python i cURL · Formaty odpowiedzi

    Wynik pobrania API reference

Sondaże i pobieranie istniejących wyników nie zużywają kredytów zapytania. Czas ankiety nie anuluje zadania: zachować ID zamiast przedkładania duplikatu pracy billable. Kody błędów i powtarzanie zachowania.

Webhooki zakończenia

Subskrybuj na zapytanie

Ustaw callback_url na najwyższym poziomie żądania async, lub wewnątrz każdego zapytania w partii, na zewnątrz params. Nie jest wymagany oddzielny wniosek o rejestrację webhook- rejestracji.

Użyj publicznego HTTPS URL na porcie 443. FlashData POST powiadomienie dla każdego zadania osiągającego completed lub failed; zdarzenie zawiera linki, a nie sam wynik.

Potwierdzenie i weryfikacja

Powrót 2xx po trwałym przyjęciu wydarzenia. Kopiowanie według delivery_id, również wysłane jako X-Delivery-Id. Przekierowanie nie jest przestrzegane.

Nieudane dostawy ponownie spróbować z wykładniczym backupu, aż do 8 próbuje w sumie i co najwyżej 24 godziny po zakończeniu. Kontynuuj sondaże jako zapas.

Przekazy są niepodpisane. Potwierdź zadanie ID, źródło i status terminala poprzez Uwierzytelniony punkt końcowy stanu przed rozpatrzeniem powiadomienia. Dostawa ID jest dla dedukcji, a nie dowód autentyczności.

Przykład zdarzenia i pól haka webowego
Ilustracyjne powiadomienie o zakończeniu
{
  "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"
    }
  ]
}
PoleOpis
delivery_idstringStabilny identyfikator dostawy. Notyfikacje kopiujące przy użyciu tej wartości; jest również wysyłane w nagłówku X-Delivery-Id.
idstringJob ID.
sourcestringWymagane źródło danych.
statusstringukończone lub nie.
linksarrayPowiązania stanu i wyników. Powiadomienia nie zawierają treści wyników ani klucza API.
links[].relstringsiebie lub wyników.
links[].hrefstringAbsolute Management API URL; uwierzytelniaj kluczykiem API.
links[].methodstringGET.

Pełna umowa na haczyk i ograniczenia URL

Przetwarzanie plików Bulk

Wyślij jeden film ID na linię i utwórz zadanie Bulk ze źródłem: youtube_download. Wspólne opcje odnoszą się do każdego ID w pliku.

Umieść wymagane miejsce składowania w options.storage i ustawienia mediów w options. Single- job i Batch pobieranych używać params.storage zamiast.

Pliki multimedialne są dostarczane do pamięci masowej w chmurze. Ukończony wynik Bulk zawiera części manifest i wynik opisujące pobrane pliki. Zapisz manifest i części w ciągu 24 godzin po zakończeniu całego zadania Bulk.

Bulk przetwarzanie API · Python i cURL · Batch JSON wnioski

Zbuduj przepływ pracy Bulk dla tego źródła · Wstrzymać, wznowić i odzyskać

Masowe pobieranie filmów — narzędzia Python

Miejsce przechowywania

Dołącz params.storage w każdym wniosku o pobranie. Ustaw storage_url do swojego wiadra lub nazwy kontenera i dostarczyć referencje z dostępem do zapisu. Zachowaj dane dotyczące przechowywania na serwerze.

params.storage · S3- zgodne z celem
{
  "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 domyślne YYYYMMDD, zastąpiony datą wysłania UTC. Użyj stałego katalogu lub szablonu, takiego jak archive/YYYYMMDD.

s3
Dostawa access_key i secret_key z dostępem do zapisu. Ustaw region na obszar wiadra AWS.
s3 przykład
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
Supply access_key, secret_key i publiczny HTTPS endpoint_url. Ustaw region zgodnie z wymaganiami dostawcy; Cloudflare R2 wykorzystuje auto.
s3_compatible przykład
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
Supply account_name and sas_token, kontener SAS z pozwoleniem na zapis (sp zawiera w), zasób sr = c, expire se, wersja sv i sig podpis. storage_url jest nazwą kontenera. Nie wysyłaj endpoint_url, access_key ani secret_key.
azure przykład
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
Supply access_key, secret_key i region: bj, su lub hkg. Punkt końcowy uzyskuje się z regionu, gdy go pominięto. Użyj nazwy wiadra bez kropek.
bos przykład
params.storage · bos
{
  "storage_type": "bos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "bj"
}
cos
Supply access_key, secret_key i region ap- *, takich jak ap- hongkong. storage_url musi zawierać przyrostek APID. Nie wysyłaj endpoint_url; pochodzi z regionu.
cos przykład
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
Dostawa service_account z project_id, client_email (a .gserviceaccount.com adres) oraz PEM private_key z Twojego konta serwisowego. Konto musi mieć pisemny dostęp do wiadra. Nie wysyłaj access_key, secret_key, regionu lub endpoint_url.
gcs przykład
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
Dostawa access_key, secret_key i publiczne HTTPS endpoint_url.
oss przykład
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
Supply access_key, secret_key i region z cn-, ap-, eu- lub us- prefix. Punkt końcowy uzyskuje się z regionu, gdy go pominięto. Użyj nazwy wiadra bez kropek.
tos przykład
params.storage · tos
{
  "storage_type": "tos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "cn-beijing"
}

Rezultatem jest file_url identyfikuje obiekt w Twoim magazynie. Prywatne obiekty wymagają autoryzacji dostawcy pamięci lub podpisanego URL; klucz FlashData API nie daje dostępu do wiadra.

Kompletny proces składania, sondowania i pobierania, zobacz Pobierz YouTube audio do Amazon S3.

Dostarczanie plików

Robota jest.. rel: results punkt końcowy domyślny do przekierowania do wynik JSON, Nie jest to pobieranie MP4. FlashData przesyła faktyczne nośniki do dostarczonego pojemnika lub pojemnika. Retencja mediów jest zgodna z polityką Twojego wiadra; wynik pracy JSON wygasa 24 godziny po zakończeniu leczenia.

results[0].file_url identyfikuje obiekt, ale nie jest automatycznie publicznie lub podpisane URL. Dostęp do prywatnych mediów z pamięci SDK, lub wygenerować krótkotrwały podpisany URL na własnym serwerze. Nie wysyłaj klucza FlashData API do swojego dostawcy przechowywania.

Włącz upload_metadata do wysłania {video_id}_meta.json towarzysz w tym samym przedrostku. Jej lokalizacja i suma kontrolna pojawiają się pod results[0].metadata.

Tryb pobierania przeglądarki konsoli jest oddzielony. Publiczne pliki do pobrania API używają własnej pamięci; nie zawierają tylko konsole- browser_delivery ustawienia.

Błąd przy odzyskiwaniu

Dla awarii wysyłania lub przechowywania 403, sprawdzić usługodawcę, wiadro, region, punkt końcowy i obiektywne prawa zapisu. Nieosiągalny lub prywatny file_url nie oznacza, że wysłanie nie powiodło się: sprawdź obiekt przez swojego dostawcę pamięci masowej.

Usunięty lub niedostępny film nie może być odzyskany przez sondaże. W przypadku niedostępnych formatów, należy sprawdzić Formaty metadanych, zrelaksować ograniczenia jakości lub usunąć zaawansowany selektor. Żądania tylko dla audiów m4a, mp3 lub opus; żądania wideo wymagają mp4, webm lub mkv.

Jeśli wynik JSON wygasł, najpierw sprawdź swoje wiadro na dostarczone media. Redukcja tworzy nowy pobór i może ponosić kolejne obciążenie; nie odzyskuje starego wyniku JSON.

W przypadku błędów w uwierzytelnianiu, równowadze, formacie request- format i limicie rate- limit, użyj współdzielonego odniesienia błędu. Czas składania może jeszcze utworzyć pracę; sprawdzić istniejącą pracę przed ponownym uruchomieniem.

Błędy i kody statusu · Kiedy spróbować ponownie · Limity stóp procentowych

Przewodnik po krokach: Pobierz jeden film i zweryfikuj dostawę

Cennik

PlanyWskaźniki stosowaniana GB dostarczonySubskrypcjeZawarte kredyty na okres rozliczeniowy
Płatność za użycie0,10 USDBez opłaty miesięcznejDoładuj w razie potrzeby
Micro0,08 USD49,00 USD / miesiącKredyty 1000 (50,00 USD wykorzystania API) włączone do
Starter0,07 USD199,00 USD / miesiącKredyty 4000 (200,00 USD wykorzystania API) włączone do
Pro0,06 USD499,00 USD / miesiącKredyty 10 000 (500,00 USD wykorzystania API) włączone do
Scale0,05 USD999,00 USD / miesiącKredyty 20 000 (1000,00 USD wykorzystania API) włączone do
Business0,04 USD1999,00 USD / miesiącKredyty 40 000 (2000,00 USD wykorzystania API) włączone do

Jeden plan konta. Wspólne kredyty dla trzech produktów. Użycie pokryte kredytami w planie nie jest naliczane ponownie.

Ceny bieżące i limity dotyczące planów