Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

1 Jun 2026

Quando a Meta introduziu a Audio API do Instagram, para encontrar sons originais e música da Sound Collection e associá-los a Reels.

Not on Instagram Login

A Audio API da Meta funciona com Facebook Login e Unified Login, e não é suportada na API do Instagram com Instagram Login.

1 to 100

O intervalo de audio_volume e video_volume em audio_configuration; ambos assumem 100 por defeito, volume total.

Once

Quantas vezes o áudio de um Reel pode ser renomeado com audio_name: na criação, ou mais tarde na página de áudio.

14,000+

Músicas e sons da Sound Collection da Meta, isentos de royalties e utilizáveis em Reels e para fins comerciais, como anúncios.

MUSIC

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 ou ORIGINAL_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.

A Reel container with a track attached, then published
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.
Fazer isto com a EasyCoexistence

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