Pular para o conteúdo
PT
Obter chave API
Explorar documentação

Guias

YouTube Baixe as melhores práticas

Escolha a saída de mídia certa, controle o que você baixar, e transforme um trabalho completo em um arquivo privado utilizável.

Nesta página

Comece com o que sua tarefa precisa

Seu objetivoUse
Resumir conteúdo falado ou construir um índice de textoLeia uma transcrição existente primeiro. Baixe áudio apenas quando seu fluxo de trabalho precisa do áudio em si, como um passo de discurso para texto separado.
Processo de fala ou áudioSaída somente de áudio. Evite carregar um vídeo que sua aplicação não usa.
Mostre um pequeno trechoSet start_at e end_at.
Reproduzir ou processar vídeoMP4 com áudio e uma tampa de resolução adequada para sua aplicação; o exemplo usa <=720.

Salve a saída que você quer

Escolha uma guia e salve todo o pedido como download-request.json. Mude video_id para sua fonte. Os comandos de submissão abaixo ler este arquivo, então escolher áudio ou um clipe muda o pedido real.

Um vídeo completo com áudio, com 720p.

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

Verifique o acesso do proprietário e preços baseados em bytes

Use Bash e jq, além de um perfil salvo CLI ou FLASHDATA_API_KEY para HTTP. A chave precisa de permissão youtube_download. O download requer acesso do proprietário, acesso temporário não inclui. Exemplos CLI usam seu perfil padrão; adicione --profile NAME a cada comando se o seu for nomeado.

DecisãoAplique assim
Estimativa de custoUse o creditsPerTb e bytesPerUnit com seus bytes de saída estimados. O preço do download não é uma taxa fixa por pedido.
Controle de escopoEscolha áudio, um clipe ou uma tampa de resolução antes da submissão. Aplique regras de trabalho e gastos em sua inscrição.
Grave a carga realUso de leitura da entrega completa. A admissão pode ter créditos antes do upload se resolver, o saldo atual não é um limite de gastos por trabalho.
verificações grátis. CLI
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --json

Use um destino privado para cada saída

Salve storage.json em particular com seus valores reais de destino. Mantenha-o fora do controle de fonte. Use um object_prefix distinto para cada versão video/output; reutilizar um prefixo para diferentes saídas torna os registros de aplicativos mais difíceis de reconciliar.

CredencialPropósito
FlashData chaveEnvie o download e leia seu trabalho e entrega JSON.
Credencial de upload de armazenamentoEscreva mídia para o prefixo e balde pretendido.
Identidade do armazenamento de aplicativosLeia o objeto privado ou o acesso a um usuário autorizado.
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 · arquivo privado
chmod 600 storage.json

Envie o pedido salvo uma vez

Faça uma conta depois de salvar os dois arquivos. O comando injeta storage.json através de stdin e salva download-submission.json. Fique com o recibo. Com CLI, mantenha a mesma execução ID para uma repetição; use um novo ID apenas para uma nova saída intencional. Submissões HTTP não usam o diário local do CLI.

Envie a saída escolhida
(
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
)

Validar primeiro com o CLI

Espere ok: true e data.dryRun: true. Isso verifica a entrada e o acesso ao FlashData sem enviar um trabalho, não prova que as credenciais de upload podem escrever para o seu balde.

Livre corrida seca
(
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
)

Espere pelo trabalho existente

O recibo de submissão não é o arquivo da mídia. CLI espera; o comando HTTP lê status uma vez. Repita a leitura dentro do seu prazo até completar ou falhar. Um tempo limite local não cancela o trabalho do servidor.

Espere pelo trabalho salvo
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs wait "$JOB_ID"
)

Leia o registro de entrega e acesse a mídia

Depois de concluído, recupere delivery.json usando o mesmo caminho que você usou para enviar. O resultado assinado URL recupera JSON; resultados[0].file_url identifica a mídia em seu armazenamento. Um file_url privado precisa da sua identidade de leitura de armazenamento ou um link emitido pela sua aplicação.

Salve 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
)

Verifique o que foi entregue

Espere um local de arquivo, um file_size positivo, um MD5 e uso. Registre file_size para o objeto entregue, downloaded_bytes é um campo de transferência, não um substituto para a carga final em uso.

Inspecione 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
)

Verifique uma cópia local de S3

Defina OBJECT_KEY para a chave de mídia entregue de file_url, incluindo seu prefixo. Use AWS CLI com acesso de leitura, jq e OpenSSL. Isso salva media.mp4 ou media.mp3 de acordo com seu pedido escolhido e verifica seu tamanho e soma de verificações sem sobrescrever um arquivo local existente.

S3 não tem nenhuma nova consulta 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'
)

Recupere-se do palco que falhou

O que aconteceu?Próxima ação
A submissão acabou sem nenhum trabalho confirmado IDInspecione o CLI salvo ou peça o histórico. Mantenha a entrada original e não se submeta automaticamente novamente.
Trabalho aceito, espera tempo esgotadoLeia ou recupere o mesmo trabalho. Não crie outro download para continuar esperando.
O carregamento falhouLeia o erro de trabalho e conserte as configurações de destino ou escreva o acesso antes de tentar novamente.
A mídia leu 403 devolvidoVerifique as permissões de leitura de armazenamento ou o link emitido pela aplicação. A chave FlashData API não destrava S3.
Resultado assinado JSON expiradoLeia o resultado do trabalho novamente enquanto o resultado é mantido. Mídia armazenada segue o ciclo de vida do seu balde.
CLI · inspecione a corrida salva
flashdata runs show download-001 --json

Dê ao seu agente os critérios de saída e entrega

Tarefa do agente. Forneça o vídeo, destino e orçamento.
Use meu acesso ao proprietário e configure o armazenamento privado.
Leia download-request.json para o vídeo e saída, não mude-os silenciosamente.
Verifique os preços do download e os créditos disponíveis contra o orçamento aprovado.
Submeta-se uma vez, salve o run/job ID, e leia o trabalho para completar.
Guarde o registro de entrega. Verifique o tamanho do objeto armazenado e MD5 antes de processá-lo.
Reporte a localização do objeto, formato escolhido, resultado de verificação e uso real.
Se a submissão for incerta, inspecione o trabalho salvo, não crie acesso de substituição ou outro download.
Mantenha credenciais de armazenamento privadas. Compartilhe mídia apenas através dos controles de acesso configurados da aplicação.