Assistentes de IA

ChatGPT Video Downloader

Use o ChatGPT com a HuntAPI para descarregar vídeos, extrair áudio e obter metadados sem sair do chat. Ideal para Custom GPTs, Actions e agentes.

O que pode fazer

Colar um URL do YouTube (ou outro) no ChatGPT e obter um URL de ficheiro
Extrair só áudio (download_type=audio)
Obter título, duração e thumbnail via https://api.huntapi.com/v1/media/metadata antes do download
Acompanhar o progresso (0–100) com poll em https://api.huntapi.com/v1/jobs/{id}

Início rápido

Os downloads Hunt são assíncronos. O ChatGPT deve:

Chamar o endpoint de download → receber job_id
Fazer poll até status = CompletedJob
Devolver result.response (URL CDN) e result.metadata

Passo 1: iniciar download

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

Resposta:

{
  "job_id": "0193443f-fb80-9d19-29ba-82bc77c7cd84"
}

Passo 2: estado e progresso

GET https://api.huntapi.com/v1/jobs/0193443f-fb80-9d19-29ba-82bc77c7cd84
x-api-key: YOUR_API_KEY

Em execução:

{
  "id": "0193443f-fb80-9d19-29ba-82bc77c7cd84",
  "status": "Running",
  "progress": 63,
  "result": null
}

Concluído:

{
  "id": "0193443f-fb80-9d19-29ba-82bc77c7cd84",
  "status": "CompletedJob",
  "success": true,
  "progress": 100,
  "result": {
    "metadata": {
      "title": "Example video",
      "duration": 432,
      "thumbnail": "https://i.ytimg.com/vi/.../maxresdefault.jpg"
    },
    "response": "https://s3.huntapi.com/videos/<uuid>.mp4"
  }
}

Faça poll a cada 1–2 segundos enquanto status for Queued ou Running.

Opcional: só metadados (sem download)

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

Síncrono - devolve { "metadata": { ... } } de imediato.

Configurar ChatGPT Actions

Crie um Custom GPT → Configure → Actions → Create new action
Importe um esquema OpenAPI com:
- GET https://api.huntapi.com/v1/video/download
- GET https://api.huntapi.com/v1/jobs/{id}
- (opcional) GET https://api.huntapi.com/v1/media/metadata
Auth: header API Key x-api-key
Server URL: https://api.huntapi.com
Instrua o GPT a fazer poll até CompletedJob e partilhar o URL

Exemplo de system prompt (Custom GPT)

You are a video downloader assistant powered by HuntAPI.
When the user pastes a video URL:
1) Optionally call https://api.huntapi.com/v1/media/metadata to confirm title/duration.
2) Call /v1/video/download with query=<url>.
3) Poll /v1/jobs/{job_id} every 2 seconds until status is CompletedJob.
4) Return the CDN URL from result.response and a short summary from result.metadata.
Never invent download links. If status is Error/NotFound, explain the error clearly.

Parâmetros úteis

Param	Valores	Notas
`query`	URL	Obrigatório
`download_type`	`audio_video`, `audio`, `video`	`audio` para MP3
`video_quality`	`best`, `1080p`, `720p`, …	Vídeos longos (>1h) limitados a 720p
`video_format`	`mp4`, `webm`, `mkv`	Preferência

Relacionado

Obter chave API