Belgeleri incele
API başvurusu
YouTube Download API
YouTube video veya sesinizi bulut depolamanıza indirin. Karar, format ve klip süresi seçin, sonra asynchronous işi tamamlanmadan takip edin.
YouTube video indirme API'si — Python örnekleri
İstek oluştur
11-character ID videodan URL, tam URL değil.
Gelişmiş medya seçenekleri
Bir format seçici veya overrides kalitesi, çerçeve oranı ve ses dili seçimi. Çıkış formatı ve klipler hala geçerlidir. Video sonunda başlamalı; ya da sınır ihmal edilebilir.
Depolama destinasyonu
Blank UTC yükleme tarihini kullanır (YYMMD).
Kodu çalıştırmadan önce sunucunuzdaki depolama bilgilerini ekleyin. dosyaları yükleme iznine ihtiyaçları var.
Sağlayıcılar ve depolama gereksinimleriTamam webhook
Webhook ödeme yükü, doğrulama ve yeniden kayıtMarkdown, sonuçları tamamlamak için geçerlidir. Receipts ve iş durumu orijinal alanlarını tutar.
https://data.flashdata.dev/v1/queriesParametreler
Send Send Gönder source Ve ve video_id Üst düzeyde. Kaynak seçenekleri içeri girer params. Seçmeli alanlar ihmal edilebilir.
İstek gövdesi
sourcestring / Zorunlu- youtube_download'a ayarlayın.
video_idstring / Zorunlu- 11-character YouTube video ID, FUfGcZ092b0 gibi. Mektupları kabul eder, sayılar, işaretler ve hipnozlar.Tam olarak 11 karakterler karakterler karakterlerVarsayılan:
Set Not set Not setKabul edilen format
^[A-Za-z0-9_-]{11}$ paramsobject / Zorunlu- Settings bu istek için.
callback_urlstring · nullable / İsteğe bağlı- Async ve sadece toplu. Halk Halk Halkı HTTPS Tamam tamamlanma tamamlanma tamamlanma tamamlandı URL limanda 443, yukarı 2,048 karakterler. Kullanıcı Bilgileri veya URL parçaları yok. Omit, null veya bildirim için boş bir dize kullanın. Bir partide, bunu her sorguda, params dışında ayarlayın.Varsayılan:
Set Not set Not set
Video & Ses
params.download_typestring / İsteğe bağlı- audio_video video ve ses birleştirir; video sadece videoyu seçer; ses sadece ses seçin.1 To to to to için 11 karakterler karakterler karakterlerDeğerler:
audio_video / video / audioVarsayılan:"audio_video" params.video_qualitystring / İsteğe bağlı- Video çözünürlüğü seçimi. Omit for audio-only downloads.1 To to to to için 40 karakterler karakterler karakterlerDeğerler:
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 / >=4320Varsayılan:"<=720" params.fpsstring / İsteğe bağlı- Frame-rate constraint: >=, <= veya ==, 1'dan 240'ye bir değer izledi. Omit for audio-only downloads.1 To to to to için 6 karakterler karakterler karakterlerVarsayılan:
Set Not set Not setKabul edilen format
^(?:>=|<=|==)(?:[1-9]\d?|1\d\d|2[0-3]\d|240)$ params.audio_languagestring / İsteğe bağlı- Audio track seçimi. audio_video ve ses için uygun.1 To to to to için 8 karakterler karakterler karakterlerDeğerler:
default / originalVarsayılan:"default" params.audio_qualitystring / İsteğe bağlı- Ses sadece kbps veya en iyi. Sayısal seçimler dize olarak gönderilmelidir. Video indirmeleri için Omit.1 To to to to için 10 karakterler karakterler karakterlerDeğerler:
best / 320 / 256 / 192 / 128Varsayılan:"best" params.output_formatstring / İsteğe bağlı- Video: mp4, webm veya mkv. Ses: m4a, mp3 veya opus.1 To to to to için 10 karakterler karakterler karakterlerDeğerler:
mp4 / webm / mkv / m4a / mp3 / opusVarsayılan:mp4 (video) / m4a (audio) params.yt_dlp_formatstring / İsteğe bağlı- Gelişmiş format seçici, 1'dan 1,024 karakterlerini kırıldıktan sonra. Kontrol karakterleri reddedilir. Overrides video_quality, fps ve audio_language, hangi değerleri görmezden gelindi; çıktı formatı ve klipler hala geçerlidir.1 To to to to için 1.024 karakterler karakterler karakterlerVarsayılan:
Set Not set Not set params.upload_metadataboolean / İsteğe bağlı- Bir metadata JSON dosyasını depolamanızda medya dosyasıyla birlikte yükleyin.
trueveya veya veyafalseVarsayılan:false
Clipping
params.start_atstring / İsteğe bağlı- Video, H:MM:SS veya HH:MM:SS formatında 00:00:00'dan 12:00:00'ye başlıyor. 00:00:00'ye sadece end_at temin edilir.1 To to to to için 8 karakterler karakterler karakterlerVarsayılan:
Set Not set Not setKabul edilen format
^\d{1,2}:[0-5]\d:[0-5]\d$ params.end_atstring / İsteğe bağlı- H:MM:SS veya HH:MM:SS formatı, 12:00:00'ye kadar. start_at'den daha geç olmalıdır.1 To to to to için 8 karakterler karakterler karakterlerVarsayılan:
Set Not set Not setKabul edilen format
^\d{1,2}:[0-5]\d:[0-5]\d$
Depolama destinasyonu
params.storageobject / Zorunlu- Tamamlanan medya dosyaları için tarih. Sadece listelenen depolama alanları kabul edilir.
params.storage.storage_typestring / Zorunlu- Depolama sağlayıcısı: s3, s3_compatible, oss, gcs, azure, cos, bos veya tos.
params.storage.storage_urlstring / Zorunlu- Boş olmayan kova veya konteyner adı, 1,024 karakterlerine kadar. Beyaz uzayı çevrilir. s3 için, URL veya klasör yolu olmadan geçerli bir AWS kova adı kullanın; klasörler object_prefix'ya ait.
params.storage.object_prefixstring / İsteğe bağlı- Object-key prefix, 1 ile 512 karakterlere. Her ince parçalı segment ASCII mektuplarını, basamakları, dotları, alt kesimleri ve hipnozları kabul eder; boş segmentler, . ve .. Hiç lider yok. Beyaz uzay ve bir iz kırıklığı kaldırılmıştır. YYYYMD, archive/YYYYMMDD.D dahil UTC yükleme tarihini kullanır.Varsayılan:
"YYYYMMDD" params.storage.access_keystring / İsteğe bağlı- S3, S3- uyumlu, OSS, COS, BOS veya TOS için anahtar; secret_key ile çiftleştirildi.
params.storage.secret_keystring / İsteğe bağlı- S3, S3- uyumlu, OSS, COS, BOS veya TOS için gizli anahtar.
params.storage.endpoint_urlstring / İsteğe bağlı- Halk Yayını HTTPS uç nokta için S3- uyumlu depolama veya OSS. COS, BOS ve TOS onu bölgeden alır.
params.storage.regionstring / İsteğe bağlı- COS, BOS ve TOS için gerekli; ayrıca S3 ve S3- uyumlu indirmeler için tedarik edin. COS kova isimleri APPID içerir.
params.storage.service_accountobject / İsteğe bağlı- GCS hizmet hesabı: project_id, client_email ve PEM private_key.
params.storage.account_namestring / İsteğe bağlı- Azure depolama hesabı adı. storage_url'daki konteyner adını kullanın.
params.storage.sas_tokenstring / İsteğe bağlı- Write-specific Azure konteyner SAS with expiry and sign.
Yanıt
Talep oluşturucu Async veya Batch ile indirmeleri ve gerekli olan indirmeleri sunar. params.storage. HTTP 200 with with with ile status: pending Kabulü doğrular, teslimat değil. Batch Videoda bir iş makbuzu döndürür ID.
Submission usage.credits Is is is is Is is Is Is is'dir 0. İndirmeler, başarılı teslimattan sonra medya hacmi teslim edilir; Seçmeli metadata dosyaları suçlamaları indirmek için eklenmez.
Anket Anketi job.status zamana kadar olana kadar completed, Ardından JSON sonucu alın. Medya detaylarını okuyun results[0], Ayrıca, yüklenen nesnenin de dahil olmak üzere file_url, dosya büyüklüğü ve checksum.
Sonuç okuyun
İş tamamlandıktan sonra, tasarruf edin JSON sonuçlarından bağlantı response.json. Bunu read-response.py olarak kaydedin ve python read-response.py çalıştırın. Video indirmeden veya başka bir istek yapmadan dosya ayrıntıları okur.
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))Durum, medya ayrıntıları içerebilir job.result. Varsayılan olarak JSON iş akışları onları mevcut olduğunda ve aksi takdirde takip eder rel: results bağlantı; bir doğrusal sonucun her zaman mevcut olduğunu varsaymayın.
Tüm teslim yanıt alanları
| Field | Description Description Description |
|---|---|
idstring | İş ID'u indirin. |
sourcestring | youtube_download. |
statusstring | İş kabul edildiğinde bekleyin. |
created_atstring | ISO 8601 formatında iş yaratma zamanı. |
usage.creditsnumber | 0 teslimiyette. İndirmeler tamamlandıktan sonra veri hacmi teslim edilir. |
linksarray | İş durumu ve tamamlanmış çıktı için kendi bağlantısını takip edin. |
links[].relstring | Kendi veya sonuçları. |
links[].hrefstring | URL Aynı şekilde sorgulamak için API anahtar. |
links[].methodstring | GET. |
Tamamlanmış medya dosya alanları
| Field | Description Description Description |
|---|---|
results[0].file_urlstring | Depolamanızda medya dosyasının yeri. |
results[0].file_sizeinteger | Medya dosya boyutu Bytes. |
results[0].downloaded_bytesinteger | Fatura için kullanılan arabulucuları teslim etti. |
results[0].md5string | MD5, medya dosyasının kontrolünü kontrol eder. |
results[0].resolutionstring · nullable | Video çözümü veya null sadece ses çıktısı veya mevcut yükseklik için. |
results[0].durationnumber · nullable | Mevcut olduğunda saniyeler içinde. |
results[0].output_formatstring | Çıkış dosyası formatı. |
results[0].fpsnumber · nullable | Mevcut olduğunda Frame oranı. |
results[0].video_codecstring · nullable | Mevcut olduğunda Video codec. |
results[0].audio_codecstring · nullable | Mevcut olduğunda Audio codec. |
results[0].dynamic_rangestring · nullable | Mevcut olduğunda Video dinamik aralığı. |
results[0].metadataobject · optional | Metadata file_url, file_size ve md5 upload_metadata, true'dur. Metadata bytes indirme suçlamalarından dışlanır. |
Yukarıdaki alanlar varsayılan JSON yanıtını tanımlar. Format seçenekleri teslimat kaydına uygulanır, medya dosyası değil. JSON, düz metin ve Markdown formatları.
Async & toplu yaşam döngüsü
Submission bir makbuz döndürür, sonuç vermez. Async bir iş yaratır; toplu ayrı bir iş döndürür queries[] Her kabul edilen sorgu için. Her işi bağımsız olarak takip edin ve alın.
Göndermeye yemin ederim data.flashdata.dev; İş durumunu ve sonuçlarını okuyun api.flashdata.dev Aynı X-API-Key ile. bağlantılı API temelleri Python ve cURL kullanır.
1. İşi kurtarmak IDs
Async ile bir indirme gönderin veya bir Batch sorgu aralığında birden fazla indirme isteği koy. Her giriş params.storage'ye ihtiyaç duyar. Her geri dönüş işi ID’yu kurtarın.
2. Check durumu kontrol
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: Bir gecikme ve saygı ile anketRetry-AfterŞu anda.completed: Sonuçlar getir.failed: denetimjob.error.job.status'u okuyun, teslim makbunun statüsü değil.
İş durumu API referans3. Fetch sonuçları
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsTamamlandıktan sonra, sonuç okumasını gerçekle, sonra 302 depolama URL'yu API anahtarınız olmadan getirin. JSON'u 24 saat içinde kurtarın.
JSON, medyanın depolamanıza teslim olduğunu anlatıyor. Medya dosyasına erişim.
Fetch sonuçları · Python ve cURL · Yanıt biçimleri
Sonuç indir API referans
Mevcut sonuçları araştırmak ve getirmek sorgu kredilerini tüketmiyor. Bir anket süresi işi iptal etmez: Tekrarlanan faturalı işi sunmak yerine ID'yu tut. Hata kodları ve yeniden deneme davranışı.
Tamamlanma webhook’ları
Sorgu başına abone olun
Set Set Set callback_url Bir amin talebinin üst seviyesinde veya Her sorgunun içinde Bir partide, dışarıda params. Ayrı bir webhook kayıt isteği gerekmez.
HTTPS URL port 443. FlashData POSTs her iş için bir bildirim completed veya veya veya failed; Olay bağlantıları içeriyor, sonucun kendisi değil.
Abilgi ve doğrulama
Return Return Return dön 2xx Olayı kabul ettikten sonra. Deduplicate Tarafından delivery_id, Ayrıca, da gönderiler X-Delivery-Id. Emekliler takip edilmez.
Başarısız teslimatlar, üst üste tekrar tekrar tekrar deneme, yukarı yukarı yukarı 8 toplam denemeler Ve çoğu zaman 24 saatler tamamlandıktan sonra. Bir düşüş olarak ankete devam edin.
Callbacks imzalanmamış. İş ID, kaynak ve terminal statüsünü onaylayın Gerçekleştirilmiş durum uç noktası bildirimi işlemeden önce. Teslimat ID, gerçekliğin kanıtı değildir.
Örnek webhook olayı ve alanları
{
"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"
}
]
}| Field | Description Description Description |
|---|---|
delivery_idstring | Stable teslimat tanımlayıcısı. Bu değeri kullanarak bildirimleri karmaşıklaştırın; aynı zamanda X-Delivery-Id başlığında da gönderilir. |
idstring | İş ID. |
sourcestring | Talep edilen veri kaynağı. |
statusstring | Tamamlanan veya başarısız oldu. |
linksarray | Durum ve sonuç bağlantıları. Bildirimler sonuç içeriğini veya API anahtarını içermez. |
links[].relstring | Kendi veya sonuçları. |
links[].hrefstring | Mutlak Yönetim API URL; API anahtarınızla ilgili. |
links[].methodstring | GET. |
Bulk dosya işleme
Bir video ID hattı başına yükleyin ve Bulk işi kaynakla oluşturun: youtube_download. Paylaşılan seçenekler, dosyadaki her ID'ya uygulanır.
Gerekli depolama destinasyonunu koyun options.storage ve medya ayarları options. Single-job ve Batch indirmeleri yerine params.storage'yu kullanır.
Medya dosyaları bulut depolamanıza teslim edilir. Tamamlanan Bulk sonucu, indirmeleri tanımlamak için açık ve sonuç parçaları içeriyor. 24 saat içinde tüm Bulk işi tamamlandıktan sonra ortaya çıkan ve parçalar kurtarın.
Bulk işleme API · Python ve cURL · Batch JSON talep ediyor
Bu kaynak için bir Bulk iş akışı inşa edin · Pause, özgeçmiş ve kurtarma
Depolama destinasyonu
Add Add AddAdd Add params.storage Her indirme isteğinde. Set Set Set storage_url Kovanız veya konteyner adınıza ve bilgi kaynaklarınıza erişim ile tedarik edin. sunucunuzda depolama bilgilerini tutun.
{
"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 varsayılanlar varsayılan olarak YYYYMMDD, Ancak UTC yükleme tarihi ile değiştirildi. Sabit bir dizin veya gibi bir şablon kullanın archive/YYYYMMDD.
s3- Supply access_key ve secret_key yazı erişimle. Bölgeyi kovanızın AWS bölgesine ayarlayın.
s3 Örnek örnek örneği
{ "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 ve bir halk HTTPS endpoint_url. Sağlayıcınız tarafından gerekli olan bölge ayarlayın; Cloudflare R2 otomatik kullanır.
s3_compatible Örnek örnek örneği
{ "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 ve sas_token, yaz izni ile bir konteyner SAS (sp dahil), kaynak sr=c, expiry se, sürüm sv ve imza sig. storage_url is the container name. endpoint_url, access_key veya secret_key göndermeyin.
azure Örnek örnek örneği
{ "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 ve bölge: bj, su veya hkg. Son nokta, omized sırasında bölgeden türetilmiştir. Dots olmadan bir kova adı kullanın.
bos Örnek örnek örneği
{ "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 ve ap-hongkong gibi bir bölge. storage_url, APPID ekini içermelidir. endpoint_url göndermeyin; bölgeden türetilmiştir.
cos Örnek örnek örneği
{ "storage_type": "cos", "storage_url": "your-media-bucket-1234567890", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "region": "ap-hongkong" } gcs- service_account ile project_id, client_email (a .gserviceaccount.com adresi) ve PEM private_key hizmet hesabınızdan. Hesap, kovaya erişim yazmalıdır. access_key, secret_key, bölge veya endpoint_url göndermeyin.
gcs Örnek örnek örneği
{ "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- Supply access_key, secret_key ve kova bölgesinin halk HTTPS endpoint_url.
oss Örnek örnek örneği
{ "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 ve bölge bir cn-, ap-, eu- veya biz önceden ek. Son nokta, omized sırasında bölgeden türetilmiştir. Dots olmadan bir kova adı kullanın.
tos Örnek örnek örneği
{ "storage_type": "tos", "storage_url": "your-media-bucket", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "region": "cn-beijing" }
Sonuç file_url Depolamanızda bir nesne tanımlayın. Özel nesneler depolama sağlayıcınızın iznini veya imzalanmış bir URL; FlashData API anahtarınız sizin kovanıza erişmez.
Tam bir teslim için, anket ve indirme akışı, bakınız YouTube sesini Amazon S3.
Dosya teslimatı
İşin işi rel: results endpoint varsayılanleri bir yönlendirmeye yönlendirmek için Sonuç Sonuç Sonuç JSON, Ancak bir MP4 indirme değil. FlashData, tedarik ettiğiniz kova veya konteynere gerçek medyayı yükler. Medya tutma kovanızın politikasını takip eder; işin sonucu JSON, tamamlanmadan sonra 24 saatlerini sona erer.
results[0].file_url nesneyi tanımlar ancak otomatik olarak bir halk değildir veya URL imzalanır. Depolamanız ile özel medyaya erişim SDK, veya kısa ömürlü bir şekilde URL ile kendi sunucunuzda imzalanmıştır. FlashData API anahtarını depolama sağlayıcınıza göndermeyin.
Enable upload_metadata Yüklemek için {video_id}_meta.json Aynı ekte arkadaşı. Onun yeri ve checksum aşağıda görünüyor results[0].metadata.
Konsolun Browser indirme modu ayrı. Public API downloads kendi depolamanızı kullanır; konsol-sadece dahil etmeyin browser_delivery ayarlar.
Hata kurtarma
Başarısızlık veya depolama için 403, sağlayıcıyı kontrol edin, kova, bölge, son nokta ve nesne yazma izinleri. Bir ulaşılamaz veya özel file_url Kendi başına yükleme başarısız olduğu anlamına gelmez: nesneyi depolama sağlayıcınız aracılığıyla kontrol edin.
Kaldırılmış veya mevcut olmayan bir video, kirletici tarafından kurtarılamaz. Yok formatlar için, denetim Metadata formatları, kaliteli kısıtlamalar rahatlatır veya gelişmiş seçicileri ortadan kaldırır. Audio-sadece istekleri gerektirir m4a, mp3 veya veya veya opus; Video talepleri gerektirir mp4, webm veya veya veya mkv.
Sonuç JSON dosyasının süresi dolduysa önce teslim edilen medya için bucket alanınızı kontrol edin. Yeniden gönderim yeni bir indirme oluşturur ve ek ücret doğurabilir; eski sonuç JSON dosyasını kurtarmaz.
Doğrulama için, denge, istek-format ve oran-limit başarısızlıkları, paylaşılan hata referansını kullanın. Bir teslim süresi hala bir iş yaratabilir; yeniden denemeden önce mevcut işleri kontrol edin.
Hatalar ve durum kodları · Yeniden deneme ne zaman · Puan limitleri
Step-by-step rehberi: Bir videoyu indirin ve teslimatını doğrulayın
Fiyatlandırma
| Planlar | Kullanım oranlarıGB teslim edildi | Abonelik Aboneliği | Fatura dönemi için krediler dahil |
|---|---|---|---|
| Kullandıkça öde | $0,10 | Aylık ücret yok | Gerektiğinde bakiye ekleyin |
| Micro | $0,08 | $49,00 / ay ay ay | 1.000 kredileri ($50,00 of API kullanımı) |
| Starter | $0,07 | $199,00 / ay ay ay | 4.000 kredileri ($200,00 of API kullanımı) |
| Pro | $0,06 | $499,00 / ay ay ay | 10.000 kredileri ($500,00 of API kullanımı) |
| Scale | $0,05 | $999,00 / ay ay ay | 20.000 kredileri ($1.000,00 of API kullanımı) |
| Business | $0,04 | $1.999,00 / ay ay ay | 40.000 kredileri ($2.000,00 of API kullanımı) |
Tek hesap planı. Üç üründe ortak kredi bakiyesi. Plana dahil kredilerle karşılanan kullanım yeniden ücretlendirilmez.
Mevcut fiyatlar ve plan limitleri