Extraer miniatura de vídeo
Extraer miniatura de vídeo es una herramienta documentada de la API gratuita de APIAny: pruébela en el navegador y luego llame la misma operación con una clave API.
Captura una miniatura JPEG o WebP en un momento elegido.
POST /api/free/video-thumbnailFuentes
¿Qué referencias oficiales cita esta página?
Las citas siguientes proceden de la documentación oficial de API que APIAny implementa.
The Fetch API provides an interface for fetching resources (including across the network).
The typical use case for this high speed Node.js module is to convert large images in common formats to smaller, web-friendly JPEG, PNG, WebP and AVIF images of varying dimensions.
The Images API provides several endpoints that let you generate images from text prompts or create edits of existing images.
Usar Extraer miniatura de vídeo en línea
Sube, configura, previsualiza y descarga sin clave API.
1. Subida y ajustes
Úsalo sin clave. Los archivos solo se envían al ejecutar la solicitud.
2. Vista previa y descarga
Aquí se muestran la vista previa, los cambios de tamaño y la descarga
Integrar mediante API
Solo las llamadas programáticas requieren una clave API. Abajo se documentan parámetros, respuestas y errores.
POST /api/free/video-thumbnailEl uso en línea no requiere clave; las llamadas programáticas necesitan una clave de APIAny.
- El tiempo debe estar dentro de la duración del vídeo.
- El ancho máximo es 1920 píxeles.
Respuesta
Una solicitud correcta devuelve una respuesta image con el Content-Type descrito.
Errores comunes
- 400
- Falta un archivo o parámetro, no es válido o supera un límite.
- 401
- Falta la clave para la llamada programática, es inválida o está desactivada.
- 429
- Se alcanzó el límite compartido en línea o autenticado.
Parámetros y límites
| Parámetro | Requisito | Predeterminado | Valores aceptados |
|---|---|---|---|
videoArchivo de vídeo | Obligatorio | — | file |
timestampTiempo en segundos | Opcional | 0 | number |
widthAncho de miniatura | Opcional | 1280 | number |
formatFormato de salida | Opcional | webp | webp, jpeg |
Ejemplo de API
Este ejemplo autenticado es para código. El Playground no solicita ni expone tu clave.
curl -X POST "https://apiany.ai/api/free/video-thumbnail" \ -H "Authorization: Bearer $API_KEY" \ -F "video=@input.mp4" \ -F "timestamp=2" \ --output thumbnail.webp
Preguntas frecuentes
¿Necesito una clave para Extraer miniatura de vídeo?
No en el Playground. Las llamadas programáticas usan Authorization: Bearer o X-API-Key.
¿Qué límites tiene Extraer miniatura de vídeo?
En línea: 3 solicitudes por minuto y 30 al día. Las cuentas gratuitas autenticadas tienen 5 RPM y las de pago 500 RPM entre todas las API gratuitas.
¿Qué entradas acepta Extraer miniatura de vídeo?
Usa los campos obligatorios y opcionales de la tabla. Los formatos no admitidos y valores fuera de rango se rechazan.
¿Qué devuelve Extraer miniatura de vídeo?
Las solicitudes correctas devuelven una respuesta image; los errores usan los códigos HTTP indicados.