Adicionar música aos Reels do Instagram através da API
A Audio API do Instagram associa música a um Reel quando o seu contentor é criado: GET /ig_audio encontra sons originais ou música autorizada para uso por terceiros, e audio_configuration no contentor REELS define a faixa e o seu volume. Funciona com Facebook Login ou Unified Login. Com Instagram Login, o som do Reel é o áudio já presente no seu ficheiro de vídeo.
O easyCoexistence publica Reels com publish_instagram_post a partir de Claude, ChatGPT ou do seu próprio código, agora ou a partir da sua fila de agendamento, com a música que misturou no vídeo.
Quando a Meta introduziu a Audio API do Instagram, para encontrar sons originais e música da Sound Collection e associá-los a Reels.
A Audio API da Meta funciona com Facebook Login e Unified Login, e não é suportada na API do Instagram com Instagram Login.
O intervalo de audio_volume e video_volume em audio_configuration; ambos assumem 100 por defeito, volume total.
Quantas vezes o áudio de um Reel pode ser renomeado com audio_name: na criação, ou mais tarde na página de áudio.
Músicas e sons da Sound Collection da Meta, isentos de royalties e utilizáveis em Reels e para fins comerciais, como anúncios.
O valor media_audio_type para música licenciada do catálogo da Meta; ORIGINAL_SOUND assinala áudio original.
O que a API do Instagram permite para o áudio de um Reel?
Cinco coisas, consoante o login. Um Reel parte do áudio que o seu ficheiro de vídeo contém, e o resto assenta nisso:
- O áudio do próprio ficheiro: AAC, até 48 kHz, mono ou estéreo, a 128 kbps, segundo a especificação de Reels da Meta.
audio_name: um nome para o áudio do Reel, que pode ser definido uma vez.- A Audio API: pesquisar sons originais e música e associar um deles com
audio_configuration; apenas Facebook Login e Unified Login. media_audio_type: indica se um Reel publicado usa MUSIC ouORIGINAL_SOUND.- Deteção de direitos de autor: correspondências encontradas no áudio ou na imagem de um vídeo, com Facebook Login e Unified Login.
Como funciona audio_name?
Dá nome ao áudio de um Reel. audio_name vai no contentor REELS com o vídeo, e a referência da Meta fixa uma regra: o áudio só pode ser renomeado uma vez, na criação do Reel ou depois, na respetiva página de áudio na aplicação. A Meta indica-o apenas para Reels, sem o associar a um login, e acrescenta uma limitação dos Reels: a marcação de música só está disponível para áudio original.
O que é a Audio API do Instagram?
A forma da Meta de colocar uma faixa num Reel a partir de código, introduzida a 1 de junho de 2026. GET /ig_audio com audio_type definido como music ou original_sound e o user_id da conta pesquisa o catálogo; um search_query restringe a pesquisa e, sem consulta, devolve áudio em tendência. Cada resultado traz um audio_id, um título e duration_in_ms, e display_artist no caso da música. As chamadas exigem instagram_basic e instagram_content_publish, através de Facebook Login ou Unified Login.
Como se associa uma faixa a um Reel?
No contentor REELS, na mesma chamada que define video_url. audio_configuration é um objeto JSON com o audio_id obtido na pesquisa, além de audio_volume para a faixa e video_volume para o som próprio do vídeo, cada um de 1 a 100 e 100 por defeito, para que os dois se possam equilibrar. O contentor é depois publicado com media_publish, como qualquer Reel.
POST https://<HOST_URL>/v26.0/<IG_ID>/media
media_type=REELS
video_url=https://cdn.example.com/reels/new-menu.mp4
audio_configuration={"audio_id":"<AUDIO_ID>","audio_volume":80,"video_volume":40}
access_token=<ACCESS_TOKEN>
POST https://<HOST_URL>/v26.0/<IG_ID>/media_publish
creation_id=<IG_CONTAINER_ID>
access_token=<ACCESS_TOKEN>A API pode adicionar músicas da biblioteca de música do Instagram?
Apenas o que a Meta autoriza para as aplicações. A Audio API devolve áudio autorizado para uso por terceiros, e a Meta indica que a sua seleção pode ser diferente da que a aplicação oferece. O Centro de Ajuda do Instagram acrescenta que a biblioteca licenciada se destina a uso pessoal e não comercial, que certas contas comerciais e certos tipos de publicações não têm acesso a ela, e que a música licenciada pode estar indisponível em alguns países ou regiões.
O que acontece à música com direitos de autor dentro do ficheiro de vídeo?
A Meta verifica. Com Facebook Login ou Unified Login, copyright_check_status num contentor indica se a verificação foi feita e encontrou correspondências, e copyright_check_information num vídeo publicado lista os segmentos encontrados, assinalados como AUDIO ou VIDEO, com a política do titular, como BLOCK ou MUTE em países indicados. A Meta também omite media_url no vídeo com áudio protegido ou licenciado, incluindo áudio da própria biblioteca do Instagram, enquanto os restantes campos voltam normalmente.
Como saber que áudio usa um Reel?
Leia media_audio_type no Reel publicado. GET /<IG_MEDIA_ID>?fields=media_audio_type devolve MUSIC, música licenciada do catálogo da Meta, ou ORIGINAL_SOUND, áudio original. A Meta acrescentou o campo a 1 de junho de 2026 e devolve-o para conteúdos de vídeo, como os Reels, e não para fotos ou carrosséis; a referência da Meta não o liga a um único login.
O que funciona com Instagram Login?
O áudio do ficheiro. Um Reel publicado com Instagram Login soa como o seu vídeo, por isso a música tem de entrar na edição antes do envio, codificada em AAC até 48 kHz e 128 kbps, e apenas música que a empresa tenha direito a usar. A Sound Collection da Meta é o catálogo que o Centro de Ajuda do Instagram descreve como isento de royalties, seguro para usar em Reels e utilizável para fins comerciais, como anúncios.
Como publica o easyCoexistence um Reel com música?
Com a música já no vídeo. publish_instagram_post recebe o video_url e a legenda do Reel de Claude, ChatGPT ou do seu próprio código, agora ou com scheduled_at, e o Instagram publica-o com o áudio do próprio ficheiro. O easyCoexistence liga-se através de Instagram Login, onde a Meta não oferece a Audio API. A ferramenta não aceita audio_name, pelo que o áudio é nomeado na aplicação do Instagram.
Erros comuns
- Chamar GET /ig_audio a partir de uma aplicação com Instagram Login. A Meta suporta a Audio API apenas com Facebook Login e Unified Login.
- Manter download_url como ficheiro da faixa. É uma ligação de pré-visualização temporária que expira após cerca de 1.5 dias, e pode ser null.
- Esperar uma pré-visualização antes de publicar. A Meta não suporta a pré-visualização de um Reel com áudio associado, que é publicado tal como configurado; por isso, verifique primeiro o audio_id e os volumes.
De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Posso adicionar música em tendência a um Reel através da API?
Com Facebook Login ou Unified Login, sim: GET /ig_audio sem search_query devolve áudio em tendência, e o seu audio_id vai para audio_configuration. O Instagram Login não tem chamada equivalente.
Porque é que a minha conta comercial não pode usar algumas músicas nos Reels?
O Centro de Ajuda do Instagram diz que certas contas comerciais e certos tipos de publicações não têm acesso à biblioteca de música licenciada, destinada a uso pessoal e não comercial. A Sound Collection da Meta é a alternativa isenta de royalties.
Pode uma faixa da Audio API ser usada num anúncio?
Apenas quando is_ads_eligible o indicar: a Meta devolve este indicador anulável em cada resultado da Audio API para dizer se o recurso de áudio pode ser usado em anúncios.
Quanto custa o easyCoexistence para publicar Reels do Instagram?
Cada conta do Instagram conta como uma ligação, a US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
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