Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Rujukan API

YouTube Download API

Dapatkan kunci API

Muaturun video atau audio YouTube ke penyimpanan awan anda. BAHASA Pilih resolusi, format dan durasi klip, kemudian lacak pekerjaan asinkron melalui penyelesaian.

API muat turun video YouTube — contoh Python

Bina permintaan

Karakter 11-karakter ID dari video URL, bukan URL penuh.

Pilihan media lanjutan

Pemilih format untuk format akan membatalkan kualitas, tingkat bingkai dan pemilihan audio-bahasa. Format keluaran dan batas klip yang masih berlaku. Klip Klip ujung harus mengikuti awal; kedua batas dapat diabaikan.

Destinasi Penyimpanan WARGA

Bousdon menggunakan tanggal upload UTC (YYYYMMDD).

Tambahkan bukti kelayakan penyimpanan Anda pada server Anda sebelum menjalankan kode. Mereka perlu izin untuk mengunggah file.

Persyaratan kelayakan dan penyimpanan Penyediaan
webhook pelengkapan hasil penyempurnaan dilakukanMuatan Webhook, verifikasi dan retriy

Markdown berlaku untuk hasil yang telah selesai. Penerimaan dan status pekerjaan mempertahankan bidang asal mereka.

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']}")
Resepsi penerimaan resis penerimaan, lalu jajak pendapat untuk hasilOtentikasi X-API-Key

Parameter

Kirim source Dan video_id Di tingkat atas. Pilihan sumber termasuk dalam params. Bidang opsional dapat diabaikan.

Badan permintaan

sourcestring / Wajib
Ditetapkan untuk youtube_download.
video_idstring / Wajib
Karakter 11-karakter YouTube video ID, seperti FUfGcZ092b0. 280 Terima huruf, angka, underscore dan tanda hubung.
Tepatnya 11 aksaraDefault: Tidak Diset
Format yang telah Diterima^[A-Za-z0-9_-]{11}$
paramsobject / Wajib
Settings untuk permintaan ini.
callback_urlstring · nullable / Pilihan
Async dan hanya kelumpuhan. Kompisi HTTPS publik URL pada port 443, hingga karakter 2,048. Kelayakan pengguna tidak ada atau fragmen URL. Omit, gunakan null atau string kosong tanpa pemberitahuan. Dalam kelompok, set ini pada setiap pertanyaan, param luar.
Default: Tidak Diset

Video & audio

params.download_typestring / Pilihan
audio_video gabungkan video dan audio; video pilih video saja; audio pilih audio saja.
1 Ke 11 aksaraNilai-Nilai: audio_video / video / audioDefault: "audio_video"
params.video_qualitystring / Pilihan
Pemilihan resolusi video. \"Omit\" untuk unduhan audio-saja.
1 Ke 40 aksaraNilai-Nilai: 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 / >=4320Default: "<=720"
params.fpsstring / Pilihan
Kekangan Frame-rate: >=, <= atau == diikuti dengan nilai dari 1 ke 240. \"Omit\" untuk unduhan audio-saja.
1 Ke 6 aksaraDefault: Tidak Diset
Format yang telah Diterima^(?:>=|<=|==)(?:[1-9]\d?|1\d\d|2[0-3]\d|240)$
params.audio_languagestring / Pilihan
Pemilihan trek audio. Applise untuk audio_video dan audio.
1 Ke 8 aksaraNilai-Nilai: default / originalDefault: "default"
params.audio_qualitystring / Pilihan
Audio berbasis-saja bitrate dalam kbps, atau terbaik. Pilihan angka angka harus dikirim sebagai string. Omit untuk unduhan video.
1 Ke 10 aksaraNilai-Nilai: best / 320 / 256 / 192 / 128Default: "best"
params.output_formatstring / Pilihan
Video: mp4, webm atau mkv. Audio: m4a, mp3 atau opus.
1 Ke 10 aksaraNilai-Nilai: mp4 / webm / mkv / m4a / mp3 / opusDefault: mp4 (video) / m4a (audio)
params.yt_dlp_formatstring / Pilihan
Pemilih format lanjutan dari 1 ke 1,024 karakter setelah pemangkasan spasi. Karakter kontrol jardin ditolak. Diskronds video_quality, fps dan audio_language, yang nilai-nilainya kemudian diabaikan; format output dan kliping masih berlaku.
1 Ke 1,024 aksaraDefault: Tidak Diset
params.upload_metadataboolean / Pilihan
upload data metadata berkas JSON di samping berkas media dalam penyimpanan Anda.
true OR atau ORANG falseDefault: false

Klipping Kliping Kliping

params.start_atstring / Pilihan
Masa mula klip dalam format H:MM:SS atau HH:MM:SS, dari 00:00:00 hingga 12:00:00. Nilai lalai ialah 00:00:00 apabila hanya end_at diberikan.
1 Ke 8 aksaraDefault: Tidak Diset
Format yang telah Diterima^\d{1,2}:[0-5]\d:[0-5]\d$
params.end_atstring / Pilihan
Klip klip Klip berakhir dalam format H:MM:SS atau HH:MM:SS, hingga 12:00:00. Pasti lebih lambat dari start_at.
1 Ke 8 aksaraDefault: Tidak Diset
Format yang telah Diterima^\d{1,2}:[0-5]\d:[0-5]\d$

Destinasi Penyimpanan WARGA

params.storageobject / Wajib
Destinasi untuk berkas media yang telah selesai. Hanya ladang penyimpanan terdaftar yang diterima.
params.storage.storage_typestring / Wajib
Penyedia penyimpanan barang: s3, s3_compatible, oss, gcs, azure, cos, bos atau tos.
params.storage.storage_urlstring / Wajib
Nama ember atau wadah yang tidak kosong, hingga karakter 1,024. Ruang angkasa yang mengelilinginya telah dihapus. Untuk s3, gunakan nama baldi AWS yang valid tanpa URL atau jalur folder; folder termasuk dalam object_prefix.
params.storage.object_prefixstring / Pilihan
Awalan Object-key, 1 ke karakter 512. Setiap segmen dipisahkan garis miring menerima huruf ASCII, digit, titik, underscore dan tanda hubung; segmen kosong, . dan .. ditolak. Tidak ada garis miring terkemuka. Ruang putih yang mengelilingi dan satu jejak miring dihilangkan. YYYYYMMDD menggunakan tanggal unggah UTC, termasuk dalam archive/YYYYMMDD.
Default: "YYYYMMDD"
params.storage.access_keystring / Pilihan
Kunci akses untuk S3, S3-compatible, OSS, COS, BOS atau TOS; dipasangkan dengan secret_key.
params.storage.secret_keystring / Pilihan
Kunci rahasia untuk S3, S3-compatible, OSS, COS, BOS atau TOS.
params.storage.endpoint_urlstring / Pilihan
Titik akhir HTTPS Publik untuk penyimpanan kompatibel S3 atau OSS. COS, BOS dan TOS menghasilkannya dari daerah.
params.storage.regionstring / Pilihan
Aquired untuk COS, BOS dan TOS; juga memasok untuk S3 dan S3-compatible downloads. Nama - nama ember baldi baldi dari COS termasuk APPID.
params.storage.service_accountobject / Pilihan
Akun layanan GCS: project_id, client_email dan PEM private_key.
params.storage.account_namestring / Pilihan
Nama akun penyimpanan Azure. Use the container nama dalam storage_url.
params.storage.sas_tokenstring / Pilihan
Azure yang dapat ditulis dengan kata sandi dan tanda tangan.

Respons

Ahli pembangun permintaan mengajukan unduhan dengan Async atau Batch dan membutuhkan params.storage. HTTP 200 dengan status: pending Kepastian penerimaan, bukan pengiriman. Haxeb Batch mengembalikan satu penerimaan kerja per video ID.

Submisi usage.credits Ini adalah.. 0. Unduhan-unduhan COMMAND ditagih oleh volume media yang disampaikan setelah pengiriman sukses; berkas data meta opsional tidak menambah biaya muat turun.

OB job.status Fijiananan-ananan sampai completed, kemudian mengambil hasil JSON. Baca rincian media di results[0], Termasuk objek yang diunggah file_url, ukuran berkas dan checksum.

Baca hasilnya

Setelah pekerjaan selesai, simpan JSON dari link hasil sebagai response.json. Simpan ini sebagai read-response.py dan jalankan python read-response.py. Ia membaca rincian berkas tanpa mengunduh media atau membuat permintaan lain.

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 faks mungkin mencakup rincian media dalam job.result. Default JSON Pengaliran kerja menggunakan mereka ketika tersedia dan sebaliknya mengikuti rel: results Hubungan vinalis; jangan menganggap hasil inline selalu ada.

Semua medan respon penyerahan
UkrainianKeterangan
idstringdownload pekerjaan ID.
sourcestringyoutube_download.
statusstringBertangguh ketika pekerjaan diterima.
created_atstringWaktu penciptaan Job freak tooling dalam format ISO 8601.
usage.creditsnumber0 pada pengiriman. Unduhan-unduhan telah dibebankan oleh volume data yang disampaikan setelah selesai.
linksarray** Ikuti self link untuk status pekerjaan dan link hasil untuk keluaran selesai.
links[].relstringKegandirian atau hasil.
links[].hrefstringURL pertanyaan untuk ditanya dengan pertanyaan yang sama API Kuncinya.
links[].methodstringGET.
Medan berkas media Completed
UkrainianKeterangan
results[0].file_urlstringLokasi file media di penyimpananmu.
results[0].file_sizeintegerUkuran berkas media di byte.
results[0].downloaded_bytesintegerBile media yang dikirim digunakan untuk penagihan.
results[0].md5stringChecksum MD5 dari berkas media.
results[0].resolutionstring · nullableResolusi video, atau null untuk output audio-saja atau ketinggian tidak tersedia.
results[0].durationnumber · nullableDurasi dalam detik ketika tersedia.
results[0].output_formatstringformat berkas keluaran.
results[0].fpsnumber · nullableTingkat frame ketika tersedia.
results[0].video_codecstring · nullableKodeks video kodeks faks bila tersedia.
results[0].audio_codecstring · nullableKodeks audio kodeks kodeks faks bila tersedia.
results[0].dynamic_rangestring · nullableKisaran dinamis video yang terkodinamik bila tersedia.
results[0].metadataobject · optionalMetadata file_url, file_size dan md5 ketika upload_metadata adalah true. Metadata byte dikecualikan dari biaya muat turun.

Bidang-bidang di atas menggambarkan respon JSON baku. Pilihan format yang diterapkan pada catatan pengiriman, bukan berkas media. JSON, teks polos dan Markdown format.

Zavous Async & batch lifecycle

Surat penyerahan mengembalikan penerimaan, bukan hasil. Async menciptakan satu pekerjaan; batch mengembalikan pekerjaan yang terpisah dalam queries[] Untuk setiap pertanyaan yang diterima. Track dan mendapatkan setiap pekerjaan secara independen.

Diserahkan ke data.flashdata.dev; baca status pekerjaan dan hasil dari api.flashdata.dev Dan X-API-Key yang sama. Contoh dasar API terkait menggunakan Python dan cURL.

  1. 1. Simpan pekerjaan IDs

    Ajukan satu unduhan dengan Async, atau letakkan permintaan unduhan berganda di dalam sebuah Batch query array. Setiap entri membutuhkan params.storage. Simpan setiap pekerjaan yang dikembalikan ID.

    Permintaan dan penerimaan Async · badan permintaan Batch

  2. 2. Periksa status

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

    pending / processing: jajak pendapat dengan penundaan dan rasa hormat Retry-After Ketika hadir. completed: Hasil tangkapan. failed: [ : ] inspeksi job.error.

    Read job.status, bukan status penerimaan.

    Periksa status · Python dan cURL

    Referensi API status Job
  3. 3. Hasil kutipan

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

    Selepas selesai, sahkan akses untuk membaca hasil, kemudian ambil URL storan daripada 302 tanpa kunci API anda. Simpan JSON dalam masa 24 jam selepas selesai.

    JSON menggambarkan media yang dikirimkan ke penyimpananmu. Akses berkas media.

    Hasil kutip · Python dan cURL · Format respons

    Hasil pengambilan gambar referensi API

Pengejaan dan pengambilan hasil yang sudah ada tidak mengkonsumsi kredit pertanyaan. TOPN TPS tidak membatalkan pekerjaan: menjaga ID daripada mengajukan pekerjaan yang dapat ditagih. Kode galat dan perilaku coba ulang dan kode galat.

Webhook penyelesaian

Langganan per pertanyaan

**Ditetapkan* callback_url Di tingkat atas dari permintaan async, atau lema di dalam setiap pertanyaan Di dalam kelompok, di luar params. Tidak ada permintaan pendaftaran-keuskupan webhook terpisah yang diperlukan.

Use a public HTTPS URL di port 443. FlashData POSTs sebuah pemberitahuan untuk setiap jangkauan pekerjaan completed OR atau ORANG failed; BARV; acara tersebut berisi tautan, bukan hasil itu sendiri.

Mengakui dan memverifikasi

AWAS 2xx Setelah menerima acara itu dengan baik. Duakan duplikasi oleh delivery_id, Dan dikirim sebagai.. X-Delivery-Id. Redirect tidak diikuti.

Pengiriman Gagal dicoba dengan pengunduran eksponensial, hingga Total percobaan 8 Zain dan paling banyak 24 jam sesudah selesai. Tetap melakukan pemungutan suara sebagai kemunduran.

Panggilan balik tidak ditandatangani. Konfirmasi pekerjaan ID, sumber dan status terminal melalui Titik akhir status tersahihkan Bekal sebelum memproses pemberitahuan. Kiriman ID adalah untuk deduksi, bukan bukti keaslian.

Contoh senam webhook peristiwa dan bidang
Pemberitahuan penyelesaian ilustrasi
{
  "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"
    }
  ]
}
UkrainianKeterangan
delivery_idstringPengenal pengiriman yang stabil. Pemberitahuan dundaplikasi menggunakan nilai ini; juga dikirim dalam header X-Delivery-Id.
idstringYob ID.
sourcestringSumber data yang dimintakan oleh KANTOR.
statusstringGagal atau gagal.
linksarrayStatus dan hasil link. Pemakluman kata nifaks tidak termasuk konten hasil atau kunci API.
links[].relstringKegandirian atau hasil.
links[].hrefstringManajemen Absolute API URL; sahihkan dengan kunci API anda.
links[].methodstringGET.

Pembatasan kontrak penuh webhook dan URL

Pemrosesan berkas Bulk

loadloadload satu video ID per baris dan membuat pekerjaan Bulk dengan sumber: youtube_download. Pilihan terkongsi diterapkan untuk setiap ID dalam berkas.

Letakkan destinasi storan yang diperlukan dalam options.storage setting media di dalam options. download job-job tunggal dan Batch menggunakan params.storage sebagai gantinya.

File media telah dikirimkan ke penyimpanan awanmu. Hasil Bulk yang telah selesai termasuk bagian manifes dan hasil yang menggambarkan unduhan. Simpan manifes dan bagian dalam 24 jam setelah seluruh pekerjaan Bulk selesai.

Pemrosesan Bulk API · Python dan cURL · Permintaan Batch JSON

Bina aliran kerja Bulk untuk sumber ini · Dikaku, lanjutkan dan pulihkan

Muat turun video pukal — kit alat Python

Destinasi Penyimpanan WARGA

Termasuk params.storage Di setiap permintaan unduhan. **Ditetapkan* storage_url Ke dalam ember atau nama kontainermu, dan pengadaan kelayakan dengan akses tulis. Simpan bukti penyimpanan di servermu.

params.storage · S3Tujuan yang tidak kompatibel
{
  "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 default ke YYYYMMDD, diganti dengan tanggal unggahan UTC. Use an fixed directory atau template seperti archive/YYYYMMDD.

s3
Bekalan access_key dan secret_key dengan akses tulis. Wadison Set wilayah ke wilayah AWS ember Anda.
s3 Contoh
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
Bekalan access_key, secret_key dan HTTPS umum endpoint_url. Kelayakan Set wilayah sebagaimana diperlukan oleh penyedia Anda; Cloudflare R2 menggunakan auto.
s3_compatible Contoh
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
Bekalan account_name dan sas_token, sebuah wadah SAS dengan izin penulisan (sp termasuk w), sumber daya sr=c, expiry se, versi sv dan tanda tangan sig. storage_url adalah nama wadah. Jangan kirim endpoint_url, access_key atau secret_key.
azure Contoh
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
Bekalan access_key, secret_key dan wilayah: bj, su atau hkg. Titik akhir lema diambil dari wilayah ketika diabaikan. buldon Gunakan nama ember tanpa titik.
bos Contoh
params.storage · bos
{
  "storage_type": "bos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "bj"
}
cos
Bekalan access_key, secret_key dan wilayah ap-*, seperti ap-hongkong. storage_url harus termasuk akhiran APPID. Jangan sesekali mengirim endpoint_url; ini berasal dari wilayah.
cos Contoh
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
Bekalan service_account dengan project_id, client_email (sebuah alamat .gserviceaccount.com), dan PEM private_key dari akun layanan Anda. Akun itu pasti punya akses untuk menulis ke ember. Jangan kirim access_key, secret_key, wilayah atau endpoint_url.
gcs Contoh
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
Bekalan access_key, secret_key dan wilayah ember umum HTTPS endpoint_url.
oss Contoh
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
Bekalan access_key, secret_key dan wilayah dengan awalan cn-, ap-, eu- atau us-. Titik akhir lema diambil dari wilayah ketika diabaikan. buldon Gunakan nama ember tanpa titik.
tos Contoh
params.storage · tos
{
  "storage_type": "tos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "cn-beijing"
}

Hasil yang dihasilkannya file_url Kekekalan mengidentifikasi sebuah objek di penyimpanan Anda. Objek-objek swasta membutuhkan otorisasi penyedia penyimpanan Anda atau URL yang ditandatangani; kunci FlashData API tidak memberikan akses ke ember Anda.

Untuk penyerahan lengkap, pemungutan suara dan unduh alur kerja, lihat Muaturun audio YouTube ke Amazon S3.

Penyerahan Fail

Pekerjaan itu rel: results default titik akhir untuk arah kembali ke Hasil nirfitch JSON, Bukan unduhan MP4. FlashData mengunggah media yang sebenarnya ke dalam ember atau wadah yang Anda sediakan. Retensi media cambuk mengikuti kebijakan ember Anda; hasil pekerjaan JSON berakhir 24 jam setelah selesai.

results[0].file_url mengidentifikasi objek tersebut tetapi tidak secara otomatis menjadi publik atau ditandatangani URL. Media swasta akses bertransaksi dengan penyimpanan SDK, atau hasilkan URL yang bertanda pendek pada server Anda sendiri. Jangan kirim kunci FlashData API ke penyedia penyimpanan anda.

Dayakan upload_metadata Untuk upload {video_id}_meta.json pendamping dalam awalan yang sama. Lokasi dan checksum muncul di bawah results[0].metadata.

Mode unduhan Browser konsol terpisah. unduhan API Publik tunggakan menggunakan storan anda sendiri; jangan sertakan konsol-sahaja browser_delivery setting.

Pemulihan Galat

MUKA kegagalan atau penyimpanan 403, periksa provider, ember, wilayah, titik akhir dan obyek-tulis ijin. ORANG atau swasta yang tidak dapat dijangkau atau swasta file_url Bukan dengan sendirinya berarti unggahan gagal: periksa objek melalui penyedia penyimpanan anda.

COMVE Sebuah video yang dihapus atau tidak tersedia tidak dapat dipulihkan dengan polling. Untuk format yang tidak tersedia, inspeksi Format metadata, kekangan kualitas relaks atau hapus pemilih lanjutan. Permintaan hanya-Audio diperlukan m4a, mp3 OR atau ORANG opus; permintaan video diperlukan mp4, webm OR atau ORANG mkv.

Jika hasil JSON telah berakhir, pertama cek ember Anda untuk media yang disampaikan. Perpindahan ulangan akan menciptakan unduhan baru dan mungkin menimbulkan muatan lain; ia tidak memulihkan hasil lama JSON.

Untuk autentikasi, keseimbangan, permintaan-format dan tingkat-batas kegagalan, gunakan referensi kesalahan bersama. Pengerahan surat perintah mungkin masih menciptakan pekerjaan; memeriksa pekerjaan yang sudah ada sebelum mencoba lagi.

Ralat dan kod status · Bila hendak mencoba lagi · Batasan kadar laklak

Panduan langkah demi langkah: unduh satu video dan sahkan pengiriman

Harga

RencanaKadar penggunaan terminologiPer GB terkirimLanggananKredit yang disertakan per perioda penagihan
Bayar mengikut penggunaanUSD 0.10Tiada yuran bulananTambah nilai apabila perlu
MicroUSD 0.08USD 49.00 / month1,000 Kerugian (USD 50.00 WOVE API penggunaan ) disertakan
StarterUSD 0.07USD 199.00 / month4,000 Kerugian (USD 200.00 WOVE API penggunaan ) disertakan
ProUSD 0.06USD 499.00 / month10,000 Kerugian (USD 500.00 WOVE API penggunaan ) disertakan
ScaleUSD 0.05USD 999.00 / month20,000 Kerugian (USD 1,000.00 WOVE API penggunaan ) disertakan
BusinessUSD 0.04USD 1,999.00 / month40,000 Kerugian (USD 2,000.00 WOVE API penggunaan ) disertakan

Satu pelan akaun. Kredit dikongsi merentas ketiga-tiga produk. Penggunaan yang diliputi kredit pelan tidak dikenakan caj sekali lagi.

Harga dasar dan batas rencana