Qbox CDN

Create A Qbox CDN API Token

1. Open the Qbox dashboard.
2. Sign in with Discord.
3. Go to the CDN area.
4. Generate a new API token.
5. Copy the token into config/config.upload.lua.

The exact dashboard labels may change over time, but you are looking for a CDN API token that can upload files. If Qbox shows token permissions, make sure uploads are allowed. If you want Vehicle Studio to delete remote images when you delete gallery entries, make sure deletes are allowed too.

Configure Vehicle Studio

In config/config.lua:

Config.ImageStorageProvider = "qbox"

In config/config.upload.lua:

Config.ImageStorageProviders = Config.ImageStorageProviders or {}

Config.ImageStorageProviders.qbox = {
  apiKey = "YOUR_QBOX_CDN_API_TOKEN",
  presignedEndpoint = "https://api.qbox.re/v1/file/presigned-url",
  deleteEndpoint = "https://api.qbox.re/v1/file",
  presignExpires = 300
}

Qbox accepts either a raw API key or a Bearer ... value in apiKey. Use the exact value Qbox gives you unless their dashboard tells you to include the Bearer prefix.

Test The Upload

After restarting the resource, generate a vehicle image. Qbox returns the final public URL, and Vehicle Studio saves that URL directly.

If uploads fail, check:

• The API token was copied correctly.
• The token has upload access.
• Your Qbox CDN storage limit has not been reached.
• The server can make outbound HTTPS requests to Qbox.
• The NUI can make outbound HTTPS requests to the presigned Qbox upload URL.