Переглянути документацію
Посібники
Виберіть правильний вихід медіа, контроль за тим, що ви завантажуєте, і ввімкніть готову роботу в зручний приватний файл.
На цій сторінці
Почати з чого потрібно завдання
| Ваше завдання | Зареєструватися |
|---|---|
| Summarize сповіщав зміст або побудувати текстовий індекс | Переглянути наявний трафарет першого. Завантажити аудіо тільки тоді, коли ваш робочий процес необхідний сам аудіо, наприклад, окремий мовний крок. |
| Процес мовлення або аудіо | Аудіо-тільки вихідний. Уникайте перенесення відео доріжки, який не використовується. |
| Показати короткий різак | Комплект start_at і end_at. Перевірити, що обидва є в межах продовження відео. |
| Грати або процес відео | MP4 з аудіо та роздільною здатністю, яка підходить до вашої програми; приклад використовує <=720. |
Збережіть вихід, який ви хочете
Виберіть одну вкладку і зберегти весь запит як download-request.json. Зміна video_id для вашого джерела. Накази про подання нижче, ознайомтеся з цим файлом, щоб вибрати аудіо або кліп зміни фактичного запиту.
Повне відео з аудіо, нахоплений на 720p.
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio_video",
"output_format": "mp4",
"video_quality": "<=720"
}
}Аудіофайл для прослуховування або подальшої обробки аудіо.
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio",
"output_format": "mp3"
}
}Мп4 з 00:00:05 до 00:00:10. Використовуйте час, які відповідають вибраному відео.
{
"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"
}
}Перевірити доступ власника та байтове ціноутворення
Використовуйте Bash і jq, а також збережений профіль CLI або FLASHDATA_API_KEY для HTTP. Ключ має містити дозвіл youtube_download. Завантаження потребує доступу власника; тимчасовий пробний доступ його не включає. Приклади CLI використовують профіль за замовчуванням; для іменованого профілю додайте --profile NAME до кожної команди.
| Пожертвувати | Застосувати цей спосіб |
|---|---|
| Орієнтовна вартість | Використовуйте повернутий creditsPerTb і bytesPerUnit з вашим розрахунковим вихідним байтами. За запитом не надається додаткове ціноутворення. |
| Область управління | Виберіть аудіо, кліп або ковпачок для вирішення перед подачею. Застосувати правила оплати праці в додатку. |
| Запис фактичного заряду | Прочитати використання з готової доставки. Прийняття може утримувати кредити до завантажень; поточний баланс не завантажує ковпачок. |
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --jsonВикористовуйте приватний пункт для кожного виходу
Заощаджуйте storage.json в приватному порядку з вашими значеннями призначення. Зберігати його за межі джерела управління. Використовуйте відмінну версію object_prefix для кожної версії video/output; багаторазовий префікс для різних виводів робить записи додатків важче, щоб зекономити.
| Поведінка | Мета |
|---|---|
| FlashData ключ | Завантажте та прочитайте свою роботу та доставку JSON. |
| Зберігання завантажити облікові дані | Написати медіа на призначене відро і префікс. |
| ідентичність зберігання додатків | Читання приватного об’єкта або виходу з авторизованого користувача. |
{
"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.jsonПодати збережений запит один раз
Запустіть одну вкладку після збереження обох файлів. Команда вводить storage.json через stdin і зберігає download-submission.json. Зберігайте цей чек. За допомогою CLI зберігають однаковий хід ID для трейдингу; використовують новий ID тільки для навмисного нового виходу. HTTP Подання не використовують 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
)Важкий перший з CLI
Витратити ok: true і data.dryRun: true. Це перевіряє вхід та доступ до FlashData без подання завдання; це не доводить завантажувальні дані можуть написатися на ваш відро.
(
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
)Очікується існуючої роботи
При отриманні інформації не є медіафайлом. CLI очікується; команда HTTP прочитає статус раз. Повторити читання в термін до завершення або не вдалося. У локальному режимі не скасовує роботу сервера.
(
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
)Читати запис про доставку, потім доступ до ЗМІ
Після завершення, отримайте delivery.json за допомогою того ж шляху, який ви використовували для подачі. У зареєстрованому результаті URL отримує JSON; results[0].file_url визначає медіа у вашому складі. Приватний file_url потребує вашого читання читальної ідентичності або посилання, видане вашим додатком.
(
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
)Перевірити те, що було доставлено
Визначити одне місце розташування файлів, позитивний file_size, MD5 і використання. Запис file_size для поставленого об'єкта; downloaded_bytes - це поле передачі, не заміна для кінцевого заряду у використанні.
(
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
Налаштуйте OBJECT_KEY на доставку медіа ключ від file_url, включаючи його префікс. Використовуйте AWS CLI з доступом для читання, jq та OpenSSL. Це зберігає media.mp4 або media.mp3 відповідно до обраного запиту та перевіряє його розмір і контроль без перезапису існуючого локального файлу.
(
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'
)Відновити від етапу, що не вдалося
| Що відбулося | Попередня дія |
|---|---|
| Запущено термін дії без підтвердженої роботи ID | Ознайомтеся з збереженою CLI та історією запиту. Зареєструватися і не вводити в автоматичне введення. |
| Робота прийнята; час очікування | Читання або відновлення однієї роботи. Не створювати ще одну завантаження для продовження очікування. |
| Не вдалося завантажити | Прочитайте помилки роботи та зафіксуйте налаштування призначення або напишіть доступ до навмисно переробляючи. |
| Медіа читати повернуто 403 | Перевірити наявність дозволу на зберігання або застосувати посилання. FlashData API ключ не розблокує S3. |
| Зареєстрований результат JSON розірваний | Прочитайте кінцеву точку роботи знову, поки результат не зберігався. Зберігайте медіа, дивитесь на життєвий цикл відра. |
flashdata runs show download-001 --jsonПодаруйте свій агент за критеріями виведення та доставки
Використовуйте свій збережений доступ власника та настроюється приватний накопичувач.
Читання download-request.json для відео та виходу; не змінюйте їх мовчно.
Перевірити завантаження цін і наявних кредитів на затверджений бюджет завдань.
Після того, як зберегти run/job ID, потім читати цю роботу для завершення.
Заощаджуйте запис доставки. Перевірити розмір збереженого об'єкта і MD5 перед обробкою.
Повідомляти про розташування об'єкта, вибраний формат, результат перевірки та фактичне використання.
Якщо подання не існує, перевірте збережену роботу; не створюйте доступ до заміни або інший завантажити.
Зберігайте облікові дані, приватні. Поділитися носіями тільки через налаштування доступу програми.