> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Download Aria model bundles from the registry

> Learn how to list, authenticate, and download quantized Aria model bundles via curl and Python. Covers JSON metadata and presigned URL flows.

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`.

<Steps>
  <Step title="List available models">
    Call the public models endpoint to see all bundles and their supported quantizations.

    ```bash theme={null}
    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.
  </Step>

  <Step title="Create or locate an API key">
    Open the [Dashboard API Keys page](https://ariacompute.com/dashboard/api-keys), then click **Create**. Copy the full key starting with `bfvk-`. It is shown only once.

    <Tip>
      API keys are per site: a key created on `ariacompute.com` will not work on `ariacompute.cn`.
    </Tip>
  </Step>

  <Step title="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`:

    <CodeGroup>
      ```bash Redirect follow theme={null}
      curl -L -H "Authorization: Bearer bfvk-XXXXXXXXXXXXXXXX" \
        "https://ariacompute.com/api/models/gemma-4-e2b-it/download?quant=int4&sdk=v1.0"
      ```

      ```python Python theme={null}
      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))
      ```
    </CodeGroup>

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

  <Step title="Request JSON metadata instead">
    If you want the URL without immediately following it, send `Accept: application/json` or add `?format=json`.

    <CodeGroup>
      ```bash curl with JSON theme={null}
      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 .
      ```

      ```json Response theme={null}
      {
        "mode": "redirect",
        "url": "https://s3.amazonaws.com/aria-bundles/...?X-Amz-Expires=300",
        "filename": "gemma-4-e2b-it_q4.zip"
      }
      ```
    </CodeGroup>

    Use the `url` field to start your own download. The `filename` field is the suggested output name.
  </Step>

  <Step title="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:

    ```bash theme={null}
    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
    ```
  </Step>
</Steps>

## 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](/guides/manage-api-keys) — rotate or revoke keys.
* [Download engine and router releases](/api/download/engine-latest) — unauthenticated release assets.


## Related topics

- [Aria model bundles and quantization](/concepts/models.md)
- [GET /api/models/{slug}/download — download an Aria model bundle](/api-reference/models/download.md)
- [GET /api/models — list available Aria model bundles](/api-reference/models/list.md)
- [Use the Aria Compute API from cURL](/sdks/curl.md)
- [Get started with Aria Compute in minutes](/quickstart.md)