Almacenamiento

Subir un fichero son tres llamadas: declaras lo que vas a subir, subes los bytes directamente al almacenamiento con las URLs que te devolvemos, y cierras la subida. Los bytes nunca pasan por nuestra API — van del navegador o de tu servidor al bucket, sin intermediarios que cobrar ni cuellos de botella.

Para descargar pides una URL firmada. No es una dirección permanente: es un permiso con fecha de caducidad y, si quieres, con restricciones de país o de velocidad. Se emite una por espectador y se sirve desde una red CDN, no desde nuestra API.

Si prefieres verlo antes que leerlo, la demo hace justo esto con un fichero tuyo y te devuelve los dos enlaces del mismo objeto —firmado y sin firmar— con el código que contesta cada uno.

Declara el fichero con su tamaño. Según el tamaño te contestamos con una subida simple o con un plan por partes — no tienes que elegir, lo decide el servidor.

curl -X POST https://kms.airi.live/v1/storage/files \
  -H "Authorization: Bearer $TOKEN" \
  -H 'content-type: application/json' \
  -d '{
    "name": "pelicula.mp4",
    "sizeBytes": 734003200,
    "contentType": "video/mp4",
    "customId": "pelicula-1234"
  }'

La respuesta trae el fichero y las instrucciones. Si mode es single, haz un PUT a upload.url con el mismo Content-Type que declaraste. Si es multipart, corta el fichero en trozos de upload.partBytes y haz un PUT por cada parte.

# Una parte por cada URL. Guarda el ETag de cada respuesta.
for part in "${parts[@]}"; do
  curl -X PUT --data-binary @parte-$i.bin "$url" -D headers.txt
  etag=$(grep -i '^etag:' headers.txt | tr -d '"\r' | cut -d' ' -f2)
done

curl -X POST https://kms.airi.live/v1/storage/files/$ID/complete \
  -H "Authorization: Bearer $TOKEN" \
  -H 'content-type: application/json' \
  -d '{"parts":[{"partNumber":1,"etag":"a54..."},{"partNumber":2,"etag":"7b1..."}]}'

Pide una URL firmada por cada espectador, con la caducidad más corta que te permita el caso. Quien tenga la URL puede descargar hasta que expire, así que la caducidad es tu control real.

curl "https://kms.airi.live/v1/storage/files/$ID/url?expiresSeconds=600" \
  -H "Authorization: Bearer $TOKEN"

# { "url": "https://...", "expiresAt": "2026-08-02T12:34:56.000Z" }

Restricciones por enlace

Cada URL puede llevar sus propias condiciones, y todas se aplican en el borde del CDN: quien no cumpla no llega a descargar nada, así que tampoco te lo facturamos.

curl "https://kms.airi.live/v1/storage/files/$ID/url\
?expiresSeconds=600&countries=ES,MX&speedLimitKbps=4000&speedLimitAfterSeconds=5" \
  -H "Authorization: Bearer $TOKEN"

No hay nada que contratar ni que configurar: el CDN viene con el almacenamiento. Cada URL firmada que emites apunta ya a la red, y los bytes salen desde el punto de presencia más adecuado para quien la pide. La capacidad total de esa red supera los 250 Tbps, así que el pico de tu estreno es un problema que ya está resuelto antes de que lo tengas.

Servimos desde diez localizaciones: Frankfurt, París, São Paulo, Chicago, Dallas, Los Ángeles, Miami, Hong Kong, Singapur y Tokio. Son pocas y muy grandes, elegidas por caudal antes que por cercanía.

La consecuencia práctica es que no tienes que pensar en entrega. Puedes montar un catálogo bajo demanda, un canal en directo o lo que se te ocurra sin dimensionar ancho de banda, sin negociar tránsito y sin reservar capacidad por adelantado.

El almacenamiento se cobra una vez al día, sobre lo que había activo en ese momento. Un fichero que subes y borras el mismo día no llega a pagar nada; uno que borras hoy deja de contar mañana. La transferencia se cobra al día siguiente, cuando el CDN publica lo que sirvió.

No hay mínimos, ni tamaño mínimo de fichero, ni permanencia. Un GB guardado medio mes cuesta medio.

La forma habitual de montar guardar-y-servir por tu cuenta es S3 más CloudFront. Estos son sus precios de tarifa pública en Norte de Virginia —su región más barata— frente a los nuestros, comprobados el 2 de agosto de 2026. La comparación de la plataforma entera, con codificación y DRM incluidos, está en la portada.

La línea de las peticiones no es un detalle en vídeo: un HLS son cientos de peticiones por hora y espectador. Con un tamaño medio de segmento de 1.5 MB, servir 500 TB al mes son unos 350 millones de peticiones, es decir unos $340 solo por contarlas, antes de mover un byte. Nosotros no las contamos.

# Listar, paginado por cursor
curl "https://kms.airi.live/v1/storage/files?limit=50" -H "Authorization: Bearer $TOKEN"

# Buscar por tu propio identificador
curl "https://kms.airi.live/v1/storage/files?customId=pelicula-1234" -H "Authorization: Bearer $TOKEN"

# Cuánto ocupas y cuánto costará el mes
curl "https://kms.airi.live/v1/storage/usage" -H "Authorization: Bearer $TOKEN"

# Borrar
curl -X DELETE "https://kms.airi.live/v1/storage/files/$ID" -H "Authorization: Bearer $TOKEN"

El customId es tuyo: ponle el identificador que uses en tu base de datos y búscalo por él en vez de guardar el nuestro. Es único mientras el fichero exista — al borrarlo queda libre otra vez.

Borrar es definitivo y se cobra hasta el día que lo haces. Si el almacenamiento no responde, la petición falla y el fichero no se marca borrado: preferimos un error visible a una factura que deja de contar bytes que siguen existiendo.

`storage:read`

Listar, ver detalles, consultar uso y emitir URLs firmadas.

`storage:write`

Subir, cerrar subidas y borrar.

Crea credenciales separadas para lo que solo lee. El backend que reparte enlaces a tus espectadores no necesita poder borrar nada, y una credencial con menos permisos es una credencial que puede filtrarse con menos consecuencias.