Publicações de fotos e carrosséis no TikTok através da API: até 35 imagens
A API for Business do TikTok publica uma publicação de fotos com 1 a 35 imagens, cada uma um ficheiro JPG, JPEG ou WebP com até 20 MB e não superior a 1080 por 1920 pixels em qualquer orientação, que o TikTok transfere a partir de um URL verificado. A publicação aceita um título de até 90 caracteres, uma legenda, um nível de privacidade e uma imagem de capa.
A easyCoexistence publica publicações de fotos do TikTok com publish_tiktok_post a partir do Claude, do ChatGPT ou do seu próprio código: indique de 1 a 35 ligações de imagens, um título e uma legenda, e depois acompanhe a publicação com get_tiktok_publish_status.
Número máximo de imagens que uma publicação de fotos pode ter através do endpoint de publicação de fotos do TikTok.
Maior tamanho de ficheiro para cada imagem de uma publicação de fotos, que tem de ser JPG, JPEG ou WebP.
Maior resolução de imagem em pixels para uma publicação de fotos, ou 1920 x 1080 para uma imagem em paisagem.
Unidades de código UTF-16 que o título de uma publicação de fotos pode ter; a legenda aceita até 4000.
O que entra numa publicação de fotos?
Uma chamada a POST /business/photo/publish/ transporta as imagens e os dados da publicação:
photo_images: até 35 URLs de imagens num domínio ou prefixo de URL verificado.photo_cover_index: a imagem usada como capa, contando a partir de 0, que é o valor predefinido.post_info.title: até 90 unidades de código UTF-16.post_info.caption: até 4000 unidades de código UTF-16, com #hashtags e no máximo 30 @menções.post_info.privacy_level: quem pode ver a publicação, dentro das opções permitidas pelas definições da conta.post_info.disable_comment: desativa os comentários na publicação.
Que ficheiros de imagem funcionam?
JPG, JPEG ou WebP, cada um até 20 MB e não superior a 1080 por 1920 pixels, ou 1920 por 1080 para uma imagem em paisagem. O TikTok verifica o formato só depois de transferir o ficheiro, por isso um ficheiro não suportado falha mais tarde com file_format_check_failed. publish_tiktok_post recusa, antes de enviar nada, ligações que terminem em .png, .gif, .bmp, .heic, .avif ou .svg.
Em que se diferenciam o título e a legenda?
São campos separados, com limites separados. O título tem até 90 unidades de código UTF-16. A legenda é a descrição da publicação, até 4000, e pode levar #hashtags e @menções de seguidores mútuos da conta, no máximo 30. Ambos são contados em unidades de código UTF-16, pelo que um emoji pode contar duas ou mais. publish_tiktok_post recebe-os como title e caption.
Quem vê a publicação e podem as pessoas comentar?
privacy_level define quem a vê: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR ou SELF_ONLY, dentro das opções que GET /business/video/settings/ devolve para a conta. O TikTok indica PUBLIC_TO_EVERYONE apenas para contas públicas, e é o nível que publish_tiktok_post define. Os comentários ficam ativados, a menos que disable_comment seja true, e uma conta que não aceita comentários de ninguém aceita apenas true.
O que acontece depois da chamada?
O TikTok devolve um share_id e transfere as imagens em segundo plano. get_tiktok_publish_status recebe esse share_id e indica PROCESSING_DOWNLOAD enquanto o TikTok obtém as imagens, PUBLISH_COMPLETE quando a publicação passou a moderação, ou FAILED com um motivo, como photo_pull_failed. O TikTok limita as publicações de fotos a seis por minuto e 15 por dia por conta através deste endpoint.
Erros comuns
- Enviar imagens PNG. As publicações de fotos do TikTok aceitam apenas JPG, JPEG ou WebP, por isso converta os ficheiros antes de publicar.
- Contar o título em caracteres como os vê. O TikTok conta unidades de código UTF-16, pelo que um título com emojis chega aos 90 mais depressa.
- Usar imagens acima de 1080 por 1920 pixels. Essa é a maior resolução que o TikTok aceita em publicações de fotos, por isso redimensione primeiro as imagens maiores.
- Pôr a capa noutra posição que não a primeira. publish_tiktok_post usa a primeira imagem como capa.
As publicações de fotos podem também sair numa data e hora que definir, a partir da sua própria fila de envio. De US$ 9 a US$ 0,75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Quantas fotos pode ter uma publicação do TikTok através da API?
Até 35, cada uma um ficheiro JPG, JPEG ou WebP com no máximo 20 MB.
Pode uma publicação de fotos do TikTok usar imagens PNG?
Não. O endpoint de fotos aceita JPG, JPEG e WebP, e o TikTok falha um PNG depois de o transferir, com file_format_check_failed.
Qual é o tamanho máximo do título de uma publicação de fotos?
Até 90 unidades de código UTF-16. A legenda é um campo separado e aceita até 4000.
Qual imagem se torna a capa?
A que photo_cover_index indica, contando a partir de 0. publish_tiktok_post deixa-o em 0, por isso a primeira imagem é a capa.
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