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

# 咏唱引擎 SDK 与客户端库

> 为咏唱引擎挑选合适的客户端：任意语言的 REST API、设备端运行时（aria-engine、aria-router）以及 Agent 工具。

咏唱引擎暴露两个集成面。挑选与你的工作负载匹配的一个。

## REST API

每个控制台操作都可作为 REST 调用使用。任意 HTTP 客户端均可。用它来认证用户、管理 API 密钥、为钱包充值、列出与下载模型，以及读取计费数据。

* 基础 URL：`https://ariacompute.cn/api`（中国站）或 `https://ariacompute.com/api`（国际站）。
* 认证：会话 JWT 或 `bfvk-` API 密钥。参见[认证](/authentication)。
* 参考：[API 参考](/api-reference/introduction)。

<CardGroup cols={2}>
  <Card title="cURL" icon="terminal" href="/sdks/curl">
    认证、下载与计费的 Shell 示例。
  </Card>

  <Card title="Python" icon="python" href="/sdks/python">
    带重试的最小 `requests` 客户端。
  </Card>

  <Card title="Node.js" icon="node-js" href="/sdks/nodejs">
    面向服务端集成的基于 fetch 的客户端。
  </Card>

  <Card title="Go" icon="golang" href="/sdks/go">
    与后端自身模式一致的 `net/http` 客户端。
  </Card>
</CardGroup>

## 设备端运行时

运行时在用户硬件上运行 Aria 模型包。它们以发布二进制与 FFI 共享库形式提供。

| 运行时                                  | 用途                   | 参考                            |
| ------------------------------------ | -------------------- | ----------------------------- |
| `aria-engine` + `libaria-engine_ffi` | 语言、视觉与 VLA/策略模型推理    | [引擎运行时](/sdks/engine-runtime) |
| `aria-router` + `libaria-router_ffi` | 模型分发与多模型编排           | [路由运行时](/sdks/router-runtime) |
| `aria-agent`                         | 用于工具调用与规划的 Agent 脚手架 | [下载](/resources/downloads)    |
| `aria-memo`                          | Aria Agent 的持久化记忆    | [下载](/resources/downloads)    |

<Note>
  通过[发布接口](/api-reference/downloads/engine-latest)以编程方式获取最新发布二进制。在中国站，下载从 Gitee 镜像提供。
</Note>

## 模型包

所有运行时都消费相同的 [Aria 模型包](/concepts/models) 格式（`weight.bin`、`config.json`、可选 tokenizer 附属文件）。使用 API 密钥通过 [`GET /api/models/{slug}/download`](/api-reference/models/download) 下载模型包，或从 Hugging Face（`ariacompute/*`）或 ModelScope（`AriaCompute/*`）拉取公开镜像。