API de Subida
La API de Subida te permite subir archivos de vídeo o audio locales a WayinVideo. Después de subir, usa el identificador de archivo devuelto como video_url en otros endpoints de la API (Clipping con IA, Buscar Momentos, Resumen de Vídeo, Transcripción de Vídeo).
Suscripción Requerida: La subida de archivos locales requiere un plan Standard o superior. Consulta la página de Planes de Suscripción para más detalles.
Límite de Tamaño: El límite de tamaño de archivo individual es de 5 GB. Si necesitas un límite mayor, contáctanos en wayinvideo@wayin.ai.
Formatos soportados: avi, mp4, mov, webm. Subir otros formatos puede causar fallos en el procesamiento.
Flujo de Subida
- Solicita una URL de subida prefirmada proporcionando los metadatos del archivo
- Sube el archivo directamente a la URL prefirmada usando una solicitud
PUT - Usa el valor
identitydevuelto comovideo_urlen llamadas posteriores
Obtener URL de Subida
POST https://wayinvideo-api.wayin.ai/api/v2/upload/single-file
Cuerpo de la Solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | Sí | Nombre del archivo con extensión (ej.: "my-video.mp4") |
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/upload/single-file \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-wayinvideo-api-version: v2" \
-d '{"name": "sample-video.mp4"}'
Respuesta
{"data": {"upload_url": "https://storage.example.com/upload/presigned-url...", "identity": "file_abc123"}}
| Campo | Tipo | Descripción |
|---|---|---|
upload_url | string | URL prefirmada para subida. Expira después de 1 hora. |
identity | string | Identificador del archivo para usar como video_url |
Subir el Archivo
curl -X PUT "https://storage.example.com/upload/presigned-url..." \
-H "Content-Type: video/mp4" \
--data-binary @/Users/me/Videos/sample-video.mp4
Usar el Archivo Subido
Cada
identityes válido durante 24 horas.
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-wayinvideo-api-version: v2" \
-d '{"video_url": "THE_IDENTITY_VALUE", "enable_export": false}'
Preguntas frecuentes
¿Cuándo debo subir un archivo local frente a pasar una URL de origen?
Si tu video ya está en una plataforma compatible (YouTube, Vimeo, TikTok, Zoom, etc.), pasa la URL directamente al endpoint de procesamiento — no se requiere subida. Usa la API de Subida solo para archivos que aún no estén alojados en una fuente compatible.
¿Cuál es el tamaño máximo de archivo de subida?
5 GB por archivo. Contacta a wayinvideo@wayin.ai si tu caso de uso requiere un límite mayor.
¿Qué formatos de archivo se admiten?
mp4, mov, webm, avi. Los archivos de solo audio deben encapsularse en uno de estos formatos contenedores antes de subirlos. Otros formatos pueden fallar durante el procesamiento.
¿La subida cuenta para la cuota de almacenamiento de mi plan?
Sí — los archivos subidos consumen almacenamiento en tu plan de suscripción. Consulta los Planes de Suscripción para ver los límites de almacenamiento y tamaño de archivo por plan.
¿Cómo uso el archivo subido en otras llamadas a la API?
Después de subir, pasa el identificador de archivo devuelto como campo video_url en cualquier endpoint de procesamiento — AI Clipping, Find Moments, Video Summarization o Video Transcription.