Metadados de media e progresso de jobs

Lançámos algumas atualizações de media que faltavam: inspecionar um URL sem descarregar, e ver o avanço de um download.

Media Metadata (sem download)

Precisa do título, duração, thumbnail ou canal antes de gastar um crédito de download? Chame:

GET https://api.huntapi.com/v1/media/metadata?query=https://www.youtube.com/watch?v=VIDEO_ID
x-api-key: YOUR_API_KEY

Este endpoint é síncrono. Recebe um objeto metadata na mesma resposta - sem job_id, sem polling. Custo: 1 crédito por chamada bem-sucedida.

Docs: Media Metadata API.

Use para pré-visualizar um URL, montar um catálogo ou decidir qualidade / max_duration antes de um job de download.

Progresso dos jobs de download (0–100)

Os downloads de vídeo e áudio continuam assíncronos. Novidade em GET https://api.huntapi.com/v1/jobs/{id}: o campo numérico progress:

Status	Progress
`Queued`	`0`
`Running`	`1`–`99`
`CompletedJob` / `Error` / …	`100`

Faça poll a cada 1–2 segundos enquanto o job estiver Queued ou Running. Os webhooks continuam a funcionar.

Referências atualizadas:

Modelo mental rápido

Só info → GET https://api.huntapi.com/v1/media/metadata
Ficheiro → GET https://api.huntapi.com/v1/video/download (ou /v1/audio/download) → poll /v1/jobs/{id}

Crie uma chave em app.huntapi.com e teste primeiro uma chamada de metadata - a forma mais barata de confirmar que um URL serve.