Belgeleri incele
Kılavuzlar
Doğru medya çıktısını seçin, ne indireceğinizi kontrol edin ve tamamlanmış bir işi bir kullanılabilir özel dosyaya dönüştürün.
Bu sayfada
Görevinizin ihtiyaç duyduğu şeyle başlayın
| Amacınız | Kullanım |
|---|---|
| Konuşma içeriği ya da bir metin indeksi oluşturmak | İlk önce mevcut bir transkript okuyun. Sesi sadece iş akışınızın kendi başına ihtiyacı olduğunda, ayrı bir konuşma-rap adım gibi. |
| Konuşma veya seslendirme | Audio-only çıktı. Uygulamanızı takip eden bir video taşımaktan kaçının kullanmaz. |
| Kısa bir alıntı gösterin | start_at ve end_at. Her ikisinin de kaynak videonun süresi içinde olduğunu kontrol edin. |
| Play veya process video | MP4, uygulamanıza uygun bir karar kapla; örneğin <=720. kullanır. |
İstediğiniz çıktıyı kurtar
Bir sekme seçin ve tüm isteği download-request.json olarak kurtarın. video_id'u kaynağınız için değiştirin. Aşağıdaki başvuru komutları bu dosyayı okuyun, bu yüzden ses veya bir klip gerçek isteği değiştirir.
Tam bir video, 720p'te kapıldı.
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio_video",
"output_format": "mp4",
"video_quality": "<=720"
}
}Daha fazla ses işleme için bir ses dosyası.
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio",
"output_format": "mp3"
}
}00:00:05'dan 00:00:10'ye bir MP4 alıntı. Seçilmiş videonuzu eşleşen zamanları kullanın.
{
"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"
}
}Check owner access and byte-based pricing
Bash ve jq, artı bir CLI profili veya FLASHDATA_API_KEY için HTTP. Anahtar youtube_download iznine ihtiyaç duyar. İndirme sahibinin erişimi gerektirir; geçici deneme erişimi buna dahil değildir. CLI örnekleri varsayılan profilinizi kullanır; --profile NAME'i her komuta eklerseniz.
| Karar Karar Kararı | Bu şekilde uygulayın |
|---|---|
| Tahmin maliyeti | creditsPerTb ve bytesPerUnit'u tahmin edilen çıktınızla kullanın. İndirme fiyatı talep başına sabit bir ücret değildir. |
| Kontrol kapsamı | Sunumdan önce bir klip veya bir karar kapağı seçin. Uygulamanızda iş hesabı uygulayın ve kurallar harcıyorsunuz. |
| Gerçek şarjı kaydetmek | Tamamlanan teslimattan kullanım okuyun. Kabul, yükleme yerleşmelerinden önce kredi tutabilir; mevcut denge bir per-job harcama kapağı değildir. |
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --jsonHer çıktı için özel bir hedef kullanın
storage.json'u özel olarak gerçek varış değerlerinizle kurtarın. Dış kaynak kontrolü dışında tutun. Her video/output versiyonu için ayrı bir object_prefix sürümünü kullanın; farklı çıktılar için bir ön eki tekrar kullanarak uygulama kayıtlarını uzlaştırmayı daha zor hale getirir.
| Credential | Amaç |
|---|---|
| FlashData anahtarı | İndirmeyi gönderin ve işini okuyun ve JSON'u teslim edin. |
| Storageload credential | Amaçlı kovaya ve ekine medya yazın. |
| Uygulama depolama kimliği | Özel nesneyi okuyun veya yetkili bir kullanıcıya erişim. |
{
"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.jsonKurtarılan talebi bir kez gönderin
İki dosyayı da kaydettikten sonra sekmelerden birini çalıştırın. Komut storage.json dosyasını stdin üzerinden iletir ve download-submission.json kaydını oluşturur. Bu kaydı saklayın. CLI ile yeniden denerken aynı çalıştırma ID değerini kullanın; yeni ID yalnızca bilinçli olarak yeni çıktı istediğinizde kullanılmalıdır. HTTP gönderimleri CLI uygulamasının yerel çalıştırma günlüğünü kullanmaz.
(
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
)İlk önce CLI ile geçerlidir
ok: true ve data.dryRun: true'u bekleyin. Bu giriş ve FlashData bir iş sunmadan erişir; yükleme kimliklerinin sizin kovanıza yazabileceğini kanıtlayamaz.
(
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
)Mevcut iş için bekleyin
Başvuru makbuzu medya dosyası değildir. CLI bekler; HTTP komut bir kez durumu okur. Tamamlanan veya başarısız olana kadar son zamanlarda okumayı tekrarlayın. Yerel bir süre sunucu işini iptal etmiyor.
(
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
)Teslimat kayıtlarını okuyun, sonra medyaya erişim
Tamamlandıktan sonra, delivery.json'yu göndermek için kullandığınız aynı yolu kullanın. İmzalanan sonuç URL, JSON; results[0].file_url, sizin depolamanızda medyayı tanımlar. Özel bir file_url, depolamanızın kimlik veya uygulamanız tarafından yayınlanan bir bağlantıya ihtiyaç duyar.
(
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
)Ne teslim edildiğini kontrol edin
Bir dosya yerini bekle, olumlu file_size, an MD5 ve kullanımı. Record Record Record file_size teslim edilen nesne için; downloaded_bytes Bir transfer alanı, kullanımdaki son ücret için bir yedek değil.
(
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
)S3'dan yerel bir kopyasını doğrulayın
Set Set Set OBJECT_KEY Gönderilen medya anahtarı file_urlAyrıca, ön eki de dahil. AWS CLI'u okuma erişimi ile kullanın, jq ve OpenSSL. Bu, media.mp4 veya media.mp3'u seçtiğiniz isteke göre kurtarır ve mevcut yerel bir dosya yazmadan boyutlarını kontrol eder.
(
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'
)Başarısız olan sahneden yeniden keşfedin
| Ne oldu? | Sonraki eylem |
|---|---|
| Tamamlanmamış iş ID ile test süresi | kaydedilen CLI koşmak veya tarih talep etmek. Orijinal girişi tutun ve otomatik olarak tekrar göndermeyin. |
| İş kabul etti; zamanı bekleme | Aynı işi okuyun ya da kurtarın. Beklemeye devam etmek için başka bir indirme oluşturmayın. |
| Kod başarısız oldu | İş hatasını okuyun ve varış yerlerini düzeltin veya kasıtlı olarak yeniden denemeden önce erişim yaz. |
| Media read döndü 403 | Kontrol depolama izinleri veya uygulama-konuşuş bağlantısını okuyun. FlashData API anahtarı S3'u açmaz. |
| Sonuç olarak JSON sona ermiştir | İş sonucu endpointi tekrar okuyun, sonuç korunurken. Mağazalı medya, kovanızın yaşam döngüsünü takip eder. |
flashdata runs show download-001 --jsonAjanınıza çıktı ve teslimat kriterlerini verin
Kurtarılan sahibinin erişimini kullanın ve özel depolama yapılandırın.
Video ve çıktı için download-request.json'u okuyun; onları sessizce değiştirmez.
Onaylanan görev bütçesine karşı fiyat ve mevcut kredileri kontrol edin.
Bir kez gönderin, run/job ID'u kurtar, sonra bu işi tamamlamak için okuyun.
Teslimat kayıtlarını kurtarın. Depolama nesnesinin boyutunu ve MD5'yu işlemeden önce doğrulayın.
object location, seçilmiş format, doğrulama sonucu ve gerçek kullanımı rapor edin.
Eğer teslim belirsiz ise, denetim kurtarılmış iş; yedek erişim veya başka bir indirme yaratmaz.
Depolama bilgilerini özel tut. Medyayı sadece uygulamanın yapılandırılmış erişim kontrolleri aracılığıyla paylaşın.