Trabalhando com a API Youtube para Áudio

Você tem um recurso de mídia para entregar: dado um link ou ID do YouTube, retorne um MP3 para download e exiba metadados básicos (título, duração, tamanho). Ao final deste guia, você chamará a API Youtube para Áudio do Zyla API Hub para buscar um link de áudio direto e integrá-lo ao pipeline do seu aplicativo com um fluxo de trabalho mínimo e amigável para produção.

O que a API Youtube para Áudio faz

A API Youtube para Áudio converte um vídeo do YouTube em um arquivo de áudio e retorna um link de download direto junto com campos úteis como título, duração e tamanho do arquivo. As equipes a utilizam para alimentar ferramentas de podcasting, captura de notas de áudio, recursos de reprodução offline e pipelines de ingestão de mídia onde a faixa de áudio é o único ativo necessário.

Ilustração: Trabalhando com a API Youtube para Áudio

No Zyla API Hub, esta API está disponível sob um modelo de assinatura e cota única (sem pagamento por chamada). A primeira API à qual você se inscreve no Hub geralmente oferece um teste de 7 dias ou 50 solicitações; verifique a listagem para o teste atual. Cada API que você usa no Zyla é acessada com a mesma conta e chave de API.

Começando no Zyla API Hub

Abra a listagem da API Youtube para Áudio no Zyla, clique em Inscrever-se ou inicie o teste disponível e pegue sua chave. Sua chave vai no cabeçalho de Autorização como um token Bearer. As chamadas são feitas através das URLs do Hub do Zyla, não de um domínio de terceiros.

Iniciar teste de 7 dias na API Youtube para Áudio

Endpoints que você pode entregar esta semana

A API expõe dois endpoints GET através das URLs do Hub do Zyla. A autenticação é baseada em cabeçalho com Authorization: Bearer YOUR_API_KEY.

1) Obter Áudio

Método: GET
URL: https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio
O que faz: Recebe um ID de vídeo do YouTube e retorna um link de download MP3 direto e metadados.
Parâmetros de consulta obrigatórios:
- id (string): ID do vídeo do YouTube. Exemplo: xFYQQPAOz7Y

Curl oficial (copiar/colar):

curl -s -X GET "https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio?id=xFYQQPAOz7Y" \
-H "Authorization: Bearer YOUR_API_KEY"

Resposta de exemplo oficial:

{
"msg": "success",
"link": "https://theta.123tokyo.xyz/get.php/d/fa/xFYQQPAOz7Y.mp3?n=Eminem%20-%20Lose%20Yourself&uT=R&uN=QWxlam9aeWxhTGFicw%3D%3D&h=TcO7xrzRPZ9cGbw2wXP93w&s=1784312338&uT=R&uN=QWxlam9aeWxhTGFicw%3D%3D",
"status": "ok",
"duration": 327.49718169275,
"title": "Eminem - Lose Yourself",
"progress": 100,
"pc": 0,
"filesize": 4181397
}

O que você realmente usará:

link: URL direta para o arquivo MP3 gerado. Use isso para baixar ou transmitir.
title: Título do vídeo legível por humanos.
duration: Duração do áudio em segundos (ponto flutuante).
filesize: Tamanho do arquivo em bytes.
status e msg: Campos de verificação rápida de saúde; espere "ok" e "success" em caso de sucesso.
progress e pc: Indicadores de progresso que você pode registrar ou ignorar uma vez que o progresso seja 100.

2) Baixar Áudio

Método: GET
URL: https://zylalabs.com/api/381/youtube-to-audio-api/22174/download-audio
O que faz: Recebe uma URL completa do vídeo do YouTube e retorna um link de áudio para download.
Parâmetros de consulta obrigatórios:
- url (string): URL completa de visualização do YouTube. Exemplo: https://www.youtube.com/watch?v=_Yhyp-_hX2s

Este é o caminho mais fácil quando sua interface já possui uma URL completa do YouTube. Se você só tiver o ID do vídeo, use Obter Áudio.

Notas focadas em produção que economizam tempo

Autenticação: Todas as solicitações requerem Authorization: Bearer YOUR_API_KEY.
Transporte: Use as URLs do Hub HTTPS exatamente como mostrado. Não chame um host de origem.
Cache: Se você armazenar respostas em cache, armazene o link final, título, duração e tamanho do arquivo. A duração está em segundos; o tamanho do arquivo está em bytes.
Tentativas: Para erros de rede transitórios, um pequeno retrocesso exponencial é razoável. Se status ou msg indicarem um não sucesso, exiba isso para o usuário.
Cotas: O Hub usa assinatura + cota, não pagamento por chamada. A primeira API geralmente inclui um teste de 7 dias ou 50 solicitações. Veja a listagem para opções de acesso e preços atuais.

Exemplo mínimo em Python usando Obter Áudio

Este trecho solicita áudio para um dado ID de vídeo e transmite o MP3 para o disco. Ele usa o endpoint oficial Obter Áudio, então você pode colar e executar após adicionar sua chave.

import os
import sys
import json
import time
import urllib.parse
import requests

API_KEY = os.environ.get("ZYLA_API_KEY", "YOUR_API_KEY")
VIDEO_ID = "xFYQQPAOz7Y" # Substitua pelo seu ID de YouTube alvo
HUB_URL = "https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio"

def get_audio_info(video_id: str):
params = {"id": video_id}
headers = {"Authorization": f"Bearer {API_KEY}"}
r = requests.get(HUB_URL, params=params, headers=headers, timeout=30)
r.raise_for_status()
return r.json()

def download_file(url: str, out_path: str):
with requests.get(url, stream=True, timeout=60) as r:
r.raise_for_status()
with open(out_path, "wb") as f:
for chunk in r.iter_content(chunk_size=8192):
if chunk:
f.write(chunk)
return out_path

def main():
info = get_audio_info(VIDEO_ID)
# Campos esperados com base no exemplo oficial
if info.get("status") != "ok" or info.get("msg") != "success":
print("Conversão não pronta ou falhou:", json.dumps(info, indent=2))
sys.exit(1)

link = info["link"]
title = info.get("title", f"{VIDEO_ID}.mp3")
duration = info.get("duration") # segundos (float)
filesize = info.get("filesize") # bytes (int)

# Construa um nome de arquivo simples a partir do título
safe_title = "".join(c for c in title if c.isalnum() or c in (" ", "-", "_")).rstrip()
filename = f"{safe_title}.mp3"
print(f"Baixando: {title}")
print(f"Duração (s): {duration}")
print(f"Tamanho reportado (bytes): {filesize}")
print(f"Link de origem: {link}")

path = download_file(link, filename)
print(f"Salvo em: {path}")

if __name__ == "__main__":
main()

Escolhendo o endpoint certo para seu fluxo

Se sua interface captura um link completo do YouTube (URL de visualização), chame Baixar Áudio para obter uma URL de download diretamente com o parâmetro url.
Se você só tiver o ID do vídeo (por exemplo, analisado em outro lugar ou armazenado em seu banco de dados), use Obter Áudio com o parâmetro id para também recuperar metadados como duração e tamanho do arquivo.

Chamando de um agente de IA com MCP

Você pode acionar os mesmos endpoints do Hub de qualquer cliente compatível com MCP (Claude Code, Cursor, Windsurf, etc.) usando o serviço MCP do Zyla. Configure seu cliente para apontar para o MCP, passe sua chave de API do Zyla e invoque os caminhos do Hub mostrados acima. Para detalhes de configuração, veja a página MCP.

Tarefa de exemplo de ponta a ponta

Tarefa: dado um link do YouTube, armazene um MP3 e registre metadados básicos para uma biblioteca de mídia.

Analise a entrada. Se contiver uma URL de visualização completa, chame Baixar Áudio com o parâmetro url. Se você só tiver o ID do vídeo, chame Obter Áudio com id.
Em caso de sucesso, persista:
- Título (title)
- Duração em segundos (duration)
- Tamanho do arquivo em bytes (filesize)
- URL de origem e download (link)
Baixe o MP3 do link e armazene em seu armazenamento de objetos ou pasta de mídia local.
Registre um checksum se precisar de detecção de duplicatas. Use o tamanho do arquivo como uma heurística rápida para mudanças.

Considerações operacionais

Timeouts: A variabilidade da rede é uma realidade ao transferir mídia. Use timeouts e tentativas razoáveis para o passo final de download do link.
Backpressure: Se sua fila aumentar (por exemplo, muitas conversões), processe em lotes e respeite sua cota de assinatura no Zyla.
Observabilidade: Registre status, msg e progresso do Obter Áudio para identificar rapidamente problemas intermitentes.
Segurança: Mantenha sua chave de API em um armazenamento seguro ou variável de ambiente; nunca a codifique diretamente no código do lado do cliente.
Resiliência: Se você armazenar a resposta em cache, armazene tanto o título quanto a duração para que você possa renderizar metadados mesmo que espere para baixar o arquivo mais tarde.

Referência rápida

Base do Hub para esta listagem: https://zylalabs.com/api/381/youtube-to-audio-api/
Obter Áudio: GET /8884/get-audio?id=VIDEO_ID
Baixar Áudio: GET /22174/download-audio?url=YOUTUBE_WATCH_URL
Cabeçalho de autenticação: Authorization: Bearer YOUR_API_KEY
Campos de resposta que você provavelmente persistirá: link, title, duration (segundos), filesize (bytes)

Por que usar o Zyla API Hub para tarefas de mídia

O Zyla centraliza mais de 10.000 APIs públicas sob uma conta e uma chave, para que você possa adicionar recursos adjacentes sem refazer autenticação ou cobrança. A API Youtube para Áudio se encaixa nesse fluxo de trabalho com o mesmo cabeçalho de Autorização que você já usa em outros lugares no Hub. Explore mais capacidades de mídia depois, mas entregue este caminho de conversão primeiro.

Navegue pelo catálogo no Zyla API Hub e adicione APIs com cobrança consistente de assinatura + cota (sem surpresas por chamada).

FAQ

Q: Qual é a diferença entre Obter Áudio e Baixar Áudio?
A: Obter Áudio aceita um ID de vídeo e retorna o link direto mais metadados (título, duração, tamanho do arquivo). Baixar Áudio aceita uma URL completa do YouTube e retorna um link de áudio para download.

Q: Quais campos devo armazenar para uma biblioteca de mídia?
A: Armazene link (URL de download), título, duração (em segundos) e tamanho do arquivo (em bytes). Estes são retornados pelo Obter Áudio no exemplo oficial.

Q: Como faço para autenticar?
A: Adicione Authorization: Bearer YOUR_API_KEY a cada solicitação que você enviar para as URLs do Hub.

Q: Existe um plano gratuito?
A: O Hub usa assinatura + cota. A primeira API geralmente oferece um teste de 7 dias ou 50 solicitações—verifique a página da API para opções de acesso e preços atuais.

Q: Posso acionar isso de um agente de codificação de IA?
A: Sim. Configure seu cliente compatível com MCP para usar o serviço MCP do Zyla e chame os endpoints do Hub. Veja a página MCP para configuração.

Pronto para integrar isso ao seu fluxo de trabalho de mídia? Inscreva-se e pegue sua chave na listagem da API Youtube para Áudio, inicie o teste de 7 dias e entregue o recurso de conversão hoje.