Autenticación

Autentica cada solicitud con una clave de API secreta en la cabecera Authorization.

Cada solicitud necesita una clave de API, enviada como token bearer:

Authorization: Bearer vu_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Quién puede usar la API

La API es para cuentas de pago: cuentas que han comprado un paquete de créditos o se han suscrito. Las cuentas gratuitas no pueden crear claves de API, y cada solicitud de una cuenta que nunca ha pagado devuelve 403:

{
  "error": {
    "code": "paid_plan_required",
    "message": "The API is available to accounts that have bought credits or subscribed. See https://videoupscaler.co/pricing"
  }
}

Compra cualquier paquete de créditos en la página de precios para obtener acceso. El acceso se mantiene aunque gastes los créditos; después solo tienes que recargar.

Obtener una clave

Crea tus claves en Configuración → Claves de API. Puedes tener hasta 20 claves activas, por ejemplo una por servidor o entorno. La página muestra el nombre de cada clave, sus primeros y últimos caracteres y cuándo se usó por última vez.

La clave completa se muestra solo una vez, al crearla. Solo guardamos un hash, así que no podemos volver a mostrártela. Si pierdes una clave, elimínala y crea una nueva.

Mantén tus claves seguras

  • Una clave gasta los créditos de tu cuenta. Trátala como una contraseña.
  • Llama a la API desde tu servidor. Nunca pongas una clave en un navegador, una app móvil ni un repositorio público.
  • Léela de una variable de entorno, como VIDEOUPSCALER_API_KEY.
  • Si una clave se filtra, elimínala en Configuración. Deja de funcionar al instante.

Errores

Una clave ausente, mal formada o eliminada devuelve 401:

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key. Send it as \"Authorization: Bearer vu_live_...\"."
  }
}