Authentication

All requests to the hosted LUX API require authentication using an API token.

Getting a Token

Join the beta program to request access and obtain your API token.

Passing Authorization in Requests

Authentication is supplied as a standard Authorization HTTP header using the Bearer scheme:

Authorization: Bearer YOUR_API_TOKEN

Example Request

curl

curl -X POST https://api-lux.upskiller.xyz/v2/run \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model_type": "df_default", "parameters": {...}}'

Python

import requests

headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api-lux.upskiller.xyz/v2/run",
    headers=headers,
    json={"model_type": "df_default", "parameters": {...}}
)

Self-Hosted Deployment

Local deployments do not require authentication. Remove the Authorization header when connecting to self-hosted instances.

Error Response

Missing or invalid token returns 401 Unauthorized:

{
  "error": "Invalid or missing API token"
}