AI Assistants

Hermes Video Downloader

Use a Hermes agent with HuntAPI to download videos, extract audio, and fetch metadata. Ideal when Hermes can call HTTP tools or run scripts that poll jobs until completion.

What you can do

Give Hermes a video URL and get a CDN file link back
Extract audio only (download_type=audio)
Preview title, duration, and thumbnail via https://api.huntapi.com/v1/media/metadata
Track download progress (0-100) on https://api.huntapi.com/v1/jobs/{id}

Flow

Hermes receives a media URL from the user
Optional: call media metadata (sync)
Start GET https://api.huntapi.com/v1/video/download?query=... → job_id
Poll GET https://api.huntapi.com/v1/jobs/{job_id} every 1-2 seconds until CompletedJob
Return result.response (CDN URL) and a short result.metadata summary

Do not invent download URLs. Only share links from a completed job.

Endpoints

GET https://api.huntapi.com/v1/media/metadata?query=VIDEO_URL
x-api-key: YOUR_API_KEY

GET https://api.huntapi.com/v1/video/download?query=VIDEO_URL&video_quality=720p
x-api-key: YOUR_API_KEY

GET https://api.huntapi.com/v1/jobs/{job_id}
x-api-key: YOUR_API_KEY

`status`	`progress`
`Queued`	`0`
`Running`	`1`-`99`
`CompletedJob` / `Error` / …	`100`

Tool / system prompt sketch

When the user shares a video URL, use HuntAPI:
1) GET https://api.huntapi.com/v1/media/metadata?query=<url> (optional)
2) GET https://api.huntapi.com/v1/video/download?query=<url>
3) Poll GET https://api.huntapi.com/v1/jobs/{job_id} every 2s until CompletedJob
4) Return result.response and a short metadata summary
Never invent CDN links. Keep the API key outside the chat transcript.

Tips

Store HUNTAPI_API_KEY in the agent runtime env, not in prompts
Prefer metadata first when you only need duration or availability
Long videos (>1 hour) are auto-capped at 720p

Get API Key