Asistentes de IA

ChatGPT Video Downloader

Usa ChatGPT con HuntAPI para descargar vídeos, extraer audio y obtener metadatos sin salir del chat. Ideal para Custom GPTs, Actions y agentes.

Qué puedes hacer

Pegar una URL de YouTube (u otra) en ChatGPT y obtener una URL de archivo
Extraer solo audio (download_type=audio)
Obtener título, duración y miniatura vía https://api.huntapi.com/v1/media/metadata antes de descargar
Seguir el progreso (0–100) haciendo poll a https://api.huntapi.com/v1/jobs/{id}

Inicio rápido

Las descargas Hunt son asíncronas. ChatGPT debe:

Llamar al endpoint de download → recibir job_id
Hacer poll hasta status = CompletedJob
Devolver result.response (URL CDN) y result.metadata

Paso 1: iniciar descarga

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

Respuesta:

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

Paso 2: estado y progreso

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

En curso:

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

Completado:

{
  "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"
  }
}

Haz poll cada 1–2 segundos mientras status sea Queued o Running.

Opcional: solo metadatos (sin descarga)

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 - devuelve { "metadata": { ... } } al instante.

Configurar ChatGPT Actions

Crea un Custom GPT → Configure → Actions → Create new action
Importa un esquema OpenAPI con:
- 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
Indica al GPT que haga poll hasta CompletedJob y comparta la URL

Ejemplo 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 útiles

Param	Valores	Notas
`query`	URL	Obligatorio
`download_type`	`audio_video`, `audio`, `video`	`audio` para MP3
`video_quality`	`best`, `1080p`, `720p`, …	Vídeos largos (>1h) limitados a 720p
`video_format`	`mp4`, `webm`, `mkv`	Preferencia

Relacionado

Obtener clave API