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 identity devuelto como video_url en 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 identity es 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}'