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.
O maior vídeo que o endpoint de publicação aceita, em contentor MP4, MOV ou WebM.
As durações mínima e máxima de vídeo que o TikTok documenta para publicar através da API.
A altura e a largura mínimas de um vídeo publicado, que também exige 23 a 60 fotogramas por segundo.
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.
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