İçeriğe geç
TR
API anahtarı al
Belgeleri incele

API başvurusu

YouTube Download API

API anahtarı alın

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 gereksinimleri
Tamam webhookWebhook ödeme yükü, doğrulama ve yeniden kayıt

Markdown, sonuçları tamamlamak için geçerlidir. Receipts ve iş durumu orijinal alanlarını tutar.

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']}")
İş makbuzu, sonra sonuçlar için anketX-API-Key doğrulama

Parametreler

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 set
Kabul 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 set
Kabul 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.
true veya veya veya falseVarsayı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 set
Kabul 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 set
Kabul 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.

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

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ı
FieldDescription Description Description
idstringİş ID'u indirin.
sourcestringyoutube_download.
statusstringİş kabul edildiğinde bekleyin.
created_atstringISO 8601 formatında iş yaratma zamanı.
usage.creditsnumber0 teslimiyette. İndirmeler tamamlandıktan sonra veri hacmi teslim edilir.
linksarrayİş durumu ve tamamlanmış çıktı için kendi bağlantısını takip edin.
links[].relstringKendi veya sonuçları.
links[].hrefstringURL Aynı şekilde sorgulamak için API anahtar.
links[].methodstringGET.
Tamamlanmış medya dosya alanları
FieldDescription Description Description
results[0].file_urlstringDepolamanızda medya dosyasının yeri.
results[0].file_sizeintegerMedya dosya boyutu Bytes.
results[0].downloaded_bytesintegerFatura için kullanılan arabulucuları teslim etti.
results[0].md5stringMD5, medya dosyasının kontrolünü kontrol eder.
results[0].resolutionstring · nullableVideo çözümü veya null sadece ses çıktısı veya mevcut yükseklik için.
results[0].durationnumber · nullableMevcut olduğunda saniyeler içinde.
results[0].output_formatstringÇıkış dosyası formatı.
results[0].fpsnumber · nullableMevcut olduğunda Frame oranı.
results[0].video_codecstring · nullableMevcut olduğunda Video codec.
results[0].audio_codecstring · nullableMevcut olduğunda Audio codec.
results[0].dynamic_rangestring · nullableMevcut olduğunda Video dinamik aralığı.
results[0].metadataobject · optionalMetadata 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. 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.

    Async isteği ve makbuz · Batch istek vücut isteği

  2. 2. Check durumu kontrol

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

    pending / processing: Bir gecikme ve saygı ile anket Retry-After Şu anda. completed: Sonuçlar getir. failed: denetim job.error.

    job.status'u okuyun, teslim makbunun statüsü değil.

    Check durumu · Python ve cURL

    İş durumu API referans
  3. 3. Fetch sonuçları

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

    Tamamlandı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ı
Illustrative tamamlanma bildirim
{
  "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"
    }
  ]
}
FieldDescription Description Description
delivery_idstringStable 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.
sourcestringTalep edilen veri kaynağı.
statusstringTamamlanan veya başarısız oldu.
linksarrayDurum ve sonuç bağlantıları. Bildirimler sonuç içeriğini veya API anahtarını içermez.
links[].relstringKendi veya sonuçları.
links[].hrefstringMutlak Yönetim API URL; API anahtarınızla ilgili.
links[].methodstringGET.

Full webhook sözleşmesi ve URL kısıtlamaları

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

Toplu video indirme — Python araç seti

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.

params.storage · S3- uyumlu destinasyon
{
  "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
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 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
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 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
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 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
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 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
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
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
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
Supply access_key, secret_key ve kova bölgesinin halk HTTPS endpoint_url.
oss Örnek örnek örneği
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 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
params.storage · tos
{
  "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

PlanlarKullanım oranlarıGB teslim edildiAbonelik AboneliğiFatura dönemi için krediler dahil
Kullandıkça öde$0,10Aylık ücret yokGerektiğinde bakiye ekleyin
Micro$0,08$49,00 / ay ay ay1.000 kredileri ($50,00 of API kullanımı)
Starter$0,07$199,00 / ay ay ay4.000 kredileri ($200,00 of API kullanımı)
Pro$0,06$499,00 / ay ay ay10.000 kredileri ($500,00 of API kullanımı)
Scale$0,05$999,00 / ay ay ay20.000 kredileri ($1.000,00 of API kullanımı)
Business$0,04$1.999,00 / ay ay ay40.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