Claves de API y API REST

Crea claves en Settings → Developers (propietarios y administradores). Ponle un nombre a la clave y elige su Access: Read only (solo lectura, como un Viewer), Read & write videos (lectura y escritura de vídeos, como un Member) o Admin. La clave se muestra una sola vez, así que guárdala en un lugar seguro. La lista de claves muestra el acceso de cada una, cuándo se usó por última vez y la opción Revoke.

Cada clave muestra cuándo se usó por última vez. Revoke la desactiva al instante: todo lo que la use deja de funcionar inmediatamente.

Envía la clave como bearer token:

curl https://api.pellio.io/v1/videos 
  -H "Authorization: Bearer pk_…"

Subir vídeos

Subir un vídeo tiene tres pasos: crear la subida, enviar el archivo y avisar a Pellio de que ha terminado.

1. Crea la subida. La respuesta incluye el vídeo y un objeto upload con url, method (PUT) y headers. La URL es válida durante 6 horas.

   curl https://api.pellio.io/v1/videos/uploads 
     -H "Authorization: Bearer pk_…" 
     -H "Content-Type: application/json" 
     -d '{"title":"Onboarding","filename":"onboarding.mp4","size":48213377,"type":"video/mp4"}'

2. Envía el archivo a upload.url con PUT y las cabeceras indicadas. Va directamente al almacenamiento.
3. Llama a POST /v1/videos/{id}/complete. En ese momento empieza el procesamiento; sin este paso, no empieza nunca. Cuando termine, recibirás un evento video.ready por webhook.

Los archivos tienen que ser de vídeo o audio, de hasta 20 GB. Para archivos grandes, usa una subida reanudable en partes de 16 MB: POST /v1/videos/{id}/multipart, después /multipart/resume para ver qué partes han llegado y, por último, /multipart/complete.

Para importar desde un enlace, usa POST /v1/videos/import con la URL del archivo.

Referencia

Todos los endpoints, con los esquemas de petición y respuesta y una consola interactiva, están en la referencia de la API. El documento OpenAPI está en https://api.pellio.io/v1/openapi.json.

Límites de peticiones

Cada clave puede hacer 600 peticiones por minuto y 30 importaciones por minuto. Una respuesta 429 significa que debes ir más despacio y volver a intentarlo.