Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Requisitos de vídeo da API do TikTok: formato, tamanho e duração

Um vídeo publicado através da API for Business do TikTok tem de ser um ficheiro MP4, MOV ou WebM até 1 GB, com 3 a 600 segundos de duração (ou o máximo inferior da conta), com pelo menos 360 píxeis de altura e de largura, a 23 a 60 fotogramas por segundo. O TikTok transfere o ficheiro ele próprio, pelo que o URL do vídeo tem de estar num domínio ou prefixo de URL que a aplicação de publicação tenha verificado.

A easyCoexistence publica vídeos do TikTok com publish_tiktok_post a partir do Claude, do ChatGPT ou do seu próprio código: indique uma ligação HTTPS para o ficheiro, a legenda e se os comentários estão ativados, e a easyCoexistence entrega o ficheiro ao TikTok a partir da sua própria rota multimédia verificada.

1 GB

O maior vídeo que o endpoint de publicação aceita, em contentor MP4, MOV ou WebM.

3 to 600 s

As durações mínima e máxima de vídeo que o TikTok documenta para publicar através da API.

360 px

A altura e a largura mínimas de um vídeo publicado, que também exige 23 a 60 fotogramas por segundo.

30 min

O tempo mínimo que o TikTok recomenda que o URL do vídeo se mantenha válido, já que o TikTok transfere o ficheiro ele próprio.

O que tem de cumprir um vídeo?

A especificação do TikTok para um vídeo publicado através de POST /business/video/publish/, que o TikTok verifica depois de transferir o ficheiro:

  • Contentor: MP4, MOV ou WebM.
  • Tamanho: até 1 GB.
  • Duração: pelo menos 3 segundos e no máximo 600, ou menos quando o máximo da própria conta for inferior.
  • Imagem: pelo menos 360 píxeis de altura e de largura.
  • Taxa de fotogramas: de 23 a 60 fotogramas por segundo.

Todas as contas podem publicar vídeos de 600 segundos?

Nem sempre. GET /business/video/settings/ devolve max_video_post_duration_sec, o vídeo mais longo que a própria conta pode publicar, e um vídeo mais longo não chega a ser publicado. A mesma chamada indica se as definições da conta permitem comentários, Duets e Stitch nas suas publicações. Com a easyCoexistence, o seu próprio código lê-o com o token e o business_id de get_social_credentials.

Onde tem de estar o vídeo?

Num URL HTTP ou HTTPS público, que o próprio TikTok obtém e recomenda que se mantenha válido durante pelo menos 30 minutos. Desde 16 de novembro de 2023, o TikTok também recusa vídeos cujo URL não esteja verificado: o programador prova a propriedade de um domínio com um registo DNS TXT, ou de um prefixo de URL com um ficheiro de assinatura colocado sob esse prefixo, e qualquer URL que comece por um prefixo verificado pode então ser publicado.

Como é que a easyCoexistence entrega o seu ficheiro ao TikTok?

Através do seu próprio prefixo de URL verificado. publish_tiktok_post recebe a sua ligação HTTPS, entrega ao TikTok uma ligação assinada na rota multimédia da easyCoexistence que expira ao fim de 6 horas, e transmite o ficheiro a partir da sua ligação quando o TikTok o transfere, sem guardar nada pelo caminho. A sua ligação não precisa de verificação própria, mas tem de ser HTTPS e estar acessível sem início de sessão até a publicação estar concluída.

O que acontece depois de o TikTok transferir o vídeo?

O TikTok verifica o ficheiro e transcodifica-o, e a publicação pode mostrar uma resolução e uma taxa de bits inferiores às do original, consoante o dispositivo e a rede de quem vê. Um ficheiro que viole uma regra não é publicado: o estado fica FAILED com um motivo como file_format_check_failed, frame_rate_check_failed ou picture_size_check_failed, e o TikTok marca estes casos como não repetíveis com o mesmo ficheiro.

Erros comuns

  • Enviar uma ligação http://. publish_tiktok_post aceita apenas ligações HTTPS e recusa a chamada antes de esta chegar ao TikTok.
  • Exportar abaixo de 23 fotogramas por segundo. O TikTok transfere o ficheiro, considera a taxa de fotogramas demasiado baixa e falha a publicação com frame_rate_check_failed.
  • Assumir 600 segundos para todas as contas. Um vídeo mais longo do que o max_video_post_duration_sec da conta falha, por isso verifique-o primeiro.
  • Retirar o ficheiro logo após a chamada. O TikTok transfere-o depois de aceitar o pedido, e uma ligação que deixe de funcionar falha com video_pull_failed.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0.75 por número ligado por mês, descendo à medida que acrescenta números, com os primeiros 3 dias grátis.

Perguntas frequentes

Que formatos de vídeo aceita a API do TikTok?

Ficheiros MP4, MOV e WebM até 1 GB, com 3 a 600 segundos de duração, pelo menos 360 píxeis em cada lado e 23 a 60 fotogramas por segundo.

Posso carregar um ficheiro de vídeo a partir do meu computador?

Não neste endpoint. Aceita um video_url e transfere o ficheiro a partir daí, pelo que o vídeo precisa primeiro de uma ligação HTTPS pública.

Porque é que o TikTok quer um URL verificado?

O TikTok diz que verificar a propriedade do URL o ajuda a cumprir as suas políticas sobre conteúdos protegidos por direitos de autor e a segurança dos utilizadores, e desde 16 de novembro de 2023 recusa vídeos cujo URL não esteja verificado.

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 mostrar uma resolução e uma taxa de bits inferiores às do ficheiro, consoante o dispositivo e a ligação de quem vê.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em