Frame.io Python SDK - Guia para fazer upload
Frame.io Python SDK - Guia para fazer upload
Este guia explica como fazer upload de arquivos para o Frame.io usando o Frame.io Python SDKK (frameio). O SDK processa uploads fragmentados em blocos para o S3 por meio de URLs pré-assinadas, com workers paralelos, novas tentativas automáticas e rastreamento de progresso opcional. Para obter conceitos gerais da API de upload, como URLs para fazer upload, cabeçalhos e divisão em blocos, consulte Como funcionam os uploads locais e remotos.
Pré-requisitos
Autenticação
Você tem um cliente Frameio funcionando. Consulte o Guia de autenticação para configuração.
Início rápido
É isso. O SDK divide o arquivo em blocos com base nas URLs para fazer upload retornadas pela API, faz upload deles em paralelo e processa novas tentativas automaticamente.
Como funciona
Fazer upload local é um processo em duas etapas:
O upload vai diretamente do seu aplicativo para o S3; ele não passa pelos servidores da API do Frame.io. Esse é o mesmo padrão usado por serviços como YouTube, Vimeo e Dropbox para fazer upload de arquivos grandes.
Uso do FrameioUploader
FrameioUploader é a forma recomendada de fazer upload de arquivos. Ele encapsula o uploader em blocos de nível inferior e processa todos os detalhes: extrair URLs para fazer upload da resposta da API, definir os cabeçalhos obrigatórios, dividir o arquivo em blocos e fazer upload em paralelo.
Rastreamento de progresso
Use o callback on_progress para rastrear o progresso do upload:
O callback é invocado uma vez após a conclusão de cada bloco, com os bytes cumulativos cujo upload foi feito até o momento e o tamanho total do arquivo.
Barra de progresso Rich
Para uma experiência refinada no terminal, use Rich:
Configuração
FrameioUploader aceita vários parâmetros opcionais:
Exemplo completo
Um exemplo completo com autenticação, upload e rastreamento de progresso:
Se precisar de controle total sobre o processo de fazer upload, por exemplo, para lidar manualmente com a divisão em blocos, integrar com um pipeline async ou personalizar a lógica de nova tentativa, consulte Como funcionam os uploads locais e remotos para ver o fluxo bruto da API e um exemplo de script Python independente.
Fazer upload remoto
Se o arquivo já estiver acessível por meio de uma URL pública, use o upload remoto. Não é necessário dividir em blocos. O Frame.io busca o arquivo diretamente:
No momento, o upload remoto tem um limite de tamanho de arquivo de 50 GB. Para arquivos maiores que 50 GB, use upload local.
Verificação do status do upload
Após fazer upload, você pode verificar se o arquivo foi recebido: