Download Aria model bundles from the registry

Aria Compute hosts device-native model bundles in a public registry. You can browse available models without authentication, but you need an API key or a session token to download bundles. This guide walks you through listing models, choosing a quantization, and fetching the download link.

Before you begin

Have an Aria Compute account (any region).
Create an API key in the dashboard, or sign in to obtain a session JWT.
The base URL for all examples is https://ariacompute.com/api (international). If you are using the China site, replace the host with ariacompute.cn.

List available models

Call the public models endpoint to see all bundles and their supported quantizations.

curl -s https://ariacompute.com/api/models | jq .

The response includes each model slug, available quant values (int4, int8, int326), and SDK compatibility. Pick the slug and quantization you need.

Create or locate an API key

Open the Dashboard API Keys page, then click Create. Copy the full key starting with bfvk-. It is shown only once.

API keys are per site: a key created on ariacompute.com will not work on ariacompute.cn.

Request a download link

By default, the download endpoint returns a 302 Found redirect to a short-lived S3 presigned URL. Follow the redirect with -L:

curl -L -H "Authorization: Bearer bfvk-XXXXXXXXXXXXXXXX" \
  "https://ariacompute.com/api/models/gemma-4-e2b-it/download?quant=int4&sdk=v1.0"

import requests

url = "https://ariacompute.com/api/models/gemma-4-e2b-it/download"
headers = {"Authorization": "Bearer bfvk-XXXXXXXXXXXXXXXX"}
params = {"quant": "int4", "sdk": "v1.0"}

resp = requests.get(url, headers=headers, params=params, allow_redirects=True)
print(resp.status_code, len(resp.content))

Presigned URLs expire quickly. Do not cache or distribute them: request a fresh link each time you download.

Request JSON metadata instead

If you want the URL without immediately following it, send Accept: application/json or add ?format=json.

curl -s -H "Authorization: Bearer bfvk-XXXXXXXXXXXXXXXX" \
  -H "Accept: application/json" \
  "https://ariacompute.com/api/models/gemma-4-e2b-it/download?quant=int4&sdk=v1.0" \
  | jq .

{
  "mode": "redirect",
  "url": "https://s3.amazonaws.com/aria-bundles/...?X-Amz-Expires=300",
  "filename": "gemma-4-e2b-it_q4.zip"
}

Use the url field to start your own download. The filename field is the suggested output name.

Directory downloads (ZIP stream)

When the bundle is stored as a directory, the endpoint streams a ZIP file with Content-Disposition: attachment. Save it directly:

curl -L -H "Authorization: Bearer bfvk-XXXXXXXXXXXXXXXX" \
  "https://ariacompute.com/api/models/gemma-4-e2b-it/download?quant=int4&sdk=v1.0" \
  -o gemma-4-e2b-it_q4.zip

What you receive

Each bundle contains at minimum:

weight.bin — the quantized weights
config.json — model configuration
Optional tokenizer sidecar files

Errors to expect

Status	Meaning
401	Missing or invalid token/API key.
404	Model slug or quantization not found.
429	Rate limit exceeded. Wait and retry.

Next steps

Manage API Keys — rotate or revoke keys.
Download engine and router releases — unauthenticated release assets.

Get Started

Core Concepts

Guides

SDKs

Resources

Download Aria model bundles from the registry

Before you begin

What you receive

Errors to expect

Next steps

​Before you begin

​What you receive

​Errors to expect

​Next steps

Before you begin

What you receive

Errors to expect

Next steps