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

# Aria Compute REST API reference

> Base URLs, authentication modes, response shapes, and error handling for the Aria Compute REST API. Start here before browsing endpoint groups.

The Aria Compute REST API powers the dashboard, the model registry, and the marketing site. It ships as two identical deployments (international and China) with separate accounts, wallets, and payment providers.

## Base URLs

| Site          | Base URL                      |
| ------------- | ----------------------------- |
| International | `https://ariacompute.com/api` |
| China         | `https://ariacompute.cn/api`  |

Two endpoints live at the domain root instead of `/api`: `GET /healthz` and `GET /sitemap.xml`.

## Response format

All JSON responses use `application/json; charset=utf-8`. Timestamps are ISO 8601 in UTC (for example, `2026-09-23T10:00:00Z`). Download endpoints redirect (`302`) or stream binary content with `Content-Disposition`.

## Authentication

Three modes cover every endpoint:

| Endpoint category                                                    | Auth                                           |
| -------------------------------------------------------------------- | ---------------------------------------------- |
| `/api/auth/*`, `/api/billing/*`, `/api/api-keys`                     | Session JWT via `Authorization: Bearer`        |
| `/api/models/{slug}/download`, gateway                               | API key `bfvk-...` via `Authorization: Bearer` |
| Invoice, receipt, model download links in the browser                | Same JWT via `?token=` query                   |
| Public endpoints (site, pricing, providers, changelog, downloads/\*) | None                                           |

See [Auth Overview](/api-reference/authentication) for details.

## Endpoint groups

| Group             | Base path                                              |
| ----------------- | ------------------------------------------------------ |
| Auth              | `/api/auth`                                            |
| API keys          | `/api/api-keys`                                        |
| Models            | `/api/models`                                          |
| Release downloads | `/api/download`                                        |
| Billing           | `/api/billing`                                         |
| Site metadata     | `/api/site`, `/api/pricing`, `/api/payments/providers` |
| Health            | `/healthz`                                             |

## Errors

Errors return JSON `{ "error": "..." }` with an HTTP status code. See the [Errors reference](/resources/errors) for the full table and retry guidance.

## Rate limiting

Aggressive callers may receive `429 Too Many Requests`. Back off with exponential delay and jitter.


## Related topics

- [Use the Aria Compute API from cURL](/sdks/curl.md)
- [Python client for the Aria Compute API](/sdks/python.md)
- [Go client for the Aria Compute API](/sdks/go.md)
- [Authenticate requests to the Aria Compute API](/authentication.md)
- [Node.js client for the Aria Compute API](/sdks/nodejs.md)