Przeglądaj dokumentację
Poradniki
Wybierz odpowiednie wyjście multimedialne, kontroluj co pobierasz i zamień ukończone zadanie w użyteczny plik prywatny.
Na tej stronie
Zacznij od tego, czego potrzebuje Twoje zadanie
| Twój cel | Stosowanie |
|---|---|
| Podsumowanie treści mówionej lub utworzenie indeksu tekstowego | Najpierw przeczytaj istniejący transkrypt. Pobierz dźwięk tylko wtedy, gdy Twój przepływ pracy wymaga samego dźwięku, takie jak oddzielny krok przemówień- to- tekst. |
| Przemowa procesowa lub audio | Wyjście tylko dla audio. Unikaj posiadania ścieżki wideo, której nie używa aplikacja. |
| Pokaż krótki fragment | Ustaw start_at i end_at. Sprawdź, czy oba są w czasie trwania nagrania. |
| Odtwarzanie lub przetwarzanie wideo | MP4 z dźwiękiem i kapslem rozdzielczości dopasowanym do Twojej aplikacji; przykład wykorzystuje <=720. |
Zapisz wyjście, które chcesz
Wybierz jedną kartę i zapisz jej całe żądanie jako download-request.json. Zmień video_id dla swojego źródła. Polecenia przekazania poniżej przeczytaj ten plik, więc wybór audio lub klip zmienia rzeczywiste żądanie.
Kompletny film z audio, w rozdzielczości 720p.
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio_video",
"output_format": "mp4",
"video_quality": "<=720"
}
}Plik audio do słuchania lub dalszego przetwarzania dźwięku.
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio",
"output_format": "mp3"
}
}Fragment MP4 z 00:00:05 do 00:00:10. Użyj razy, które pasują do wybranego filmu.
{
"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"
}
}Sprawdź dostęp właściciela i ceny bajtowe
Należy użyć Bash i jq oraz zapisanego profilu CLI lub FLASHDATA_API_KEY dla HTTP. Klucz wymaga zezwolenia youtube_download. Pobieranie wymaga dostępu właściciela; czasowy dostęp próbny nie obejmuje go. Przykłady CLI używają domyślnego profilu; dodaj --profile NAME do każdego polecenia, jeśli Twoje jest nazwane.
| Decyzja | Zastosuj to w ten sposób |
|---|---|
| Szacunkowy koszt | Użyj zwróconego creditsPerTb i bytesPerUnit z szacowanymi bajtami wyjściowymi. Cena pobierana nie jest stałą opłatą za każde żądanie. |
| Zakres kontroli | Przed złożeniem należy wybrać dźwięk, klip lub nasadkę rozdzielczości. Zastosuj zasady liczenia pracy i wydatków w aplikacji. |
| Zapis rzeczywistej opłaty | Przeczytaj użycie z zakończonej dostawy. Wstęp może zawierać kredyty przed ustawieniem wysyłania; saldo bieżące nie jest pułapem wydatków na pracę. |
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --jsonUżyj prywatnego celu dla każdego wyjścia
Zapisz storage.json prywatnie z prawdziwymi wartościami docelowymi. Trzymaj to poza kontrolą źródła. Użyj odrębnego object_prefix dla każdej wersji video/output; ponowne użycie przedrostka dla różnych wyjść sprawia, że rekordy aplikacji trudniej pogodzić.
| Kredytowe | Cel |
|---|---|
| Klawisz FlashData | Prześlij pobranie i przeczytaj jego zadanie i dostawy JSON. |
| Przechowywanie wysyłania uwierzytelniającego | Napisz media do zamierzonego wiadra i przedrostka. |
| Identyfikacja wniosku o przechowywanie | Odczytaj obiekt prywatny lub wydaj dostęp do autoryzowanego użytkownika. |
{
"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.jsonPrześlij raz zapisane żądanie
Uruchom jedną kartę po zapisaniu obu plików. Polecenie wstrzykuje storage.json przez stdin i zapisuje download-submission.json. Zatrzymaj ten paragon. Z CLI, zachować ten sam bieg ID dla ponownego wypróbowania; używać nowego ID tylko dla zamierzonego nowego wyjścia. Zgłoszenia HTTP nie korzystają z lokalnego dziennika przebiegu 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
)Zatwierdzenie najpierw za pomocą CLI
Oczekuj ok: true i data.dryRun: true. Sprawdza to wejście i dostęp do FlashData bez składania pracy; nie dowodzi, że dane uwierzytelniające mogą pisać do Twojego wiadra.
(
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
)Czekaj na istniejącą pracę
Poświadczenie złożenia nie jest plikiem medialnym. CLI czeka; komenda HTTP odczytuje status raz. Odczyt należy powtórzyć w terminie do zakończenia lub niepowodzenia. Lokalny timeout nie anuluje zadania serwera.
(
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
)Przeczytaj zapis dostawy, a następnie uzyskać dostęp do mediów
Po zakończeniu pobrać delivery.json przy użyciu tej samej ścieżki, którą składałeś. Podpisany wynik URL pobiera JSON; wyniki [0] .file_url identyfikuje nośniki w Twoim magazynie. Prywatny file_url potrzebuje Twojej tożsamości odczytu z pamięci lub odnośnika wydanego przez Twoją aplikację.
(
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
)Sprawdź, co dostarczono
Oczekuj lokalizacji jednego pliku, pozytywnego file_size, MD5 i wykorzystania. Zapis file_size dla dostarczonego obiektu; downloaded_bytes to pole transferowe, a nie zamiennik opłaty końcowej w użyciu.
(
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
)Weryfikacja lokalnej kopii z S3
Ustaw OBJECT_KEY na dostarczony klucz medialny z file_url, w tym przedrostek. Użyj AWS CLI z dostępem do odczytu, jq i OpenSSL. To zapisuje media.mp4 lub media.mp3 zgodnie z wybranym żądaniem i sprawdza jego rozmiar i sumę kontrolną bez nadpisywania istniejącego pliku lokalnego.
(
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'
)Odzyskanie ze sceny, która zawiodła
| Co się stało? | Następna akcja |
|---|---|
| Złożenie w czasie bez potwierdzonej pracy ID | Sprawdź zapisany bieg CLI lub historię żądania. Zachowaj oryginalne dane wejściowe i nie poddawaj się automatycznie. |
| Zaakceptowana praca; czas oczekiwania | Odczyt lub odzyskanie tej samej pracy. Nie tworzyć kolejnego pobierania, aby kontynuować czekanie. |
| Wysyłanie nie powiodło się | Odczytaj błąd zadania i ustaw ustawienia docelowe lub pisz dostęp przed umyślnym ponownym uruchomieniem. |
| Media odczyt zwrócony 403 | Sprawdź uprawnienia do odczytu pamięci masowej lub link do aplikacji. Klucz FlashData API nie odblokowuje S3. |
| Podpisany wynik JSON wygasł | Przeczytaj ponownie punkt końcowy wyniku pracy, podczas gdy wynik jest zachowany. Magazynowane media podążają za cyklem życia twojego wiadra. |
flashdata runs show download-001 --jsonPodaj swojemu agentowi kryteria produkcji i dostawy
Użyj mojego zapisanego dostępu właściciela i skonfigurowanego prywatnego przechowywania.
Przeczytaj download-request.json dla wideo i wyjścia; nie zmieniaj ich po cichu.
Sprawdź ceny pobierania i dostępne kredyty z zatwierdzonym budżetem zadań.
Prześlij raz, zapisz run/job ID, a następnie przeczytaj to zadanie do końca.
Zachowaj zapis dostawy. Weryfikuje rozmiar zapisanego obiektu i MD5 przed jego przetwarzaniem.
Zgłoś lokalizację obiektu, wybrany format, wynik weryfikacji i rzeczywiste wykorzystanie.
Jeśli złożenie jest niepewne, sprawdź zapisaną pracę; nie tworzyć dostępu zastępczego lub innego pobierania.
Zachowaj prywatne dokumenty. Udostępnianie mediów tylko za pomocą skonfigurowanych kontroli dostępu aplikacji.