Jelajahi dokumentasi
Panduan
Pilih keluaran media yang tepat, kontrol apa yang Anda unduh, dan ubah pekerjaan selesai menjadi berkas privat yang dapat dipakai.
Di halaman ini
Mulai dengan apa yang Anda butuhkan tugas
| Tujuanmu | Gunakan |
|---|---|
| Ringkasan isi yang diucapkan atau buat indeks teks | Baca transkrip yang sudah ada dulu. Unduh audio hanya ketika memutar aliran kerja Anda memerlukan audio itu sendiri, seperti langkah cepat -to- teks yang terpisah. |
| Pidato proses atau audio | Audio- hanya keluaran. Hindari membawa trek video aplikasi Anda tidak digunakan. |
| Tampilkan suatu kutipan singkat | Set start_at dan end_at. Periksa bahwa keduanya berada dalam durasi video sumber. |
| Putar atau proses video | MP4 dengan audio dan sebuah topi resolusi cocok dengan aplikasi Anda; contoh yang digunakan <=720. |
Simpan keluaran yang Anda inginkan
Pilih satu tab dan simpan seluruh permintaannya sebagai download-request.json. Ubah video_id untuk sumber Anda. Perintah pengiriman di bawah ini membaca berkas ini, jadi memilih audio atau klip mengubah permintaan yang sebenarnya.
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 pemrosesan 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. Gunakan waktu yang cocok dengan video yang Anda pilih.
{
"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 nilai berdasarkan
Gunakan Bash dan jq, ditambah sebuah profil CLI yang disimpan atau FLASHDATA_API_KEY untuk HTTP. Kunci membutuhkan izin youtube_download. Unduh membutuhkan akses pemilik; akses percobaan sementara tidak termasuk itu. CLI contoh menggunakan profil baku Anda; tambahkan --profile NAMA ke setiap perintah jika nama Anda bernama.
| Keputusan | Terapkan dengan cara ini |
|---|---|
| Perkiraan biaya | Gunakan creditsPerTb yang dikembalikan dan bytesPerUnit dengan perkiraan byte keluaran Anda. Unduh harga bukanlah biaya tetap per permintaan. |
| Lingkup kontrol | Pilih audio, klip atau topi resolusi sebelum pengiriman. Terapkan pekerjaan - jumlah dan pengeluaran aturan dalam aplikasi Anda. |
| Rekam muatan yang sebenarnya | Baca penggunaan dari pengiriman selesai. Penerimaan dapat menyimpan kredit sebelum upload mengendap; saldo saat ini bukan tutup pengeluaran perjob. |
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --jsonGunakan tujuan privat untuk setiap keluaran
Simpan storage.json secara pribadi dengan nilai tujuan sebenarnya Anda. Tetap di luar kontrol sumber. Gunakan object_prefix yang berbeda untuk setiap versi video/output; menggunakan awalan untuk keluaran berbeda membuat catatan aplikasi lebih sulit untuk mendamaikan.
| Kredensial | Tujuan |
|---|---|
| kunci FlashData | Kirim download dan membaca pekerjaannya dan pengiriman JSON. |
| Penyimpanan upload kredensial | Tulis media ke ember dan awalan yang diinginkan. |
| Identitas penyimpanan aplikasi | Baca objek privat atau keluarkan akses 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.jsonAjukan permintaan yang disimpan sekali
Jalankan satu tab setelah menyimpan kedua berkas. Perintah disuntik storage.json melalui stdin dan menyimpan download-submission.json. Simpan tanda terima ini. Dengan CLI, pertahankan run yang sama ID untuk percobaan ulang; gunakan ID baru hanya untuk output baru yang disengaja. Pengiriman HTTP tidak menggunakan jurnal 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
)Validasi pertama dengan CLI
Diharapkan ok: true dan data.dryRun: true. Ini memeriksa masukan dan FlashData akses tanpa mengirimkan pekerjaan; ini tidak membuktikan bahwa upload kredensial 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
Tanda terima pengiriman bukan berkas media. CLI menunggu, perintah HTTP membaca status sekali. Ulangi dalam tenggat waktu anda sampai selesai atau gagal. Tenggat lokal tidak membatalkan tugas 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, kemudian akses media
Setelah selesai, mengambil delivery.json menggunakan jalur yang sama yang Anda gunakan untuk mengirimkan. Hasil ditandatangani URL mengambil JSON; hasil [0] .file_url mengidentifikasi media di penyimpanan Anda. Seorang pribadi file_url membutuhkan identitas pembacaan penyimpanan anda atau sebuah 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 dikirimkan
Mengharapkan satu lokasi berkas, positif file_size, sebuah MD5 dan penggunaan. Rekam file_size untuk objek yang disampaikan; downloaded_bytes adalah bidang transfer, bukan pengganti untuk muatan 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
)Verifikasi salinan lokal dari S3
Set OBJECT_KEY ke kunci media yang disampaikan dari file_url, termasuk prefix. Gunakan AWS CLI dengan akses baca, jq dan OpenSSL. Ini menyimpan media.mp4 atau media.mp3 sesuai dengan permintaan yang Anda pilih dan memeriksa ukurannya 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'
)Kembali dari tahap yang gagal
| Apa yang terjadi? | Aksi berikutnya |
|---|---|
| Submission timeout dengan tidak ada pekerjaan dikonfirmasi ID | Inspeksi yang disimpan CLI jalankan atau riwayat permintaan. Pertahankan input asli dan jangan secara otomatis mengirimkan lagi. |
| Tugas diterima; menunggu timeout | Baca atau ambil pekerjaan yang sama. Jangan buat download lain untuk melanjutkan menunggu. |
| Pengunggah gagal | Baca kesalahan pekerjaan dan perbaiki pengaturan tujuan atau tulis akses sebelum secara sengaja mencoba kembali. |
| Pembacaan media mengembalikan 403 | Periksa izin baca penyimpanan atau aplikasi-diterbitkan link. Kunci FlashData API tidak membuka kunci S3. |
| Hasil tertanda JSON kadaluarsa | Baca akhir pekerjaan lagi sementara hasilnya dipertahankan. Media yang tersimpan mengikuti tulang hidupmu. |
flashdata runs show download-001 --jsonBerikan kriteria output dan pengiriman agenmu
Gunakan akses pemilik yang tersimpan dan konfigurasi penyimpanan pribadi.
Baca download-request.json untuk video dan keluaran; jangan ubah diam-diam.
Periksa nilai unduhan dan kredit yang tersedia terhadap anggaran tugas yang disetujui.
Kirim sekali, menyimpan run/job ID, kemudian membaca bahwa pekerjaan untuk menyelesaikan.
Simpan catatan pengirimannya. Verifikasi ukuran objek yang disimpan dan MD5 sebelum memprosesnya.
Laporkan lokasi objek, format yang dipilih, hasil verifikasi dan penggunaan aktual.
Bila penyerahan tidak pasti, pemeriksaan disimpan; jangan membuat akses pengganti atau download lain.
Simpan mandat penyimpanan pribadi. Berbagi media hanya melalui aplikasi yang dikonfigurasi kontrol akses.