Assistenti IA

ChatGPT Video Downloader

Usa ChatGPT con HuntAPI per scaricare video, estrarre audio e ottenere metadati senza lasciare la chat. Ideale per Custom GPT, Actions e agent.

Cosa puoi fare

Incollare un URL YouTube (o altro) in ChatGPT e ottenere un URL file
Estrarre solo audio (download_type=audio)
Ottenere titolo, durata e thumbnail via https://api.huntapi.com/v1/media/metadata prima del download
Tracciare il progresso (0–100) con poll su https://api.huntapi.com/v1/jobs/{id}

Avvio rapido

I download Hunt sono asincroni. ChatGPT deve:

Chiamare l’endpoint download → ricevere job_id
Fare poll fino a status = CompletedJob
Restituire result.response (URL CDN) e result.metadata

Passo 1: avvia download

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

Risposta:

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

Passo 2: stato e progresso

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

In corso:

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

Completato:

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

Fai poll ogni 1–2 secondi mentre status è Queued o Running.

Opzionale: solo metadati (senza download)

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

Sincrono - restituisce subito { "metadata": { ... } }.

Setup ChatGPT Actions

Crea un Custom GPT → Configure → Actions → Create new action
Importa uno schema OpenAPI con:
- GET https://api.huntapi.com/v1/video/download
- GET https://api.huntapi.com/v1/jobs/{id}
- (opzionale) GET https://api.huntapi.com/v1/media/metadata
Auth: header API Key x-api-key
Server URL: https://api.huntapi.com
Istruisci il GPT a fare poll fino a CompletedJob e condividere l’URL

Esempio di 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.

Parametri utili

Param	Valori	Note
`query`	URL	Obbligatorio
`download_type`	`audio_video`, `audio`, `video`	`audio` per MP3
`video_quality`	`best`, `1080p`, `720p`, …	Video lunghi (>1h) limitati a 720p
`video_format`	`mp4`, `webm`, `mkv`	Preferenza

Correlati

Ottieni chiave API