Assistants IA

ChatGPT Video Downloader

Utiliser ChatGPT Video Downloader avec Hunt

Utilisez ChatGPT avec HuntAPI pour télécharger des vidéos, extraire l’audio et récupérer des métadonnées - sans quitter le chat. Idéal pour Custom GPTs, ChatGPT Actions et workflows agents.

Ce que vous pouvez faire

Coller une URL YouTube (ou autre) dans ChatGPT et obtenir une URL de fichier
Extraire l’audio seul (download_type=audio)
Récupérer titre, durée et miniature via https://api.huntapi.com/v1/media/metadata avant le download
Suivre la progression (0–100) en pollant https://api.huntapi.com/v1/jobs/{id}

Démarrage rapide

Les downloads Hunt sont asynchrones. ChatGPT doit :

Appeler l’endpoint download → recevoir un job_id
Poller les jobs jusqu’à status = CompletedJob
Renvoyer result.response (URL CDN) et result.metadata à l’utilisateur

Étape 1 : démarrer le download

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

Réponse :

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

Étape 2 : statut et progression

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

En cours :

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

Terminé :

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

Poller toutes les 1–2 secondes tant que status est Queued ou Running.

Optionnel : métadonnées seules (sans download)

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

Synchrone - renvoie { "metadata": { ... } } immédiatement.

Configuration ChatGPT Actions

Créez un Custom GPT → Configure → Actions → Create new action
Importez un schéma OpenAPI qui expose :
- GET https://api.huntapi.com/v1/video/download
- GET https://api.huntapi.com/v1/jobs/{id}
- (optionnel) GET https://api.huntapi.com/v1/media/metadata
Auth : header API Key x-api-key
Server URL : https://api.huntapi.com
Instruez le GPT à poller jusqu’à CompletedJob, puis partager l’URL du fichier

Exemple 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.

Paramètres utiles

Param	Valeurs	Notes
`query`	URL	Requis
`download_type`	`audio_video`, `audio`, `video`	`audio` pour MP3
`video_quality`	`best`, `1080p`, `720p`, …	Vidéos longues (>1h) plafonnées à 720p
`video_format`	`mp4`, `webm`, `mkv`	Préférence

Voir aussi

Obtenir une clé API