Você precisa transformar vídeos específicos do YouTube em áudio para download esta semana—sem truques de navegador, sem engenharia reversa, apenas uma API estável que você pode enviar para produção. Ao final deste guia, você será capaz de converter programaticamente um vídeo do YouTube (≈5 minutos ou menos) em um arquivo de áudio, recuperar o link direto do MP3 e integrá-lo ao seu fluxo de trabalho de mídia usando a API de Vídeo do Youtube para Áudio no Zyla API Hub.
O que esta API faz e quando usá-la
A API de Vídeo do Youtube para Áudio converte um vídeo do YouTube (identificado pelo seu ID de vídeo) em um arquivo de áudio e retorna uma URL direta que você pode baixar. Usos típicos incluem:
- Extraindo áudio para transcrição ou pipelines de NLP.
- Criando prévias de áudio para moderação de conteúdo ou ferramentas de revisão interna.
- Potencializando fluxos de trabalho de mídia onde a trilha de áudio é necessária independentemente do vídeo.
A API retorna um payload JSON com o link de áudio, título do vídeo, tamanho do arquivo e status da conversão, tornando simples automatizar o pós-processamento, como armazenamento, etiquetagem ou ingestão a jusante.
Começando no Zyla API Hub
O Zyla API Hub é um marketplace com mais de 10.000 APIs públicas sob uma única conta, uma chave de API e um único modelo de assinatura. Para esta API, você se autentica com um cabeçalho Authorization: Bearer YOUR_API_KEY. A cobrança é por assinatura + cota, não por chamada. Sem plano gratuito. A API de Vídeo do Youtube para Áudio oferece um teste de 7 dias que você pode começar diretamente na página de listagem.
Abra a listagem e comece seu teste aqui: Comece o teste de 7 dias na API de Vídeo do Youtube para Áudio.
Visão geral do endpoint
A API expõe um único endpoint para converter um vídeo do YouTube em áudio. Mantenha os vídeos com cerca de 5 minutos ou menos para garantir uma conversão bem-sucedida.
- Endpoint: Obter Áudio
- Método: GET
- URL: https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio
- Parâmetro de consulta necessário:
- id (string): O ID do vídeo do YouTube (ex: p-Z3YrHJ1sU)
Importante: Passe sua chave de API no cabeçalho Authorization. A resposta retorna um objeto JSON contendo o link direto para o MP3 gerado, o título original, o tamanho do arquivo em bytes, o progresso da conversão, a duração em segundos e os campos de status/mensagem.
Início rápido: requisição cURL
Use esta requisição exata para testar o fluxo. Substitua YOUR_API_KEY pela sua chave ativa da listagem do Zyla API Hub.
curl -s -X GET "https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio?id=p-Z3YrHJ1sU" \
-H "Authorization: Bearer YOUR_API_KEY"Resposta de exemplo 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_%20USA%20to%20INDIA_%20%23shorts%20%23youtubeshorts&uT=R&uN=QWxlam9aeWxhTGFicw%3D%3D",
"title": "₹1,07,000 *iPhone 16 Pro Max* USA to INDIA! #shorts #youtubeshorts",
"filesize": 417480,
"progress": 100,
"duration": 22.896054233758,
"status": "ok",
"msg": "success"
}O que você normalmente lerá deste payload:
- link: URL direta do MP3 que você pode baixar ou transmitir.
- title: Título original do YouTube (útil para nomeação ou metadados).
- filesize: Tamanho em bytes (valide contra limites de armazenamento).
- progress: Percentual de conclusão. Espere 100 quando estiver pronto.
- duration: Duração em segundos (float), útil para validação/UX.
- status/msg: Status operacional e mensagem. Verifique se está "ok" e "success" antes de baixar.
Exemplo em Python: converter e baixar o MP3
Este exemplo chama o endpoint, valida a resposta e baixa o MP3 para o armazenamento local. Substitua YOUR_API_KEY pela sua chave e altere o video_id conforme necessário.
import os
import sys
import time
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
VIDEO_ID = "p-Z3YrHJ1sU" # ID do vídeo do YouTube
BASE_URL = "https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio"
headers = {"Authorization": f"Bearer {API_KEY}"}
def get_audio_json(video_id: str) -> dict:
params = {"id": video_id}
r = requests.get(BASE_URL, headers=headers, params=params, timeout=30)
r.raise_for_status()
return r.json()
def download_file(url: str, dest_path: str):
with requests.get(url, stream=True, timeout=60) as r:
r.raise_for_status()
with open(dest_path, "wb") as f:
for chunk in r.iter_content(chunk_size=8192):
if chunk:
f.write(chunk)
def main():
try:
data = get_audio_json(VIDEO_ID)
except requests.HTTPError as e:
print(f"Erro HTTP: {e}", file=sys.stderr)
sys.exit(1)
status = data.get("status")
msg = data.get("msg")
progress = data.get("progress")
link = data.get("link")
title = data.get("title")
filesize = data.get("filesize")
duration = data.get("duration")
if status != "ok" or msg != "success" or progress != 100 or not link:
print(f"Conversão não está pronta ou falhou. status={status} msg={msg} progress={progress}", file=sys.stderr)
sys.exit(2)
# Nome básico do arquivo: sanitize title para evitar problemas de caminho
safe_title = "".join(c for c in title if c.isalnum() or c in (" ", "-", "_")).rstrip()
filename = f"{safe_title or VIDEO_ID}.mp3"
print(f"Título: {title}")
print(f"Duração (s): {duration}")
print(f"Tamanho do arquivo (bytes): {filesize}")
print(f"Baixando para: {filename}")
try:
download_file(link, filename)
print("Download completo.")
except requests.HTTPError as e:
print(f"Falha ao baixar o arquivo: {e}", file=sys.stderr)
sys.exit(3)
if __name__ == "__main__":
main()Notas:
- id espera apenas o ID do vídeo do YouTube (o token curto em uma URL de visualização). Por exemplo, de https://www.youtube.com/watch?v=p-Z3YrHJ1sU, passe p-Z3YrHJ1sU.
- Verifique se progress == 100, status == "ok" e msg == "success" antes de baixar.
- Use o filesize e duration retornados para validar regras de negócios (por exemplo, rejeitar arquivos longos, impor cotas de armazenamento).
Detalhes de integração prática que economizam tempo
- Orientação sobre a duração do YouTube: Use vídeos com cerca de 5 minutos ou menos; vídeos mais longos podem não ser processados com sucesso.
- Lógica de nova tentativa: Se sua primeira chamada retornar um status que não está pronto, implemente um pequeno tempo de espera e tente novamente, respeitando sua cota de assinatura.
- Manipulação de arquivos: O link é uma URL direta do MP3. Baixe-o imediatamente ou passe-o para sua camada de armazenamento (S3, GCS, etc.). Evite hotlinking em produção—cache ou armazene o áudio para confiabilidade.
- Metadados: Use o título para nomes de arquivos, mas sempre sanitize para compatibilidade com o sistema de arquivos.
- Durações e UX: Mostre o tempo restante ou um ETA aproximando o filesize/bitrate se você também gerenciar a interface de streaming.
- Segurança: Mantenha sua chave de API no lado do servidor. Nunca a exponha no código do lado do cliente.
- Consciência de cota: O marketplace usa um modelo de assinatura + cota. Monitore o uso para evitar cenários inesperados de 429/límite.
Fluxos de trabalho e casos de uso comuns
Pipeline de fala para texto
Converta um curto vídeo explicativo do YouTube em MP3, e então envie o arquivo para seu serviço de transcrição. Use a duração para rejeitar uploads acima do seu limite de reconhecimento de fala antes de pagar custos de computação a jusante.
Recortes e prévias de podcast
Busque o áudio de clipes curtos para revisão editorial. Armazene o nome do arquivo como um slug derivado do título e use o filesize para estimar os tempos de transferência ao renderizar prévias.
Ferramentas de conformidade ou moderação
Gere ativos apenas de áudio para classificação baseada em ML. Mantenha o título como um rótulo e armazene o timestamp de recuperação do link para trilhas de auditoria.
Backup de mídia para ingestão de CMS
Para artigos que incorporam um vídeo, armazene o áudio ao lado do post para recursos de acessibilidade (versões apenas de áudio). Valide a duração contra a política de comprimento máximo do seu CMS.
MCP: chame esta API de agentes de IA
Se você construir com agentes de codificação de IA ou copilotos integrados ao IDE, pode direcionar chamadas através do endpoint MCP do Zyla, que funciona com clientes como Claude Code, Cursor e Windsurf. Configure seu agente para chamar o endpoint do marketplace via MCP usando sua chave de API. Para referência, veja: MCP. O agente deve emitir uma requisição GET para o endpoint Get Audio da API de Vídeo do Youtube para Áudio com o parâmetro id necessário e o cabeçalho Authorization: Bearer YOUR_API_KEY. Sua ferramenta pode então analisar link, title, filesize e duration para decidir se deve baixar ou passar a URL adiante.
Tratamento de erros e resiliência
- Validação de parâmetros: Certifique-se de que id está presente e é um ID de vídeo do YouTube válido. Remova espaços em branco e restos de consulta de URL antes de enviar.
- Verificações de status: Não assuma sucesso—confirme status, msg e progress. Trate respostas HTTP não-200 com novas tentativas onde apropriado.
- Timeouts: As requisições de rede tanto para o endpoint JSON quanto para o link MP3 retornado devem ter timeouts razoáveis (por exemplo, 30–60 segundos).
- Cache: Armazene a resposta JSON ao lado do seu arquivo baixado para que você possa exibir o título e a duração precisos sem chamar a API novamente para o mesmo ID de vídeo.
- Throughput: Se você estiver processando em lote, escalone as requisições para respeitar as cotas de assinatura e evitar sobrecarregar o armazenamento a jusante.
Dicas de teste
- Use um vídeo curto conhecido: Mantenha o vídeo de teste com menos de 1 minuto para acelerar as verificações de ponta a ponta.
- Higiene do sistema de arquivos: Substitua caracteres como barras, dois pontos ou emojis no título retornado para evitar erros em sistemas de arquivos Windows/macOS.
- Aserções: Verifique progress == 100 e que filesize é maior que zero antes de gravar no disco.
- Observabilidade: Registre id, status, msg, duration e filesize para triagem se os usuários relatarem áudio ausente ou corrompido.
Referência: Detalhes do endpoint
Obter Áudio
- Método: GET
- URL: https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio
- Parâmetros de consulta:
- id (string, obrigatório): ID do vídeo do YouTube (exemplo: p-Z3YrHJ1sU)
- Cabeçalhos:
- Authorization: Bearer YOUR_API_KEY
- Descrição: Converte o vídeo do YouTube dado (≈5 minutos ou menos recomendado) em áudio e retorna JSON com um link MP3 direto e metadados.
Checklist de ponta a ponta para produção
- Obtenha sua chave de API da listagem do Zyla e armazene-a de forma segura (variável de ambiente ou gerenciador de segredos).
- Implemente a chamada GET com o parâmetro id e o cabeçalho Authorization.
- Verifique status/msg/progress antes de tentar baixar o arquivo.
- Sanitize e persista title, duration e filesize junto com o ativo de áudio.
- Adicione novas tentativas com tempo de espera; monitore sua cota de assinatura.
- Escreva testes de integração contra um ID de vídeo curto e estável.
- Conecte logs e alarmes para erros HTTP e formatos de resposta inesperados.
FAQ
O que eu passo como parâmetro id?
Passe o ID do vídeo do YouTube, não a URL completa. De https://www.youtube.com/watch?v=p-Z3YrHJ1sU, use p-Z3YrHJ1sU.
Qual é a duração máxima do vídeo?
O endpoint observa que os vídeos devem ter aproximadamente 5 minutos ou menos de duração.
Como eu me autentico?
Use o cabeçalho: Authorization: Bearer YOUR_API_KEY. As chaves são emitidas após você se inscrever na API no Zyla API Hub.
Quais campos confirmam uma conversão bem-sucedida?
Verifique se status == "ok", msg == "success", progress == 100 e que link está presente antes de tentar baixar.
Isso é pago por chamada?
Não. O Zyla API Hub usa um modelo de assinatura + cota. Verifique a página da API para opções de acesso atuais e detalhes de preços.
Pronto para enviar? Comece seu teste de 7 dias e obtenha sua chave de API na listagem: Comece o teste de 7 dias na API de Vídeo do Youtube para Áudio. Construa seu pipeline de mídia com uma única assinatura em milhares de APIs no Zyla API Hub.
