EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

1 GB

Maior vídeo que o endpoint de publicação aceita, em contêiner MP4, MOV ou WebM.

3 to 600 s

Menor e maior duração de vídeo que o TikTok documenta para publicação pela API.

360 px

Altura e largura mínimas de um vídeo publicado, que também precisa ter de 23 a 60 quadros por segundo.

30 min

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.
Fazendo isso com o EasyCoexistence

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