Semak dokumentasi
Panduan
Pilih output media yang tepat, kendalikan apa yang Anda muat turun, dan ubah pekerjaan selesai menjadi berkas pribadi yang dapat digunakan.
Pada halaman ini
Mulailah dengan apa yang dibutuhkan tugasmu
| Tujuanmu | Guna |
|---|---|
| Takwid Summarize content yang diucapkan atau build a text indeks | Baca transkrip yang sudah ada terlebih dahulu. Unduh audio hanya ketika alur kerja Anda membutuhkan audio itu sendiri, seperti langkah berbicara-ke-teks yang terpisah. |
| Proses process wicara atau audio | Keluaran hanya-Audio. Hindari membawa video trek aplikasi Anda tidak digunakan. |
| Tunjukkan kutipan singkat | start_at dan end_at. Periksa bahwa keduanya berada dalam durasi video sumber. |
| Mainkan atau proses video | UM4 dengan audio dan topi resolusi sesuai dengan aplikasi Anda; contoh menggunakan <=720. |
Simpan output yang kau inginkan
Pilih satu tab dan simpan seluruh permintaannya sebagai download-request.json. XAvideo_id untuk sumbermu. Perintah penyerahan di bawah membaca berkas ini, sehingga memilih audio atau klip mengubah permintaan yang sebenarnya.
Sebuah video lengkap dengan audio, ditutup pada 720p.
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio_video",
"output_format": "mp4",
"video_quality": "<=720"
}
}Berkas audio untuk mendengarkan atau memproses audio lebih lanjut.
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio",
"output_format": "mp3"
}
}Sebuah kutipan MP4 dari 00:00:05 ke 00:00:10. Guna waktu yang cocok dengan video pilihanmu.
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio_video",
"output_format": "mp4",
"video_quality": "<=720",
"start_at": "00:00:05",
"end_at": "00:00:10"
}
}Periksa akses pemilik dan pengaturan berbasis byte
Use Bash dan jq, ditambah CLI yang disimpan profil atau FLASHDATA_API_KEY untuk HTTP. Kuncinya perlu izin youtube_download. Unduhan COMUD membutuhkan akses pemilik; akses pengadilan sementara tidak termasuk. Contoh CLI menggunakan profil default anda; tambahkan NAMA --profile ke setiap perintah jika anda bernama.
| Keputusan | Terapkan dengan cara ini |
|---|---|
| Biaya estimasi biaya biaya | Anda menggunakan creditsPerTb dan bytesPerUnit yang dikembalikan dengan perkiraan byte output. Pengenaan unduhan bukan biaya tetap per permintaan. |
| Skop pengendalian Skop Skop SCOG | Pilih audio, klip atau topi resolusi sebelum penyerahan. Terapkan pekerjaan-count dan menghabiskan aturan dalam aplikasi Anda. |
| Rekam muatan yang sebenarnya | Penggunaan bacaan dari pengiriman yang telah selesai. Kecanduan KANTOR dapat memegang kredit sebelum unggah selesai; saldo saat ini bukan tutup pengeluaran per-tugas. |
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --jsonUse sebuah destinasi privat untuk setiap keluaran
Simpan storage.json secara pribadi dengan nilai tujuan nyata Anda. Tetap di luar kendali sumber. Diafine menggunakan object_prefix yang berbeda untuk setiap versi video/output; menggunakan awalan untuk keluaran yang berbeda membuat catatan aplikasi lebih sulit untuk didamaikan.
| Bukti Bukti Bukti Kelayakan | Tujuan |
|---|---|
| Kunci FlashData | Ia mengirimkan JSON. |
| upload kredensial penyimpanan | Writing media ke baldi yang ditujukan dan awalan. |
| Identitas penyimpanan aplikasi | ¡Objek pribadi atau akses sengketa ke pengguna yang berwenang. |
{
"storage_type": "s3",
"storage_url": "YOUR_BUCKET",
"access_key": "YOUR_ACCESS_KEY",
"secret_key": "YOUR_SECRET_KEY",
"region": "us-east-1",
"object_prefix": "media/video-001/mp4-720p-v1"
}chmod 600 storage.jsonSerahkan permintaan yang disimpan sekali
Jalankan satu tab setelah menyimpan kedua berkas. Perintah command injects storage.json melalui stdin dan menyimpan download-submission.json. Habel menyimpan penerimaan ini. Dengan CLI, mempertahankan menjalankan ID yang sama untuk mencoba lagi; menggunakan ID baru hanya untuk keluaran baru yang disengaja. Pengiriman HTTP tidak menggunakan jurnal run lokal CLI.
(
set -eu
umask 077
test ! -e download-submission.json || { echo 'Inspect the saved submission first.' >&2; exit 1; }
PAYLOAD=$(jq -en --slurpfile request download-request.json --slurpfile storage storage.json '
if ($request | length) != 1 or ($storage | length) != 1
or ($storage[0] | type) != "object" or $request[0].source != "youtube_download"
then error("Check download-request.json and storage.json")
else $request[0] | .params.storage = $storage[0] end')
printf '%s' "$PAYLOAD" | flashdata query --input - --mode async \
--run-id download-001 --output download-submission.json
)(
set -eu
umask 077
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
test ! -e download-submission.json || { echo 'Inspect the saved submission first.' >&2; exit 1; }
PAYLOAD=$(jq -en --slurpfile request download-request.json --slurpfile storage storage.json '
if ($request | length) != 1 or ($storage | length) != 1
or ($storage[0] | type) != "object" or $request[0].source != "youtube_download"
then error("Check download-request.json and storage.json")
else $request[0] | .params.storage = $storage[0] end')
printf '%s' "$PAYLOAD" | curl --fail-with-body --silent --show-error --max-time 70 \
--request POST 'https://data.flashdata.dev/v1/queries' \
--header "X-API-Key: $FLASHDATA_API_KEY" --header 'Content-Type: application/json' \
--data-binary @- --output download-submission.json
)Kesahihan pertama dengan CLI
ok: true dan data.dryRun: true. Ini memeriksa input dan akses FlashData tanpa mengirimkan pekerjaan; itu tidak membuktikan kelayakan muat naik dapat menulis ke ember Anda.
(
set -eu
PAYLOAD=$(jq -en --slurpfile request download-request.json --slurpfile storage storage.json '
if ($request | length) != 1 or ($storage | length) != 1
or ($storage[0] | type) != "object" or $request[0].source != "youtube_download"
then error("Check download-request.json and storage.json")
else $request[0] | .params.storage = $storage[0] end')
printf '%s' "$PAYLOAD" | flashdata query --input - --mode async --dry-run --json
)Tunggu pekerjaan yang sudah ada
Penerimaan penyerahan Haqq bukanlah berkas media. Perintah CLI menunggu; perintah HTTP membaca status sekali. Mengulangi bacaan dalam tenggat waktu Anda sampai selesai atau gagal. KELUARANGAN lokal tidak membatalkan pekerjaan server.
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs wait "$JOB_ID"
)(
set -eu
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
STATUS_URL=$(jq -er '.links[] | select(.rel == "self") | .href' download-submission.json)
curl --fail-with-body --silent --show-error --max-time 30 \
--header "X-API-Key: $FLASHDATA_API_KEY" --header 'Accept: application/json' \
"$STATUS_URL" --output job.json
jq '.job | {id, status, error}' job.json
)Baca catatan pengiriman, lalu akses media
Setelah selesai, ambil kembali delivery.json menggunakan jalur yang sama yang digunakan untuk mengirimkan. Hasil yang ditandatangani URL memperoleh JSON; hasil[0].file_url mengidentifikasi media dalam penyimpanan Anda. Sebuah file_url pribadi membutuhkan identitas baca penyimpanan Anda atau link yang dikeluarkan oleh aplikasi Anda.
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs result "$JOB_ID" --output delivery.json
jq '.results[0] | {file_url, file_size, md5, downloaded_bytes}' delivery.json
)(
set -eu
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
jq -e '.job.status == "completed"' job.json >/dev/null
RESULTS_URL=$(jq -er '.links[] | select(.rel == "results") | .href' download-submission.json)
# Get the signed JSON URL without forwarding the API key to storage.
STORAGE_URL=$(curl --fail-with-body --silent --show-error --max-time 30 \
--header "X-API-Key: $FLASHDATA_API_KEY" --header 'Accept: application/json' \
--output /dev/null --write-out '%{redirect_url}' "$RESULTS_URL")
: "${STORAGE_URL:?No signed result URL was returned}"
curl --fail-with-body --silent --show-error --compressed --max-time 70 \
"$STORAGE_URL" --output delivery.json
jq '.results[0] | {file_url, file_size, md5, downloaded_bytes}' delivery.json
)Periksa apa yang telah disampaikan
Expect satu lokasi berkas, positif file_size, sebuah MD5 dan penggunaan. Catatan file_size untuk objek yang disampaikan; downloaded_bytes adalah medan transfer, bukan pengganti untuk biaya akhir dalam penggunaan.
(
set -eu
jq -e '.source == "youtube_download" and .status == "done"
and (.results | length == 1) and (.results[0].file_size > 0)
and (.results[0].md5 | test("^[a-fA-F0-9]{32}$"))' delivery.json >/dev/null
jq '{file: (.results[0] | {file_url, file_size, md5, duration, output_format}), usage}' delivery.json
)Sahkan sebuah salinan lokal dari S3
OBJECT_KEY ke kunci media yang disampaikan dari file_url, termasuk prefiksnya. AWS Gunakan CLI dengan akses baca, jq dan OpenSSL. Ini menyimpan media.mp4 atau media.mp3 sesuai permintaan yang Anda pilih dan memeriksa ukuran dan checksum tanpa menimpa berkas lokal yang ada.
(
set -eu
# Requires AWS CLI configured for read access, jq and OpenSSL.
# Set OBJECT_KEY to the delivered media object's key from file_url.
: "${OBJECT_KEY:?Set the delivered S3 object key}"
BUCKET=$(jq -er '.storage_url' storage.json)
REGION=$(jq -er '.region' storage.json)
FORMAT=$(jq -er '.params.output_format' download-request.json)
case "$FORMAT" in mp4|mp3) ;; *) echo 'Choose a filename for this format.' >&2; exit 1 ;; esac
LOCAL_FILE="media.$FORMAT"
test ! -e "$LOCAL_FILE" || { echo 'Keep the existing local file.' >&2; exit 1; }
EXPECTED_BYTES=$(jq -er '.results[0].file_size' delivery.json)
EXPECTED_MD5=$(jq -er '.results[0].md5 | ascii_downcase' delivery.json)
aws s3 cp "s3://$BUCKET/$OBJECT_KEY" "$LOCAL_FILE" --region "$REGION" --only-show-errors
ACTUAL_BYTES=$(wc -c < "$LOCAL_FILE" | tr -d '[:space:]')
ACTUAL_MD5=$(openssl dgst -md5 "$LOCAL_FILE" | awk '{print $NF}')
test "$ACTUAL_BYTES" = "$EXPECTED_BYTES"
test "$ACTUAL_MD5" = "$EXPECTED_MD5"
echo 'Delivery verified'
)Pemulihan dari panggung yang gagal
| Apa yang terjadi? | Tindakan berikutnya |
|---|---|
| Submisi berakhir tanpa konfirmasi pekerjaan ID | Periksalah CLI yang disimpan atau sejarah permintaan. Tetap masukan asli dan jangan otomatis menyerahkan lagi. |
| Tugas diterima; menunggu waktu habis | Baca atau pulihkan pekerjaan yang sama. Jangan membuat unduhan lain untuk terus menunggu. |
| Gagal memuat-naik | Membaca kesalahan kerja dan memperbaiki pengaturan tujuan atau akses tulis sebelum mencoba lagi secara sengaja. |
| Media baca dikembalikan 403 | Periksa izin baca penyimpanan atau link terisuasi aplikasi. Kunci FlashData API tidak membuka kunci S3. |
| Hasil signed JSON berakhir | Bacalah hasil pekerjaan titik akhir lagi sementara hasilnya tetap dipertahankan. Media penyimpanan baldi mengikuti daur hidup ember Anda. |
flashdata runs show download-001 --jsonBerikan agenmu kriteria output dan pengiriman
Aku menggunakan akses pemilik yang telah kusimpan dan penyimpanan pribadi yang telah dikonfigurasi.
Baca download-request.json untuk video dan output; jangan ubah mereka diam-diam.
Voked Check Download menetapkan harga dan kredit yang tersedia terhadap anggaran tugas yang disetujui.
Serahkan sekali, simpan run/job ID, kemudian baca pekerjaan itu untuk diselesaikan.
Simpan catatan pengirimannya. Sahkan ukuran objek tersimpan dan MD5 sebelum memprosesnya.
WANITA Melaporkan lokasi objek, format yang dipilih, hasil verifikasi dan penggunaan yang sebenarnya.
Jika penyerahan tidak pasti, inspeksi pekerjaan yang disimpan; jangan membuat akses penggantian atau unduhan lain.
Simpan bukti penyimpanan pribadi. Kongsi media hanya melalui kontrol akses yang telah dikonfigurasi oleh aplikasi.