Posts de foto e carrossel no TikTok pela API: até 35 imagens
A API for Business do TikTok publica um post de foto com 1 a 35 imagens, cada uma em JPG, JPEG ou WebP, com até 20 MB e no máximo 1080 por 1920 pixels em qualquer orientação. O TikTok baixa as imagens de uma URL verificada. O post leva um título de até 90 caracteres, uma legenda, um nível de privacidade e uma imagem de capa.
A easyCoexistence publica posts de foto no TikTok com publish_tiktok_post, pelo Claude, pelo ChatGPT ou pelo seu próprio código: passe de 1 a 35 links de imagem, um título e uma legenda, e acompanhe o post com get_tiktok_publish_status.
Número máximo de imagens que um post de foto aceita pelo endpoint de publicação de fotos do TikTok.
Tamanho máximo de arquivo por imagem em um post de foto, que precisa ser JPG, JPEG ou WebP.
Resolução máxima da imagem em pixels para um post de foto, ou 1920 x 1080 para imagem na horizontal.
Unidades de código UTF-16 que cabem no título de um post de foto; a legenda aceita até 4.000.
O que vai em um post de foto?
Uma única chamada a POST /business/photo/publish/ leva as imagens e os dados do post:
photo_images: até 35 URLs de imagem em um domínio ou prefixo de URL verificado.photo_cover_index: a imagem usada como capa, contando a partir de 0, que é o padrão.post_info.title: até 90 unidades de código UTF-16.post_info.caption: até 4.000 unidades de código UTF-16, com #hashtags e no máximo 30 @menções.post_info.privacy_level: quem pode ver o post, dentro das opções permitidas pelas configurações da conta.post_info.disable_comment: desativa os comentários no post.
Quais formatos de imagem são aceitos?
JPG, JPEG ou WebP, cada arquivo com até 20 MB e no máximo 1080 por 1920 pixels, ou 1920 por 1080 para imagem na horizontal. O TikTok só verifica o formato depois de baixar o arquivo, então um formato não suportado falha mais tarde, com file_format_check_failed. O publish_tiktok_post recusa links terminados em .png, .gif, .bmp, .heic, .avif ou .svg antes de enviar qualquer coisa.
Qual a diferença entre título e legenda?
São campos separados, com limites próprios. O título aceita até 90 unidades de código UTF-16. A legenda é a descrição do post, com até 4.000, e pode ter #hashtags e @menções a seguidores mútuos da conta, no máximo 30. Os dois são contados em unidades de código UTF-16, então um emoji pode ocupar duas ou mais. O publish_tiktok_post recebe os dois como title e caption.
Quem vê o post, e dá para comentar?
O privacy_level define quem vê o post: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR ou SELF_ONLY, dentro das opções que GET /business/video/settings/ retorna para a conta. O TikTok só lista PUBLIC_TO_EVERYONE para contas públicas, e esse é o nível que o publish_tiktok_post define. Os comentários ficam ativados, a menos que disable_comment seja true, e uma conta que não permite comentários de ninguém só aceita true.
O que acontece depois da chamada?
O TikTok retorna um share_id e baixa as imagens em segundo plano. O get_tiktok_publish_status recebe esse share_id e informa PROCESSING_DOWNLOAD enquanto o TikTok busca as imagens, PUBLISH_COMPLETE quando o post passa pela moderação, ou FAILED com um motivo, como photo_pull_failed. Por este endpoint, o TikTok limita os posts de foto a seis por minuto e 15 por dia por conta.
Erros comuns
- Enviar imagens PNG. Posts de foto do TikTok aceitam apenas JPG, JPEG ou WebP, então converta os arquivos antes de publicar.
- Contar o título pelos caracteres que você vê na tela. O TikTok conta unidades de código UTF-16, então um título com emoji atinge 90 mais rápido.
- Usar imagens acima de 1080 por 1920 pixels. Essa é a resolução máxima do TikTok para posts de foto, então redimensione imagens maiores antes.
- Colocar a capa em outra posição que não a primeira. O publish_tiktok_post usa a primeira imagem como capa.
Os posts de foto também podem ser agendados para a data e hora que você definir, em uma fila própria. 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 3 primeiros 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
Quantas fotos um post do TikTok pode ter pela API?
Até 35, cada uma em JPG, JPEG ou WebP, com no máximo 20 MB.
Dá para usar imagens PNG em um post de foto do TikTok?
Não. O endpoint de fotos aceita JPG, JPEG e WebP, e o TikTok rejeita um PNG depois de baixá-lo, com file_format_check_failed.
Qual o tamanho máximo do título de um post de foto?
Até 90 unidades de código UTF-16. A legenda é um campo separado e aceita até 4.000.
Qual imagem vira a capa?
A indicada em photo_cover_index, contando a partir de 0. O publish_tiktok_post mantém o valor 0, então a primeira imagem é a capa.
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