Adicionando música aos Reels do Instagram pela API
A Audio API do Instagram anexa música a um Reel quando o container é criado: GET /ig_audio encontra sons originais ou músicas autorizadas para uso de terceiros, e audio_configuration no container REELS define a faixa e o volume dela. Funciona com Facebook Login ou Unified Login. Com Instagram Login, o som do Reel é o áudio já presente no arquivo 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 pela fila de agendamento, com a música que você misturou ao vídeo.
Quando a Meta introduziu a Audio API do Instagram, para encontrar sons originais e músicas da Sound Collection e anexá-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.
A faixa de valores de audio_volume e video_volume em audio_configuration; ambos têm 100 por padrão, volume total.
Quantas vezes o áudio de um Reel pode ser renomeado com audio_name: na criação ou depois, na página de áudio.
Músicas e sons da Sound Collection da Meta, livres de royalties e utilizáveis em Reels e para fins comerciais, como anúncios.
O valor media_audio_type para músicas licenciadas do catálogo da Meta; ORIGINAL_SOUND marca áudio original.
O que a API do Instagram permite para o áudio de um Reel?
Cinco recursos, dependendo do login. Um Reel começa com o áudio que o arquivo de vídeo carrega, e o restante se apoia nele:
- O áudio próprio do arquivo: AAC, até 48 kHz, mono ou estéreo, a 128 kbps, conforme 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: buscar sons originais e músicas e anexar um com
audio_configuration; somente Facebook Login e Unified Login. media_audio_type: indica se um Reel publicado usa MUSIC ouORIGINAL_SOUND.- Detecção de direitos autorais: correspondências encontradas no áudio ou na imagem de um vídeo, com Facebook Login e Unified Login.
Como funciona o audio_name?
Ele nomeia o áudio de um Reel. audio_name vai no container REELS junto com o vídeo, e a referência da Meta define uma regra: o áudio pode ser renomeado apenas uma vez, durante a criação do Reel ou depois, pela página de áudio no app. A Meta o lista só para Reels, sem o vincular a um login, e menciona uma limitação de Reels logo em seguida: 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 em um Reel a partir de código, introduzida em 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 refina a busca, e sem consulta retorna áudios em alta. Cada resultado traz um audio_id, um título e duration_in_ms, com display_artist para músicas. As chamadas exigem instagram_basic e instagram_content_publish, por Facebook Login ou Unified Login.
Como anexar uma faixa a um Reel?
No container REELS, na mesma chamada que define video_url. audio_configuration é um objeto JSON com o audio_id da busca, 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 padrão, para equilibrar os dois. O container é então 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?
Somente o que a Meta libera para os apps. A Audio API retorna áudios autorizados para uso de terceiros, e a Meta observa que sua seleção pode diferir do que o app oferece. A Central 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ção não têm acesso a ela, e que músicas licenciadas podem estar indisponíveis em alguns países ou regiões.
O que acontece com músicas protegidas por direitos autorais dentro do arquivo de vídeo?
A Meta verifica. Com Facebook Login ou Unified Login, copyright_check_status em um container informa se a verificação foi executada e encontrou correspondências, e copyright_check_information em um vídeo publicado lista os trechos correspondentes, marcados 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 biblioteca própria do Instagram, enquanto os demais campos voltam normalmente.
Como saber qual áudio um Reel usa?
Leia media_audio_type no Reel publicado. GET /<IG_MEDIA_ID>?fields=media_audio_type retorna MUSIC, música licenciada do catálogo da Meta, ou ORIGINAL_SOUND, áudio original. A Meta adicionou o campo em 1º de junho de 2026 e o retorna para mídias de vídeo, como Reels, e não para fotos ou carrosséis, e sua referência de mídia não o vincula a um login.
O que funciona com Instagram Login?
O áudio do arquivo. Um Reel publicado com Instagram Login soa como o vídeo, então a música entra na edição antes do upload, codificada em AAC a até 48 kHz e 128 kbps, e apenas músicas que a empresa tem direito de usar. A Sound Collection da Meta é o catálogo que a Central de Ajuda do Instagram descreve como livre de royalties, seguro para uso em Reels e utilizável para fins comerciais, como anúncios.
Como o easyCoexistence publica 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 o publica com o áudio próprio do arquivo. O easyCoexistence se conecta por Instagram Login, onde a Meta não oferece a Audio API. A ferramenta não recebe audio_name, então o áudio é nomeado no app do Instagram.
Erros comuns
- Chamar GET /ig_audio a partir de um app com Instagram Login. A Meta oferece suporte à Audio API somente com Facebook Login e Unified Login.
- Manter download_url como o arquivo da faixa. É um link temporário de prévia que expira após cerca de 1,5 dia, e pode ser null.
- Esperar uma prévia antes de publicar. A Meta não oferece suporte a pré-visualizar um Reel com áudio anexado, que é publicado conforme configurado; então confira antes o audio_id e os volumes.
De US$ 9 a US$ 0.75 por conexão por mês, com queda conforme você adiciona conexões, e os primeiros 3 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
Posso adicionar músicas em alta a um Reel pela API?
Com Facebook Login ou Unified Login, sim: GET /ig_audio sem search_query retorna áudios em alta, e seu audio_id vai para audio_configuration. O Instagram Login não tem chamada equivalente.
Por que minha conta comercial não pode usar algumas músicas em Reels?
A Central de Ajuda do Instagram diz que certas contas comerciais e certos tipos de publicação 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 livre de royalties.
Uma faixa da Audio API pode ser usada em anúncio?
Apenas quando is_ads_eligible indicar isso: a Meta devolve esse sinalizador anulável em cada resultado da Audio API para dizer se o ativo de áudio pode ser usado em anúncios.
Quanto custa o easyCoexistence para publicar Reels do Instagram?
Cada conta do Instagram conta como uma conexão, de US$ 9 a US$ 0.75 por conexão por mês, com queda conforme você adiciona conexões, e os primeiros 3 dias grátis.
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