Duyệt tài liệu
Hướng dẫn
Chọn đầu ra đúng phương tiện, điều khiển những gì bạn tải về, và biến một công việc hoàn tất thành một tập tin tư nhân có thể sử dụng.
Trên trang này
Hãy bắt đầu với những gì bạn cần
| Mục tiêu của bạn | Dùng |
|---|---|
| Tóm tắt nội dung đã nói hoặc xây dựng chỉ mục văn bản | Trước tiên, hãy đọc một bản sao đã có. Chỉ tải về âm thanh khi bạn cần âm thanh, như bước nói chuyện để văn bản. |
| Tiến trình phát âm hoặc âm thanh | Đầu ra chỉ âm thanh. Tránh mang theo video theo dõi ứng dụng của bạn không dùng. |
| Hiển thị đoạn ngắn | Đặt start_at và end_at. Kiểm tra rằng cả hai đều nằm trong khoảng thời gian của video nguồn. |
| Chơi hay xử lý video | MP4 với âm thanh và một nắp giải quyết phù hợp với ứng dụng của bạn; ví dụ này dùng <=720. |
Lưu kết xuất mà bạn muốn
Chọn một tab và lưu toàn bộ yêu cầu của nó như là download-request.json. Thay đổi video_id cho nguồn của bạn. Lệnh phục tùng bên dưới đọc tập tin này, vì vậy chọn âm thanh hay clip thay đổi yêu cầu thực sự.
Một đoạn video đầy đủ với âm thanh, bị bao phủ tại 720p.
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio_video",
"output_format": "mp4",
"video_quality": "<=720"
}
}Một tập tin âm thanh để lắng nghe hoặc xử lý âm thanh thêm nữa.
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio",
"output_format": "mp3"
}
}Một trích đoạn MP4 từ 00:00:05 phải 00:00:10. Dùng thời gian khớp với video đã chọ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"
}
}Kiểm tra quyền truy cập và giá trị phụ thuộcte
Dùng Bash và jq, cộng với tiết kiệm CLI hồ sơ hay FLASHDATA_API_KEY Vì HTTP. Chìa khóa cần thiết youtube_download Cho phép. Tải về cần thiết quyền người sở hữu; quyền truy cập thử nghiệm tạm thời không bao gồm nó. CLI Ví dụ dùng hồ sơ mặc định; thêm --profile NAME tới mọi lệnh nếu tên của anh được đặt.
| Quyết định | Áp dụng theo cách này |
|---|---|
| Giá dự đoán | Dùng cái này đi creditsPerTb và bytesPerUnit với các byte ước tính đầu ra của bạn. Việc tải về không phải là một tính phí cố định cho mỗi yêu cầu. |
| Phạm vi điều khiển | Chọn âm thanh, clip hoặc nắp giải quyết trước khi nộp. Áp dụng số liệu công việc và chi tiêu các quy tắc trong đơn xin việc của bạn. |
| Ghi lại chi phí thực sự | Đọc từ lần giao xong. Việc nhập viện có thể giữ được tín dụng trước khi việc tải lên được giải quyết; sự số dư hiện tại không phải là một cái nắp chi tiêu cho một công việc. |
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --jsonDùng điểm đến riêng cho mỗi kết xuất
Lưu storage.json Riêng tư với giá trị đích thực của bạn. Giữ nó bên ngoài kiểm soát nguồn. Sử dụng một khác biệt object_prefix cho mỗi video/output Phiên bản; tái sử dụng một tiền tố cho các kết quả khác nhau làm cho hồ sơ ứng dụng khó hòa giải hơn.
| Nhận diện | Mục đích |
|---|---|
| Phím FlashData | Gửi tải xuống và đọc công việc và giao hàng của nó JSON. |
| Name | Viết truyền thông tới xô và tiền tố đã định. |
| Nhận diện kho lưu ứng dụng | Đọc mục riêng hoặc quyền truy cập vào người dùng có thẩm quyền. |
{
"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.jsonGửi yêu cầu cứu hộ một lần
Chạy một tab sau khi lưu cả hai tập tin. Name storage.json đi qua stdin và lưu download-submission.json. Giữ cái hóa đơn này. Với CLIGiữ nguyên vị trí đó ID Cho một lần thử lại; sử dụng một điều mới ID Chỉ cho đầu ra có chủ đích mới. HTTP Phục tùng không dùng CLINhật ký điều hành địa phương.
(
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
)Kiểm tra trước với CLI
Mong đợi ok: true và data.dryRun: true. Kiểm tra đầu vào và FlashData Việc truy cập mà không gửi một việc làm; nó không chứng minh giấy ủy nhiệm tải lên có thể viết cho xô của bạn.
(
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
)Đợi công việc đã có
Hóa đơn không phải là hồ sơ truyền thông. CLI chờ đợi; các HTTP lệnh đọc tình trạng một lần. Lặp lại đoạn đọc trong thời hạn cuối cùng cho đến khi hoàn tất hoặc bị lỗi. Thời hạn cục bộ không hủy bỏ công việc máy phục vụ.
(
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
)Đọc hồ sơ giao hàng, rồi truy cập vào các phương tiện truyền thông
Sau khi hoàn thành, lấy lại delivery.json bằng cùng một con đường mà anh đã từng phục vụ. Kết quả đã được ký. URL lấy JSON; results[0].file_url Xác định phương tiện truyền thông trong kho của anh. Riêng tư file_url Cần phải có giấy tờ đọc hoặc liên kết được đưa ra bởi đơn xin việc của bạn.
(
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
)Kiểm tra xem cái gì đã được chuyển đến
Mong đợi một vị trí tập tin, một kết quả dương file_size, a MD5 và sử dụng. Thu file_size cho đối tượng được giao; downloaded_bytes là một trường chuyển giao, không phải một sự thay thế cho lần nạp cuối cùng.
(
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
)Kiểm tra bản sao của địa phương S3
Đặt OBJECT_KEY đến các phím truyền thông được chuyển từ file_urlKể cả tiền tố. Dùng AWS CLI Với quyền truy cập đọc, jq và OpenSSL. Cái này để dành. media.mp4 hay media.mp3 Tùy theo yêu cầu đã chọn, kiểm tra kích cỡ và tổng kiểm tra mà không viết quá một tập tin cục bộ đã có.
(
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'
)Phục hồi từ giai đoạn thất bại
| Chuyện gì đã xảy ra | Hành động tiếp theo |
|---|---|
| Không xác nhận được việc làm ID | Kiểm tra người được cứu CLI Chạy hoặc yêu cầu lịch sử. Giữ đầu vào ban đầu và không tự động đệ lại. |
| Gióp chấp nhận; chờ đợi hết giờ | Đọc hoặc phục hồi cùng một công việc. Không tạo một bản tải về mới để tiếp tục chờ. |
| Tải lên thất bại | Đọc lỗi công việc và sửa thiết lập đích hoặc ghi truy cập trước khi cố ý thử lại. |
| Đọc phương tiện đã trả lời 403 | Kiểm tra xem quyền hạn đọc hay liên kết đã đóng sẵn của ứng dụng. Hạt FlashData API Phím không mở khóa S3. |
| Đã ký kết quả JSON hết hạn | Hãy đọc lại kết quả của công việc trong khi vẫn còn. Truyền thông lưu trữ đi theo xe đạp cứu hộ của bạn. |
flashdata runs show download-001 --jsonCung cấp cho đại lý của bạn các tiêu chuẩn đầu ra và giao hàng
Sử dụng quyền truy cập của tôi và cấu hình kho lưu trữ tư nhân.
Đọc download-request.json cho video và đầu ra; không thay đổi chúng một cách âm thầm.
Kiểm tra giá trị sử dụng và tín dụng có từ ngân sách tác vụ được chấp nhận.
Phục tùng một lần, cứu lấy run/job IDRồi đọc xong công việc đó.
Để dành hồ sơ giao hàng đi. Kiểm tra kích cỡ của đối tượng đã lưu và MD5 Trước khi xử lý nó.
Báo cáo vị trí đối tượng, định dạng, kết quả thẩm tra và sử dụng thực tế.
Nếu sự phục tùng không chắc chắn, thanh tra lưu công việc, đừng tạo cơ hội tiếp cận thay thế hoặc tải về khác.
Giữ hồ sơ lưu trữ kín. Chia sẻ phương tiện chỉ qua điều khiển truy cập đã cấu hình của ứng dụng.