Przeglądaj dokumentację
Dokumentacja API
YouTube Download 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 przechowywaniaDokończenie haka internetowego
Ładunek użyteczny, weryfikacja i ponowna kontrola hakaMarkdown stosuje się do zakończonych wyników. Wpływy i status pracy zachowują swoje oryginalne pola.
https://data.flashdata.dev/v1/queriesParametry
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:
NieustawioneFormat 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:
NieustawioneFormat 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.
truelubfalseDomyś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:
NieustawioneFormat 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:
NieustawioneFormat 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.
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
| Pole | Opis |
|---|---|
idstring | Pobierz zadanie ID. |
sourcestring | youtube_download. |
statusstring | w oczekiwaniu na przyjęcie pracy. |
created_atstring | Czas tworzenia miejsc pracy w formacie ISO 8601. |
usage.creditsnumber | 0 w momencie składania. Pliki do pobrania są pobierane przez dostarczoną ilość danych po zakończeniu. |
linksarray | Podążaj za własnym linkiem dla statusu zadania i za linkiem wyników dla zakończonego wyjścia. |
links[].relstring | siebie lub wyników. |
links[].hrefstring | URL do zapytania tym samym klawiszem API. |
links[].methodstring | GET. |
Ukończone pola plików mediów
| Pole | Opis |
|---|---|
results[0].file_urlstring | Lokalizacja pliku medialnego w Twoim magazynie. |
results[0].file_sizeinteger | Rozmiar pliku w bajtach. |
results[0].downloaded_bytesinteger | Dostawa bajtów medialnych wykorzystywanych do rozliczeń. |
results[0].md5string | MD5 suma kontrolna pliku medialnego. |
results[0].resolutionstring · nullable | Rozdzielczość wideo lub null dla wyjścia audio- lub niedostępnej wysokości. |
results[0].durationnumber · nullable | Czas trwania w sekundach, jeśli jest dostępny. |
results[0].output_formatstring | Format pliku wyjściowego. |
results[0].fpsnumber · nullable | Ramka, kiedy jest dostępna. |
results[0].video_codecstring · nullable | Kodek wideo, gdy jest dostępny. |
results[0].audio_codecstring · nullable | Kod audio, gdy jest dostępny. |
results[0].dynamic_rangestring · nullable | Zasięg dynamiczny wideo, gdy jest dostępny. |
results[0].metadataobject · optional | Metadane 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. 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.
2. Sprawdź status
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: ankieta z opóźnieniem i szacunkiemRetry-Aftergdy jest obecny.completed: pobrać wyniki.failed: Kontrolajob.error.Przeczytaj job.status, a nie status potwierdzenia zgłoszenia.
Sprawdź status · Python i cURL
Status zatrudnienia API3. Wyniki pobierania
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsPo 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
{
"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"
}
]
}| Pole | Opis |
|---|---|
delivery_idstring | Stabilny identyfikator dostawy. Notyfikacje kopiujące przy użyciu tej wartości; jest również wysyłane w nagłówku X-Delivery-Id. |
idstring | Job ID. |
sourcestring | Wymagane źródło danych. |
statusstring | ukończone lub nie. |
linksarray | Powiązania stanu i wyników. Powiadomienia nie zawierają treści wyników ani klucza API. |
links[].relstring | siebie lub wyników. |
links[].hrefstring | Absolute Management API URL; uwierzytelniaj kluczykiem API. |
links[].methodstring | GET. |
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ć
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.
{
"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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
| Plany | Wskaźniki stosowaniana GB dostarczony | Subskrypcje | Zawarte kredyty na okres rozliczeniowy |
|---|---|---|---|
| Płatność za użycie | 0,10 USD | Bez opłaty miesięcznej | Doładuj w razie potrzeby |
| Micro | 0,08 USD | 49,00 USD / miesiąc | Kredyty 1000 (50,00 USD wykorzystania API) włączone do |
| Starter | 0,07 USD | 199,00 USD / miesiąc | Kredyty 4000 (200,00 USD wykorzystania API) włączone do |
| Pro | 0,06 USD | 499,00 USD / miesiąc | Kredyty 10 000 (500,00 USD wykorzystania API) włączone do |
| Scale | 0,05 USD | 999,00 USD / miesiąc | Kredyty 20 000 (1000,00 USD wykorzystania API) włączone do |
| Business | 0,04 USD | 1999,00 USD / miesiąc | Kredyty 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