API.

Tres endpoints GET, sin autenticación. Base: https://hola.opik.net

GET /download

Descarga el video o extrae su audio y devuelve el archivo binario con el título del video en Content-Disposition.

parámetro	valores	descripción
url	`string` · requerido	URL del video de YouTube (youtube.com / youtu.be)
format	`mp4` `mp3` `opus` `opus-2` `aac` `flac`	Formato de salida. Default: `mp4`. OPUS = el stream original de YouTube copiado bit a bit a contenedor Ogg (`.opus`, mimetype `audio/ogg` — el que acepta WhatsApp); OPUS-2 = el mismo audio pero en streaming directo: el servidor re-envuelve WebM→Ogg al vuelo mientras transmite, sin archivo temporal ni caché (la respuesta empieza al instante); FLAC = sin pérdidas desde el mejor audio disponible (no mejora la fuente de YouTube, que ya es comprimida, pero nada más se pierde; archivos grandes); AAC = 320k / 48 kHz; MP3 = 320k CBR, el techo del formato (YouTube no publica MP3 nativo: se codifica una sola vez desde el mejor stream disponible). Nota: `aac` entrega un `.m4a` (su contenedor estándar)
quality	`best` `2160p` `1440p` `1080p` `720p` `480p` `360p` `240p` `144p`	Solo aplica a `mp4`. Default: `best`. Si la calidad pedida no existe, entrega la mejor disponible por debajo. Acepta alias `4k` / `2k` y valores sin la `p`

curl -OJ "https://hola.opik.net/download?url=https://youtu.be/VIDEO_ID&format=mp4&quality=1080p"

curl -OJ "https://hola.opik.net/download?url=https://youtu.be/VIDEO_ID&format=mp3"

Todos los MP4 salen en H.264 + AAC yuv420p, contenedor mp42 con faststart — compatible con WhatsApp. Si YouTube no publica H.264 en la calidad pedida (1440p/4K), el servidor recodifica automáticamente: esas descargas tardan bastante más. Las calidades son las reales del video, también en Shorts/verticales.

Cada archivo se conserva 2 minutos en el servidor: repetir la misma petición dentro de esa ventana responde al instante desde caché; al expirar se borra automáticamente. Errores: 400 parámetros inválidos · 502 fallo al descargar de YouTube · 503 servidor saturado.

GET /formats

Devuelve la información del video y las calidades MP4 disponibles, para elegir antes de descargar. Único parámetro: url.

curl "https://hola.opik.net/formats?url=https://youtu.be/VIDEO_ID"

{
  "title": "…",
  "duration_seconds": 213,
  "channel": "…",
  "thumbnail": "https://i.ytimg.com/…",
  "qualities_mp4": ["2160p", "1440p", "1080p", "720p", "480p", "360p"],
  "audio_formats": ["aac", "mp3", "opus"],
  "video_streams": [ { "format_id": "…", "quality": "1080p", "ext": "mp4",
                       "fps": 60, "vcodec": "avc1…", "filesize_mb": 134.9 } ]
}

GET /health

Estado del servicio: versión de yt-dlp, disponibilidad de ffmpeg, límite de descargas simultáneas y TTL de los archivos.

curl "https://hola.opik.net/health"

¿Prefieres probar los endpoints desde el navegador? También está el Swagger interactivo.