Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Посібники

YouTube Download кращих практик

Виберіть правильний вихід медіа, контроль за тим, що ви завантажуєте, і ввімкніть готову роботу в зручний приватний файл.

На цій сторінці

Почати з чого потрібно завдання

Ваше завданняЗареєструватися
Summarize сповіщав зміст або побудувати текстовий індексПереглянути наявний трафарет першого. Завантажити аудіо тільки тоді, коли ваш робочий процес необхідний сам аудіо, наприклад, окремий мовний крок.
Процес мовлення або аудіоАудіо-тільки вихідний. Уникайте перенесення відео доріжки, який не використовується.
Показати короткий різакКомплект start_at і end_at. Перевірити, що обидва є в межах продовження відео.
Грати або процес відеоMP4 з аудіо та роздільною здатністю, яка підходить до вашої програми; приклад використовує <=720.

Збережіть вихід, який ви хочете

Виберіть одну вкладку і зберегти весь запит як download-request.json. Зміна video_id для вашого джерела. Накази про подання нижче, ознайомтеся з цим файлом, щоб вибрати аудіо або кліп зміни фактичного запиту.

Повне відео з аудіо, нахоплений на 720p.

download-request.json
{
  "source": "youtube_download",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "download_type": "audio_video",
    "output_format": "mp4",
    "video_quality": "<=720"
  }
}

Перевірити доступ власника та байтове ціноутворення

Використовуйте Bash і jq, а також збережений профіль CLI або FLASHDATA_API_KEY для HTTP. Ключ має містити дозвіл youtube_download. Завантаження потребує доступу власника; тимчасовий пробний доступ його не включає. Приклади CLI використовують профіль за замовчуванням; для іменованого профілю додайте --profile NAME до кожної команди.

ПожертвуватиЗастосувати цей спосіб
Орієнтовна вартістьВикористовуйте повернутий creditsPerTb і bytesPerUnit з вашим розрахунковим вихідним байтами. За запитом не надається додаткове ціноутворення.
Область управлінняВиберіть аудіо, кліп або ковпачок для вирішення перед подачею. Застосувати правила оплати праці в додатку.
Запис фактичного зарядуПрочитати використання з готової доставки. Прийняття може утримувати кредити до завантажень; поточний баланс не завантажує ковпачок.
Безкоштовні перевірки · CLI
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --json

Використовуйте приватний пункт для кожного виходу

Заощаджуйте storage.json в приватному порядку з вашими значеннями призначення. Зберігати його за межі джерела управління. Використовуйте відмінну версію object_prefix для кожної версії video/output; багаторазовий префікс для різних виводів робить записи додатків важче, щоб зекономити.

ПоведінкаМета
FlashData ключЗавантажте та прочитайте свою роботу та доставку JSON.
Зберігання завантажити облікові даніНаписати медіа на призначене відро і префікс.
ідентичність зберігання додатківЧитання приватного об’єкта або виходу з авторизованого користувача.
storage.json · S3
{
  "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"
}
Linux / macOS · приватний файл
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
)

Важкий перший з 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"
)

Читати запис про доставку, потім доступ до ЗМІ

Після завершення, отримайте delivery.json за допомогою того ж шляху, який ви використовували для подачі. У зареєстрованому результаті URL отримує JSON; results[0].file_url визначає медіа у вашому складі. Приватний file_url потребує вашого читання читальної ідентичності або посилання, видане вашим додатком.

Зберегти delivery.json
(
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
)

Перевірити те, що було доставлено

Визначити одне місце розташування файлів, позитивний file_size, MD5 і використання. Запис file_size для поставленого об'єкта; downloaded_bytes - це поле передачі, не заміна для кінцевого заряду у використанні.

Огляд delivery.json
(
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 відповідно до обраного запиту та перевіряє його розмір і контроль без перезапису існуючого локального файлу.

S3 читати · немає нового запиту FlashData
(
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 розірванийПрочитайте кінцеву точку роботи знову, поки результат не зберігався. Зберігайте медіа, дивитесь на життєвий цикл відра.
CLI · огляд збереженого запуску
flashdata runs show download-001 --json

Подаруйте свій агент за критеріями виведення та доставки

Завдання агента · постачання відео, призначення та бюджету
Використовуйте свій збережений доступ власника та настроюється приватний накопичувач.
Читання download-request.json для відео та виходу; не змінюйте їх мовчно.
Перевірити завантаження цін і наявних кредитів на затверджений бюджет завдань.
Після того, як зберегти run/job ID, потім читати цю роботу для завершення.
Заощаджуйте запис доставки. Перевірити розмір збереженого об'єкта і MD5 перед обробкою.
Повідомляти про розташування об'єкта, вибраний формат, результат перевірки та фактичне використання.
Якщо подання не існує, перевірте збережену роботу; не створюйте доступ до заміни або інший завантажити.
Зберігайте облікові дані, приватні. Поділитися носіями тільки через налаштування доступу програми.