Adicionar música a publicações do TikTok através da API
A API for Business do TikTok adiciona música da Commercial Music Library: post_info.music_sound_info aceita o music_sound_id de uma faixa em publicações de vídeo e de fotos e, nos vídeos, também o volume da faixa, o início e o fim em milissegundos e o volume do som original do vídeo. As publicações de fotos podem ainda usar auto_add_music para música recomendada. Os IDs das faixas vêm de GET /discovery/cml/trending_list/.
A easyCoexistence publica vídeos e publicações de fotos do TikTok com publish_tiktok_post a partir do Claude, do ChatGPT ou do seu próprio código, agora ou numa data agendada até 90 dias à frente, e um vídeo sai com a banda sonora misturada no seu ficheiro.
As faixas mais populares que /discovery/cml/trending_list/ devolve, todas previamente autorizadas para conteúdo orgânico e criação de anúncios.
Intervalo de music_sound_volume e video_original_sound_volume; pela API, ambos têm 0 por predefinição, enquanto a aplicação TikTok começa em 50.
Músicas da Commercial Music Library do TikTok, a biblioteca global previamente autorizada que as empresas usam para atividade comercial no TikTok.
Onde podem ser exibidos criativos feitos com música da lista de músicas para anúncios do TikTok, salvo se os titulares dos direitos concederem autorização separada.
O único post_mode em que o endpoint de fotos da Content Posting API aplica auto_add_music, em developers.tiktok.com.
Que campos de música aceitam os endpoints de publicação do TikTok?
Os dois endpoints incluem a música dentro de post_info, em music_sound_info, e identificam uma faixa pelo seu ID na Commercial Music Library. Para lá disso, diferem: o endpoint de vídeo acrescenta controlos de mistura, e o de fotos acrescenta um interruptor que deixa o TikTok escolher a música. Lado a lado, tal como as referências do TikTok as listam:
| Video post | Photo post | |
|---|---|---|
| The track | music_sound_info.music_sound_id | music_sound_info.music_sound_id |
| Track volume | music_sound_volume, 0 to 100, required with a track | No field |
| Part of the track | music_sound_start and music_sound_end, in milliseconds | No field |
| The video's own sound | video_original_sound_volume, 0 to 100 | Not applicable |
| Recommended music | No field | auto_add_music, false by default |
| As a draft | upload_to_draft drops the rest of post_info | is_draft keeps only the title and caption |
Como se adiciona uma faixa a um vídeo?
Envie music_sound_info dentro de post_info em POST /business/video/publish/. Depois de o objeto estar presente, music_sound_id e music_sound_volume são obrigatórios. music_sound_start e music_sound_end escolhem a parte da faixa em milissegundos, do início da faixa até à duração total do vídeo por predefinição, pelo que um vídeo de 2 segundos usa os primeiros 2,000 milissegundos da faixa. Defina também video_original_sound_volume sempre que o áudio original do vídeo importe, já que o valor predefinido é 0:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/launch.mp4",
"post_info": {
"caption": "Our new blend is here #coffee",
"is_brand_organic": false,
"is_branded_content": false,
"music_sound_info": {
"music_sound_id": "<SONG_CLIP_ID>",
"music_sound_volume": 40,
"music_sound_start": 15000,
"music_sound_end": 30000,
"video_original_sound_volume": 80
}
}
}'De onde vêm os IDs das faixas?
De GET /discovery/cml/trending_list/, um endpoint da Discovery API que recebe o token de acesso de uma conta TikTok e o business_id, ao passo que os endpoints de hashtags da Discovery recebem o de um anunciante; a referência do TikTok coloca-o na permissão Discovery do Creative Management. Devolve até 100 faixas populares, cada uma com o nome, o artista, a duração, a posição no ranking, os géneros, um preview_url que não expira e até 30 dias de trending_history. full_duration_song_clip e trending_song_clip contêm cada um um song_clip_id, o valor que o TikTok designa como music_sound_id:
- género: ALL por predefinição, ou um de mais de 100 valores, como POP, LATIN, LO-FI ou SERTANEJO.
country_code: US por predefinição.date_range: 1DAY, 7DAY por predefinição, 30DAY ou 90DAY.- /discovery/cml/
video_list/: os 20 vídeos em tendência mais relevantes que usam uma faixa, pelo seucommercial_music_ide umcountry_code.
curl -G 'https://business-api.tiktok.com/open_api/v1.3/discovery/cml/trending_list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'genre=POP' \
--data-urlencode 'country_code=BR' \
--data-urlencode 'date_range=7DAY'Como recebem música as publicações de fotos?
De duas formas em POST /business/photo/publish/. Com auto_add_music definido como true, o TikTok adiciona música recomendada, que o proprietário pode mudar mais tarde na aplicação TikTok. Com music_sound_info.music_sound_id, indica-se uma faixa específica da biblioteca, sem campos de volume, início ou fim nas fotos. Em developers.tiktok.com, o endpoint de fotos da Content Posting API tem um auto_add_music próprio, aplicado apenas quando post_mode é DIRECT_POST, e o seu endpoint de publicação direta de vídeo não documenta nenhum campo de música.
O que significa a Commercial Music Library para as contas empresariais?
É a música que podem usar. O Centro de Ajuda para Empresas do TikTok descreve a biblioteca como uma coleção global previamente autorizada de 1 milhão de músicas, diz que as empresas não podem usar a biblioteca musical geral para fins comerciais, e remete-as para a Commercial Music Library para conteúdo orgânico, duetos, reações e stitches incluídos, anúncios em vídeo e conteúdo de marca. Numa conta Business, Adicionar som na aplicação mostra apenas sons da biblioteca, e a API impõe a mesma fronteira, já que music_sound_id aceita um ID da biblioteca.
O que não consegue a API fazer com música?
Algumas coisas ficam fora dos seus campos, tal como as referências do TikTok as descrevem:
- Indicar um som da biblioteca geral do TikTok:
music_sound_idaceita apenas um ID da Commercial Music Library. - Pesquisar a biblioteca por título: /discovery/cml/
trending_list/ filtra as faixas populares por género, país e período. - Manter música num rascunho:
upload_to_draftfaz o TikTok ignorar o resto depost_info, eis_draftmantém apenas o título e a legenda. - Usar uma faixa própria numa publicação orgânica: /file/music/upload/ adiciona música para criativos de anúncios sob um
advertiser_id, e o aviso do TikTok aí deixa a responsabilidade por direitos de autor a cargo de quem carrega o ficheiro.
Quais são as alternativas?
Três, cada uma assente no que as referências do TikTok documentam, mais um risco a ponderar:
- Misturar a música no ficheiro. As restrições do TikTok descrevem o vídeo como conteúdo áudio-vídeo, pelo que uma banda sonora misturada sai com ele; use áudio sobre o qual tenha direitos.
- Enviar um rascunho. Com
upload_to_draftouis_drafte o âmbito video.upload, a publicação chega à caixa de entrada do criador no TikTok, para editar e publicar na aplicação. - Deixar o TikTok escolher nas publicações de fotos.
auto_add_musicadiciona música recomendada, e o proprietário pode trocá-la mais tarde na aplicação TikTok. - O risco com áudio misturado: a lista de publicações do TikTok refere as violações de direitos de autor musicais entre os motivos prováveis para uma publicação ser filtrada.
Como se vê se um som trouxe visualizações?
Através de impression_sources, um campo de /business/video/list/ que classifica por onde chegaram os espectadores de uma publicação; um dos valores é Sound, para visualizações vindas de páginas de sons. Precisa do âmbito video.insights e, como as outras contagens, chega com 24 a 48 horas de atraso. Através da easyCoexistence, get_social_insights devolve-o para uma das 20 publicações mais recentes da conta, quando impression_sources é indicado em metrics, com o item_id da publicação como object_id.
O que faz a easyCoexistence com música?
Publica o som que já está no seu ficheiro. publish_tiktok_post, agora ou com scheduled_at, envia a legenda, o título de uma publicação de fotos e a opção de comentários, sem music_sound_info nem auto_add_music, pelo que um vídeo mantém a sua banda sonora e uma publicação de fotos sai sem música. O seu próprio código pode fazer POST para business/video/publish/ com music_sound_info e o token de get_social_credentials, mas esse corpo de pedido chega ao TikTok tal como foi escrito, incluindo video_url, e o TikTok só obtém conteúdo multimédia de domínios ou prefixos de URL verificados para a aplicação. Os caminhos /discovery/ recebem o token de um anunciante, pelo que a lista de faixas está fora do alcance do token da conta.
Erros comuns
- Deixar de fora video_original_sound_volume ao adicionar uma faixa. Pela API, o valor predefinido é 0, enquanto a aplicação TikTok começa ambos os sons em 50, por isso defina-o sempre que o áudio original do vídeo importe.
- Passar o nome ou o preview_url de uma faixa como music_sound_id. A referência de faixas do TikTok indica song_clip_id, de full_duration_song_clip ou trending_song_clip, como o valor a passar.
- Chamar /discovery/cml/trending_list/ com um token de anunciante. Os endpoints de faixas recebem o token de uma conta TikTok e o business_id, tal como a Accounts API.
- Ler uma duração de 0 como uma faixa com defeito. O TikTok refere que uma faixa que é apenas um excerto de uma peça mais longa pode mostrar 0, por isso verifique a pré-visualização antes de escolher início e fim.
A partir de US$ 9 por ligação por mês, descendo até US$ 0.75 à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Posso adicionar qualquer música a uma publicação do TikTok através da API?
Só músicas da Commercial Music Library, pelo ID. A música já misturada num ficheiro de vídeo sai com o ficheiro, por isso deve ser música sobre a qual tenha direitos de utilização.
Que volume a API do TikTok define para a música adicionada?
0 por predefinição. music_sound_volume e video_original_sound_volume vão de 0 a 100 e ambos têm 0 por predefinição pela API, enquanto a aplicação TikTok começa em 50; defina-os em cada vídeo com uma faixa.
Importa a música de uma publicação se ela for usada mais tarde num anúncio?
O TikTok verifica-o: /identity/music/authorization/ indica, para os locais e as datas de exibição do anúncio, se a música da publicação está totalmente autorizada, se falta autorização ou se não tem ID de música.
Quantas músicas tem a Commercial Music Library do TikTok?
1 milhão, segundo o Centro de Ajuda para Empresas do TikTok, todas previamente autorizadas para uso comercial. /discovery/cml/trending_list/ devolve até 100 das mais populares de cada vez.
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