Qual é o limite de duração de vídeo no Threads, no app e na API

Qual é o limite de duração de vídeo no Threads?

O limite de duração de vídeo no Threads é de 5 minutos, e a regra vale tanto para posts feitos no app quanto para posts publicados pela Threads API. A Meta definiu o número do app no lançamento. O anúncio de 5 de julho de 2023, "Introducing Threads: A New Way to Share With Text", diz que os posts "can be up to 500 characters long and include links, photos, and videos up to 5 minutes in length."

A Threads API escreve o mesmo teto em segundos. A lista Video Specifications na página de visão geral da Meta, repetida no guia de posts, diz:

Duration: 300 seconds (5 minutes) maximum, minimum longer than 0 seconds.

Ou seja, o mínimo não impõe nenhum piso prático. Um clipe de um segundo passa na verificação de duração. Um clipe de 5 minutos e 1 segundo falha. Corte qualquer coisa mais longa antes de enviar.

O limite do app do Threads é o mesmo da API?

O app do Threads e a Threads API compartilham o teto de 5 minutos, mas só a API documenta esse limite na documentação atual. O artigo da Central de Ajuda do Threads "Start a new thread on Threads" diz que uma thread "can include short pieces of text, links, photos, videos or any combination of them" e depois explica a opção de adicionar da galeria sem informar duração, tamanho de arquivo ou formato. O post de lançamento de 2023 continua sendo a única declaração pública da Meta sobre o limite do app, e a Central de Ajuda não publicou nenhum número mais recente.

O lado da API é bem mais detalhado, e é o lado que importa para posts agendados, já que todo agendador de terceiros publica por ela.

Regra	App do Threads	Threads API
Duração máxima	5 minutos, pelo post de lançamento de 2023	300 segundos (5 minutos)
Duração mínima	Não documentada	Mais de 0 segundos
Tamanho máximo do arquivo	Não documentado	1 GB
Formatos	Não documentados	MOV ou MP4
Onde a regra está	Newsroom da Meta, 5 de julho de 2023	Visão geral e guia de posts da Threads API

Se você edita no celular e posta manualmente, a regra dos 5 minutos é a única que a Meta informa. Se uma ferramenta publica o vídeo por você, todas as linhas da coluna da API valem.

Que outras especificações de vídeo a Threads API verifica?

A Threads API verifica nove propriedades além da duração, e a Meta lista todas em Video Specifications:

Propriedade	Requisito da Threads API
Contêiner	MOV ou MP4 (MPEG-4 Part 14), sem edit lists, moov atom no início do arquivo
Codec de vídeo	HEVC ou H264, varredura progressiva, GOP fechado, subamostragem de croma 4:2:0
Codec de áudio	AAC, taxa de amostragem máxima de 48 kHz, mono ou estéreo
Taxa de quadros	23 a 60 FPS
Largura	Máximo de 1920 pixels na horizontal
Proporção	Entre 0.01:1 e 10:1, com 9:16 recomendado "to avoid cropping or blank space"
Taxa de bits do vídeo	VBR, máximo de 100 Mbps
Taxa de bits do áudio	128 kbps
Tamanho do arquivo	Máximo de 1 GB

Duas linhas passam despercebidas com facilidade. O moov atom precisa ficar no início do arquivo, e nem todo preset de exportação coloca ele lá, então procure uma opção "fast start" ou "otimizado para web". E o piso de 23 FPS rejeita exportações em câmera lenta ou timelapse salvas com taxas menores.

O limite de 1 GB e o limite de 5 minutos se afetam. No teto de 100 Mbps, um vídeo de 300 segundos chega a 30,000 megabits, o que dá 3.75 GB, muito acima do limite de arquivo. Um upload de 5 minutos completos fica dentro de 1 GB com uma média de 26.7 Mbps ou menos, então um master com taxa de bits alta quebra a regra de tamanho muito antes de chegar perto da regra de duração.

Limite de bitrate x média segura

Limite de bitrate da API100 Mbps

Média segura para 5 minutos com 1 GB26.7 Mbps

O que acontece quando um vídeo é longo demais para a Threads API?

Um vídeo do Threads com mais de 300 segundos não é publicado, e a página de solução de problemas da Meta indica o status do contêiner como o lugar para descobrir o motivo. Publicar no Threads leva duas chamadas: POST /{threads-user-id}/threads cria um contêiner de mídia com media_type=VIDEO e um video_url, e POST /{threads-user-id}/threads_publish transforma o contêiner em post. A própria Meta busca o arquivo, e a tabela de parâmetros avisa: "We will cURL your video using the URL provided so it must be on a public server."

Quando threads_publish não retorna um ID de mídia, a página de solução de problemas da Meta diz para consultar GET /{threads-container-id}?fields=status,error_message. O status volta como um de cinco valores: EXPIRED, ERROR, FINISHED, IN_PROGRESS ou PUBLISHED. Um ERROR traz uma de dez mensagens. A Meta lista essas mensagens só pelo nome, sem descrever cada uma, mas os nomes batem com a tabela de especificações acima:

1. INVALID_DURATION, a que corresponde à regra dos 300 segundos.
2. INVALID_BIT_RATE, INVALID_FRAME_RATE e INVALID_ASPEC_RATIO, que correspondem às linhas de taxa de bits, taxa de quadros e proporção. A Meta escreve o código da proporção sem o T.
3. INVALID_AUDIO_CHANNELS e INVALID_AUDIO_CHANNEL_LAYOUT, que correspondem à regra de mono ou estéreo.
4. FAILED_DOWNLOADING_VIDEO, que aponta para a busca do video_url.
5. FAILED_PROCESSING_VIDEO, FAILED_PROCESSING_AUDIO e UNKNOWN.

A Meta recomenda esperar "on average 30 seconds" antes de publicar um contêiner e consultar o status de um contêiner de vídeo "once per minute, for no more than 5 minutes." Um contêiner que ninguém publica em 24 horas passa para EXPIRED. A Meta não documenta se um contêiner que termina em ERROR conta na cota diária de 250 posts, que, como explica o artigo sobre o limite de 250 posts por dia da Threads API, é aplicada na chamada de publicação.

O limite de 5 minutos vale para cada vídeo de um carrossel?

O limite de 5 minutos vale para cada vídeo de um carrossel do Threads separadamente, porque cada item do carrossel é um contêiner próprio. O guia de posts monta um carrossel em três etapas: um contêiner por imagem ou vídeo com is_carousel_item=true, depois um contêiner de carrossel que lista esses itens em children e, por fim, a chamada de publicação. A seção de carrossel não acrescenta regras de vídeo próprias, então cada item precisa atender às mesmas Video Specifications de um post com um único vídeo.

A Meta permite de 2 a 20 itens, e a mecânica dessa faixa está em como funciona o limite máximo de itens do carrossel na Threads API. A Meta não documenta duração combinada nem tamanho de arquivo combinado para um carrossel. No papel, 20 vídeos de 300 segundos cada formam um carrossel válido, embora cada um ainda precise do próprio arquivo de 1 GB ou menos e da própria etapa de processamento.

O tamanho do texto é um orçamento separado. O limite de 500 caracteres vale para o campo text com ou sem vídeo no post, e o artigo sobre o limite de caracteres do Threads explica como a Meta faz essa contagem.

Como preparar um vídeo para caber nos limites do Threads?

Exporte o vídeo na especificação da API primeiro e depois confira duração e tamanho, porque um arquivo que atende às regras de codec é fácil de cortar, e um arquivo cortado com o codec errado continua falhando. Uma ordem que funciona:

1. Corte a edição para 300 segundos ou menos. Um vídeo de exatamente 5:00 passa; 5:01 não passa.
2. Exporte em MP4 com vídeo H264 ou HEVC e áudio AAC em mono ou estéreo, com fast start ativado para que o moov atom fique no início.
3. Defina a taxa de quadros entre 23 e 60 FPS e a largura em 1920 pixels ou menos. Vertical 9:16 em 1080 por 1920 atende às duas regras.
4. Mantenha o arquivo em 1 GB ou menos. Para um vídeo de 5 minutos completos, isso significa uma taxa de bits média de 26.7 Mbps ou menos.
5. Hospede o arquivo em uma URL pública que a Meta consiga buscar sem login nem cookie.
6. Depois de criar o contêiner, consulte o status uma vez por minuto até aparecer FINISHED e então publique.

O Instagram publica Reels com outro conjunto de regras, e o artigo sobre todos os limites que a API de Reels do Instagram impõe ao seu vídeo lista cada um. Um vídeo cortado para Reels não atende automaticamente à especificação do Threads, então confira as duas tabelas antes de publicar o mesmo arquivo nas duas redes.

Um agendador muda o limite de duração de vídeo no Threads?

Nenhum agendador muda o limite de duração de vídeo no Threads, porque a Meta aplica a regra dos 300 segundos a toda chamada de API, seja quem for que a faça. O AdaptlyPost publica posts de texto, imagem, link e carrossel no Threads, incluindo carrosséis que misturam imagens e vídeo, junto com Instagram, TikTok, YouTube, X, Facebook, LinkedIn, Pinterest, Bluesky e Mastodon a partir de um único painel, e a ferramenta de agendamento do Threads trabalha dentro dos limites da Meta como qualquer outro publicador. A duração é definida pelo arquivo que você envia, então corte e exporte na especificação antes de ele entrar na fila. Para planejar quando esses posts saem, veja como agendar posts no Threads.

Perguntas frequentes

Quanto tempo pode ter um vídeo no Threads?

Um vídeo no Threads pode ter 5 minutos. O post de lançamento da Meta prometeu "videos up to 5 minutes in length", e a Threads API informa "300 seconds (5 minutes) maximum." Um vídeo de 5 minutos e 1 segundo falha.

Existe uma duração mínima de vídeo no Threads?

A Threads API exige um vídeo "longer than 0 seconds", então não existe um mínimo prático. Um clipe de um segundo passa na verificação de duração. O app também não tem mínimo documentado.

Qual é o tamanho máximo de arquivo de vídeo no Threads?

A Threads API aceita arquivos de vídeo de 1 GB ou menos. A Meta não publica um limite de tamanho de arquivo para vídeos enviados pelo app. Um vídeo de 5 minutos completos fica dentro de 1 GB com uma taxa de bits média de 26.7 Mbps ou menos.

O que significa INVALID_DURATION no Threads?

INVALID_DURATION é uma das dez mensagens de erro que um contêiner de mídia do Threads retorna com status ERROR, lida por meio de GET /{threads-container-id}?fields=status,error_message. A Meta lista essa mensagem pelo nome, sem descrição, e o nome corresponde à regra de duração de 300 segundos. Corte o vídeo para 300 segundos ou menos e crie um contêiner novo.

Um carrossel do Threads pode ter vídeos que somem mais de 5 minutos?

A Meta não documenta limite de duração combinada em um carrossel do Threads. Cada um dos 2 a 20 itens é um contêiner separado que precisa cumprir sozinho as regras de 300 segundos e 1 GB. A duração total somando os itens não tem limite informado.

Qual formato de vídeo o Threads aceita?

A Threads API aceita contêineres MOV ou MP4 com vídeo HEVC ou H264 e áudio AAC. O arquivo precisa ter o moov atom no início, uma taxa de quadros de 23 a 60 FPS e uma largura de 1920 pixels ou menos. A Meta recomenda a proporção 9:16.

Por que a posição do átomo moov importa no envio de um vídeo para o Threads?

A API do Threads exige que o átomo moov fique no início do arquivo MOV ou MP4, e nem toda predefinição de exportação o coloca ali. Procure uma opção como "fast start" ou "otimizado para web" na exportação. A lista de erros da Meta não tem mensagem para um átomo moov fora do lugar, então um arquivo que quebra essa regra pode falhar sem indicar a causa.

O Threads exige vídeo vertical?

O Threads não exige vídeo vertical. A Meta recomenda uma proporção de 9:16 "to avoid cropping or blank space", mas a API aceita qualquer proporção entre 0,01:1 e 10:1, então vídeos horizontais e quadrados também passam. Um vídeo gravado na vertical em 9:16 fica confortavelmente dentro dessa faixa.

Quanto tempo o Threads leva para processar um vídeo antes de você poder publicá-lo?

A Meta recomenda esperar em média 30 segundos antes de publicar um contêiner e depois consultar o status uma vez por minuto por até 5 minutos. Um contêiner que fica sem publicar por 24 horas muda para EXPIRED e precisa ser recriado. A Meta não publica um tempo típico de processamento para um vídeo.

O AdaptlyPost consegue agendar vídeos do Threads automaticamente?

O AdaptlyPost publica automaticamente os posts agendados no Threads pela API oficial da Meta, incluindo carrosséis que misturam imagens e vídeo, junto com Instagram, TikTok, YouTube, X, Facebook, LinkedIn, Pinterest, Bluesky e Mastodon. Cada publicação ainda passa pelas próprias checagens da Meta, então os limites de 300 segundos e 1 GB valem como em uma chamada manual da API. Corte e exporte o arquivo dentro da especificação antes de ele entrar na fila.