Como Usar a API de Vídeo do Youtube para Áudio

Você tem uma URL do YouTube, precisa de um link MP3 e precisa disso em produção esta semana. Ao final deste artigo, você saberá exatamente como chamar um único endpoint que converte um vídeo do YouTube (≈5 minutos ou menos) em um arquivo de áudio, analisar a resposta e enviá-lo por trás de uma bandeira de recurso.

O que esta API faz e quando usá-la

A API de Vídeo do Youtube para Áudio converte um vídeo do YouTube em um arquivo de áudio e retorna um link para download, além de metadados básicos. Fluxos de trabalho de mídia típicos que se beneficiam disso incluem:

Ilustração: Como Usar a API de Vídeo do Youtube para Áudio

Extraindo áudio para segmentos de podcast, intros/outros ou destaques.
Gerando prévias apenas de áudio para bibliotecas de conteúdo.
Preparando faixas de voz para transcrição ou pipelines de moderação.
Construindo ferramentas internas que agregam mídia de formato curto em playlists de áudio.

A API está disponível no Zyla API Hub, que fornece uma única conta, uma chave de API e um modelo de cobrança de assinatura + cota em milhares de APIs. Para esta listagem, você pode iniciar um teste de 7 dias na página do produto.

Começando no Zyla API Hub

Abra a página da API, clique em Assinar ou Iniciar Teste Gratuito quando disponível, e copie sua chave de API do painel. Todas as solicitações usam o cabeçalho Authorization com um token Bearer.

Iniciar teste de 7 dias na API de Vídeo do Youtube para Áudio

Autenticação: Authorization: Bearer SUA_CHAVE_API
Faturamento: assinatura + cota (não pago por chamada). Verifique a página da API para opções de acesso e preços atuais.

Visão geral do endpoint

Esta API expõe um único endpoint que você pode conectar rapidamente:

Obter Áudio (GET) — converte um vídeo do YouTube especificado em áudio e retorna um link e metadados.

Obter Áudio

Método: GET
URL: https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio
Parâmetro de consulta obrigatório:
- id (string): O ID do vídeo do YouTube a ser convertido. Exemplo: p-Z3YrHJ1sU
Nota: Os vídeos devem ter aproximadamente 5 minutos ou menos de duração.

cURL: uma solicitação que resolve o problema

Copie, cole, execute. Substitua SUA_CHAVE_API pela sua chave se quiser testar imediatamente.

curl -s -X GET "https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio?id=p-Z3YrHJ1sU"
-H "Authorization: Bearer SUA_CHAVE_API"

Exemplo de resposta oficial

{
"link": "https://eta.123tokyo.xyz/get.php/9/9e/ty7nkwYqodA.mp3?cid=MmEwMTo0Zjg6YzAxMjozMmVlOjoxfE5BfERF&h=FwrcvY5cIfOO0jyXh5C-6Q&s=1737705748&n=%E2%82%B91%2C07%2C000%20_iPhone%2016%20Pro%20Max_%20EUA%20para%20ÍNDIA_%20%23shorts%20%23youtubeshorts&uT=R&uN=QWxlam9aeWxhTGFicw%3D%3D",
"title": "₹1,07,000 *iPhone 16 Pro Max* EUA para ÍNDIA! #shorts #youtubeshorts",
"filesize": 417480,
"progress": 100,
"duration": 22.896054233758,
"status": "ok",
"msg": "success"
}

Destaques dos campos que você realmente usará:

link: URL direta para o arquivo de áudio gerado. Use isso para baixar ou transmitir.
title: Título do vídeo do YouTube de origem (útil para nomes de arquivos ou rótulos de UI).
filesize: Tamanho do arquivo de áudio (valor numérico conforme retornado pela API).
duration: Duração do clipe de áudio (valor numérico conforme retornado pela API).
progress: 100 indica que o áudio está pronto para download.
status e msg: Verificação rápida de sucesso/erro.

Exemplo em Python: buscar e persistir a URL do áudio

Este exemplo chama o mesmo endpoint, valida status/progresso e imprime o link de áudio e metadados. É minimalista por design para que você possa colá-lo em um script ou trabalho.

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "SUA_CHAVE_API")
VIDEO_ID = "p-Z3YrHJ1sU"

url = "https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
params = {
"id": VIDEO_ID
}

resp = requests.get(url, headers=headers, params=params, timeout=60)
resp.raise_for_status()
data = resp.json()

# Verificações básicas de saúde
if data.get("status") != "ok" or data.get("progress") != 100:
raise SystemExit(f"Conversão não pronta ou falhou: {data}")

audio_link = data.get("link")
title = data.get("title")
duration = data.get("duration")
filesize = data.get("filesize")

print("URL do Áudio:", audio_link)
print("Título:", title)
print("Duração:", duration)
print("Tamanho do arquivo:", filesize)

# Opcional: baixar para um arquivo local (streaming)
if audio_link:
r = requests.get(audio_link, stream=True, timeout=120)
r.raise_for_status()
# Derive um nome de arquivo simples do título; personalize conforme necessário.
filename = "output.mp3"
with open(filename, "wb") as f:
for chunk in r.iter_content(chunk_size=8192):
if chunk:
f.write(chunk)
print("Salvo:", filename)

Notas de integração do mundo real

Duração do vídeo: O endpoint é projetado para vídeos com aproximadamente 5 minutos ou menos. Aplique essa restrição em sua UI ou camada de trabalho antes de chamar a API.
Idempotência pelo ID do YouTube: Se você espera solicitações repetidas para o mesmo clipe, faça cache pelo ID do vídeo do YouTube. Você também pode persistir o link retornado se seu fluxo de trabalho baixar imediatamente.
Tratamento de progresso: A resposta inclui um campo de progresso. No exemplo mostrado, é 100 quando o áudio está disponível. Para fluxos simples, chame uma vez e prossiga quando o progresso for igual a 100.
Tentativas e retrocesso: Para trabalhos em segundo plano, adicione tentativas em erros de rede transitórios ao chamar o endpoint do Zyla Hub e ao baixar do link retornado.
Tratamento de conteúdo: Use o campo título para rotular arquivos ou linhas de UI. Sanitizar para nomes de arquivos ao gravar no disco.

Casos de uso que você pode implementar rapidamente

Botões de clipe para áudio em ferramentas editoriais: Cole um ID do YouTube, clique em Converter, receba uma URL de streaming de volta.
Geração automatizada de prévias: Para envios de mídia curtos, converta para áudio para filas de moderação rápidas.
Arquivista de áudio para conteúdo de formato curto: Ingestão periódica de um conjunto de IDs de vídeo de canal e armazenamento de artefatos de áudio.
Pré-processamento de transcrição: Converta vídeos curtos em áudio antes de passar para seu pipeline de fala para texto.

Chamando via agentes de IA usando MCP

Se você usar Claude Code, Cursor, Windsurf ou outro cliente compatível com MCP, pode permitir que o agente chame as APIs do Zyla roteando solicitações através do gateway MCP. Aponte o cliente para o endpoint MCP e passe sua chave de API:

Gateway: https://mcp.zylalabs.com/mcp?apikey=SUA_CHAVE_API

A partir daí, instrua seu agente a fazer uma solicitação GET para o exato endpoint do Hub mostrado acima, incluir o cabeçalho Authorization com sua chave e fornecer o parâmetro de consulta id. Para segurança, mantenha sua chave de API no armazenamento secreto do agente e evite registrar cabeçalhos sensíveis.

MCP

Dicas operacionais

Cabeçalhos: Sempre envie Authorization: Bearer SUA_CHAVE_API para o endpoint do Zyla Hub.
Timeouts: O tempo de rede varia; configure timeouts sensatos tanto para a chamada da API quanto para o download do arquivo subsequente.
Armazenamento: Se você precisar de acesso persistente, baixe o arquivo quando receber o link e armazene-o em seu bucket de armazenamento. Não assuma que links de terceiros são permanentes.
Monitoramento: Registre status, msg e valores de progresso para detectar falhas precocemente em trabalhadores de lote ou fila.
Quotas: O hub usa um modelo de assinatura + cota. Acompanhe seu uso; se você esperar picos, revise seu plano na página de listagem.

Fluxo de ponta a ponta que você pode implementar hoje

Obtenha uma chave de API na página de listagem e armazene-a em sua configuração ou gerenciador de segredos.
Aceite um ID de vídeo do YouTube em sua UI ou fila de trabalho. Valide as restrições de comprimento a montante quando puder.
Chame GET https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio com o parâmetro id e o cabeçalho Authorization.
Verifique se status == "ok" e progress == 100.
Consuma o link para download ou streaming. Salve em seu armazenamento se precisar de acesso durável.
Use title, duration e filesize para UI, registro e sinais de QA.

FAQ

Qual parâmetro eu passo para converter um vídeo?
Passe o ID do vídeo do YouTube usando o parâmetro de consulta id (exemplo: p-Z3YrHJ1sU) para o endpoint Obter Áudio.

Qual é a URL e o método do endpoint?
GET https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio

Como faço para autenticar?
Inclua o cabeçalho Authorization: Bearer SUA_CHAVE_API em cada solicitação para o endpoint do Zyla Hub.

Há um limite de duração de vídeo?
Sim. Os vídeos devem ter aproximadamente 5 minutos ou menos de duração.

O que significa progresso?
A resposta inclui um campo de progresso numérico. Um valor de 100 indica que o áudio está pronto para download.

Envie isso

Você só precisa de uma solicitação GET para converter um ID de vídeo do YouTube em um link de áudio para download. Crie sua conta, obtenha uma chave de API e conecte-a ao seu fluxo de trabalho de mídia hoje através da página de listagem: Iniciar teste de 7 dias na API de Vídeo do Youtube para Áudio.