Requisitos de vídeo da API do TikTok: formato, tamanho e duração
Um vídeo publicado pela API do TikTok for Business precisa ser um arquivo MP4, MOV ou WebM de até 1 GB, com 3 a 600 segundos de duração (ou o limite menor da conta), pelo menos 360 pixels de altura e de largura e de 23 a 60 quadros por segundo. O próprio TikTok baixa o arquivo, então a URL do vídeo precisa estar em um domínio ou prefixo de URL que o app de publicação tenha verificado.
O easyCoexistence publica vídeos no TikTok com publish_tiktok_post a partir do Claude, do ChatGPT ou do seu próprio código: você informa um link HTTPS para o arquivo, a legenda e se os comentários ficam ativados, e ele entrega o arquivo ao TikTok pela própria rota de mídia verificada.
Maior vídeo que o endpoint de publicação aceita, em contêiner MP4, MOV ou WebM.
Menor e maior duração de vídeo que o TikTok documenta para publicação pela API.
Altura e largura mínimas de um vídeo publicado, que também precisa ter de 23 a 60 quadros por segundo.
Tempo mínimo que o TikTok recomenda manter a URL do vídeo válida, já que ele mesmo baixa o arquivo.
Quais requisitos o vídeo precisa cumprir?
A especificação do TikTok para um vídeo publicado por POST /business/video/publish/, que o TikTok confere depois de baixar o arquivo:
- Contêiner: MP4, MOV ou WebM.
- Tamanho: até 1 GB.
- Duração: no mínimo 3 segundos e no máximo 600, ou menos quando o limite da própria conta for menor.
- Imagem: no mínimo 360 pixels de altura e de largura.
- Taxa de quadros: de 23 a 60 quadros por segundo.
Toda conta pode publicar vídeos de 600 segundos?
Nem sempre. GET /business/video/settings/ retorna max_video_post_duration_sec, a duração máxima de vídeo que a própria conta pode publicar, e um vídeo mais longo falha na publicação. A mesma chamada informa se as configurações da conta permitem comentários, Duets e Stitch nas publicações. Com o easyCoexistence, o seu próprio código lê esses dados com o token e o business_id de get_social_credentials.
Onde o vídeo precisa estar?
Em uma URL HTTP ou HTTPS pública, que o próprio TikTok acessa e que ele recomenda manter válida por pelo menos 30 minutos. Desde 16 de novembro de 2023, o TikTok também recusa URLs de vídeo não verificadas: o desenvolvedor comprova a propriedade de um domínio com um registro DNS TXT, ou de um prefixo de URL com um arquivo de assinatura colocado sob ele, e a partir daí qualquer URL que comece com um prefixo verificado pode ser usada para publicar.
Como o easyCoexistence envia seu arquivo ao TikTok?
Por meio de um prefixo de URL verificado do próprio easyCoexistence. publish_tiktok_post recebe seu link HTTPS, entrega ao TikTok um link assinado na rota de mídia do easyCoexistence que expira em 6 horas e transmite o arquivo a partir do seu link quando o TikTok o baixa, sem armazenar nada no processo. Seu link não precisa de verificação própria, mas precisa ser HTTPS e abrir sem login até a publicação ser concluída.
O que acontece depois que o TikTok baixa o vídeo?
O TikTok confere o arquivo e o transcodifica, e avisa que a publicação pode exibir resolução e taxa de bits menores que as do original, dependendo do dispositivo e da rede de quem assiste. Um arquivo que descumpre alguma regra não é publicado: o status fica FAILED com um motivo como file_format_check_failed, frame_rate_check_failed ou picture_size_check_failed, e o TikTok indica que não adianta repetir esses casos com o mesmo arquivo.
Erros comuns
- Enviar um link http://. publish_tiktok_post aceita apenas links HTTPS e recusa a chamada antes que ela chegue ao TikTok.
- Exportar com menos de 23 quadros por segundo. O TikTok baixa o arquivo, considera a taxa de quadros baixa demais e reprova a publicação com frame_rate_check_failed.
- Presumir 600 segundos para toda conta. Um vídeo mais longo que o max_video_post_duration_sec da conta falha, então consulte esse valor antes.
- Remover o arquivo logo após a chamada. O TikTok o baixa depois de aceitar a requisição, e um link que deixa de funcionar falha com video_pull_failed.
De R$ 29,90 a R$ 3,90 por conexão por mês, com o valor caindo conforme você adiciona conexões, e os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Quais formatos de vídeo a API do TikTok aceita?
Arquivos MP4, MOV e WebM de até 1 GB, com 3 a 600 segundos de duração, no mínimo 360 pixels em cada lado e de 23 a 60 quadros por segundo.
Posso enviar um arquivo de vídeo do meu computador?
Não por este endpoint. Ele recebe um video_url e baixa o arquivo de lá, então o vídeo precisa antes estar em um link HTTPS público.
Por que o TikTok exige uma URL verificada?
O TikTok diz que verificar a propriedade da URL ajuda a cumprir suas políticas sobre conteúdo protegido por direitos autorais e segurança dos usuários, e desde 16 de novembro de 2023 recusa URLs de vídeo não verificadas.
O TikTok reduz a qualidade de um vídeo publicado pela API?
Pode reduzir. O TikTok transcodifica o vídeo, e a publicação pode exibir resolução e taxa de bits menores que as do arquivo, dependendo do dispositivo e da conexão de quem assiste.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em