Extraer miniatura de vídeo
Captura una miniatura JPEG o WebP en un momento elegido.
POST /api/free/video-thumbnailUsar 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.