# 咏唱引擎

> 咏唱引擎构建设备原生基础模型：为数据中心之外的处理器提供先进智能，专为物理世界中的延迟、隐私和硬件限制而打造。

- [咏唱引擎文档](https://docs.ariacompute.cn/index.md): 咏唱引擎平台文档：下载设备原生模型包、管理 API 密钥、为钱包充值，并对接 REST API。
- [几分钟上手咏唱引擎](https://docs.ariacompute.cn/quickstart.md): 创建咏唱引擎账户、生成 API 密钥，并通过 curl 或 Python 向 REST API 发起你的第一次认证请求。
- [为咏唱引擎 API 请求认证](https://docs.ariacompute.cn/authentication.md): 会话 JWT、bfvk API 密钥与查询令牌下载：如何获取各类凭证，以及哪些接口接受它们。
- [Aria 模型包与量化](https://docs.ariacompute.cn/concepts/models.md): 了解咏唱引擎如何以量化等级打包模型包、进行 SDK 版本管理，并通过预签名 URL 完成认证投递。
- [用于网关与模型访问的 API 密钥](https://docs.ariacompute.cn/concepts/api-keys.md): Bifrost bfvk 密钥为各站点网关与认证模型下载提供认证。了解其作用域、轮换方式，以及与会话 JWT 的区别。
- [预付费钱包、充值与用量计费](https://docs.ariacompute.cn/concepts/wallet-billing.md): 每个咏唱引擎账户持有一个预付费钱包。了解国际站与中国站之间的充值、币种、发票与收据机制。
- [国际站与中国站，以及如何选择](https://docs.ariacompute.cn/concepts/sites-regions.md): 咏唱引擎以两个独立部署运行（.com 与 .cn），拥有独立的账户、钱包、支付与发布主机。了解它们的差异。
- [从模型库下载 Aria 模型包](https://docs.ariacompute.cn/guides/download-models.md): 学习如何通过 curl 与 Python 列出、认证并下载量化后的 Aria 模型包。涵盖 JSON 元数据与预签名 URL 流程。
- [创建、轮换与吊销你的 API 密钥](https://docs.ariacompute.cn/guides/manage-api-keys.md): 在控制台中创建 bfvk API 密钥、用于网关、进行轮换，以及吊销暴露的密钥的分步指南。
- [使用 Stripe、微信支付或支付宝为钱包充值](https://docs.ariacompute.cn/guides/top-up-wallet.md): 在国际站或中国站发起钱包充值，完成支付流程，并确认款项已入账到你的咏唱引擎钱包。
- [下载付款的发票与收据](https://docs.ariacompute.cn/guides/invoices-receipts.md): 中国站为微信支付 / 支付宝订单开具电子发票，国际站提供 Stripe 收据：如何申请、下载并将其用于记账。
- [为你的账户启用两步验证](https://docs.ariacompute.cn/guides/two-factor-auth.md): 为你的咏唱引擎账户开启基于 TOTP 的两步验证，管理活跃会话，并吊销被盗或不再使用的登录。
- [咏唱引擎 SDK 与客户端库](https://docs.ariacompute.cn/sdks/overview.md): 为咏唱引擎挑选合适的客户端：任意语言的 REST API、设备端运行时（aria-engine、aria-router）以及 Agent 工具。
- [通过 cURL 使用咏唱引擎 API](https://docs.ariacompute.cn/sdks/curl.md): 可复制粘贴的 cURL 示例：登录、API 密钥管理、模型下载、钱包充值与发票下载。
- [咏唱引擎 API 的 Python 客户端](https://docs.ariacompute.cn/sdks/python.md): 一个极简、基于 requests 的咏唱引擎 Python 客户端：用 API 密钥认证、列出模型、下载模型包并查询计费。
- [咏唱引擎 API 的 Node.js 客户端](https://docs.ariacompute.cn/sdks/nodejs.md): 一个基于 fetch 的咏唱引擎 Node.js 客户端：用 API 密钥认证、列出并下载模型，并查询钱包与计费接口。
- [咏唱引擎 API 的 Go 客户端](https://docs.ariacompute.cn/sdks/go.md): 一个基于 net/http 的咏唱引擎 Go 客户端：用 API 密钥认证、列出并下载模型，并查询钱包与计费接口。
- [aria-engine 运行时与 FFI](https://docs.ariacompute.cn/sdks/engine-runtime.md): 使用 aria-engine 二进制在设备端运行 Aria 模型包，或从 C、Rust、Python 或 Swift 链接 libaria-engine_ffi 以进行嵌入式推理。
- [aria-router 运行时与 FFI](https://docs.ariacompute.cn/sdks/router-runtime.md): 使用 aria-router 二进制在多个 Aria 模型包之间分发请求，或将 libaria-router_ffi 链接进你自己的服务。
- [跨站点的模型与 GPU 定价](https://docs.ariacompute.cn/resources/pricing.md): 通过 GET /api/pricing 获取当前模型与 GPU 费率。价格按币种隔离：.com 为美元，.cn 为人民币。管理员定价接口一并列出供参考。
- [最新的引擎、路由、Agent 与 Memo 发布](https://docs.ariacompute.cn/resources/downloads.md): 从 GitHub 或 Gitee 返回最新 aria-engine、aria-router、aria-agent 与 aria-memo 发布资源的公开接口。
- [HTTP 状态码与错误响应](https://docs.ariacompute.cn/resources/errors.md): 咏唱引擎 API 的错误结构、完整状态码表，以及针对 4xx 与 5xx 响应的重试建议。
- [咏唱引擎平台更新日志](https://docs.ariacompute.cn/resources/changelog.md): 阅读咏唱引擎平台发布说明，并通过 GET /api/changelog 以编程方式获取，便于嵌入你自己的工具。
- [咏唱引擎 PIN API：训练后处理与评估](https://docs.ariacompute.cn/api-reference/pin/introduction.md): 咏唱引擎 PIN API 概览：用于微调、LoRA、强化学习、评估与模型导出的端侧后训练服务。基础 URL、版本管理、认证与快捷链接。
- [使用 PIN API 密钥与智能体令牌认证](https://docs.ariacompute.cn/api-reference/pin/authentication.md): 如何使用 Bearer API 密钥或节点智能体 HMAC 令牌对咏唱引擎 PIN API 进行认证，包括引导密钥与公开路由。
- [POST /v1/auth/login：PIN 用户登录](https://docs.ariacompute.cn/api-reference/pin/auth/login.md): 使用用户名与密码认证 PIN 用户，获取 JWT 令牌及过期时间戳。无需 API 密钥。
- [POST /v1/auth/register：PIN 用户注册](https://docs.ariacompute.cn/api-reference/pin/auth/register.md): 在咏唱引擎 PIN 服务上注册新用户。需要唯一的用户名、邮箱以及至少 6 位的密码。
- [GET /v1/auth/me：PIN 当前用户](https://docs.ariacompute.cn/api-reference/pin/auth/me.md): 获取当前 PIN 用户的资料，包括 id、用户名、邮箱与角色。需要有效的 Bearer API 密钥。
- [GET /v1/apikeys：列出 PIN API 密钥](https://docs.ariacompute.cn/api-reference/pin/apikeys/list.md): 列出当前 PIN 用户拥有的全部 API 密钥。返回每个密钥的元数据；创建后不会暴露完整密钥值。
- [POST /v1/apikeys — 创建 PIN API 密钥](https://docs.ariacompute.cn/api-reference/pin/apikeys/create.md): 在咏唱引擎 PIN 服务上创建新的 API 密钥。完整明文密钥仅返回一次；请在关闭响应前妥善保存。
- [PIN 删除 API 密钥](https://docs.ariacompute.cn/api-reference/pin/apikeys/delete.md): PIN API 的 DELETE /v1/apikeys/{id}。按唯一标识符永久移除一个 API 密钥。
- [PIN 数据集目录](https://docs.ariacompute.cn/api-reference/pin/datasets/catalog.md): PIN API 的 GET /v1/dataset-catalog。获取精选数据集列表，包含元数据与目录说明。
- [PIN 从目录创建数据集](https://docs.ariacompute.cn/api-reference/pin/datasets/from-catalog.md): PIN API 的 POST /v1/datasets/from-catalog。按目录 ID 导入精选数据集，支持本地或流式访问模式。
- [PIN 上传数据集](https://docs.ariacompute.cn/api-reference/pin/datasets/create.md): PIN API 的 POST /v1/datasets。使用 multipart/form-data 上传数据集，包含 name、format 与 file 字段。最大接受 MAX_BYTES。
- [PIN 列出数据集](https://docs.ariacompute.cn/api-reference/pin/datasets/list.md): PIN API 的 GET /v1/datasets。获取账户中的全部数据集列表，包含名称、格式、状态与元数据。
- [PIN 按 ID 获取数据集](https://docs.ariacompute.cn/api-reference/pin/datasets/get.md): PIN API 的 GET /v1/datasets/{id}。获取单个数据集的详情，包括格式、状态、大小、行数、访问模式与创建时间。
- [通过 PIN API 创建训练任务](https://docs.ariacompute.cn/api-reference/pin/jobs/create.md): 通过 POST /v1/jobs 向 Aria PIN 提交新的训练任务。支持 SFT、OPD、pretrain、distill、QAT、GRPO、DPO、KTO、ORPO、SimPO 与 PPO，并配置 LoRA。
- [按状态、类型与项目筛选列出训练任务](https://docs.ariacompute.cn/api-reference/pin/jobs/list.md): 获取按状态、类型或项目筛选的训练任务列表。最多返回 100 个任务及最新进度快照。
- [获取包含检查点与指标的训练任务完整详情](https://docs.ariacompute.cn/api-reference/pin/jobs/get.md): 获取单个训练任务的完整详情，包括检查点、MLflow 链接、最新进度与超参数。
- [暂停、恢复、启动或停止训练任务](https://docs.ariacompute.cn/api-reference/pin/jobs/lifecycle.md): 通过暂停、恢复、启动与停止转换来控制训练任务的生命周期。每个操作都返回更新后的任务状态。
- [手动干预运行中的训练任务](https://docs.ariacompute.cn/api-reference/pin/jobs/intervene.md): 向运行中的任务发送手动干预，以停止训练或在线更新超参数。仅运行中的任务可被干预。
- [为训练任务配置自动干预护栏](https://docs.ariacompute.cn/api-reference/pin/jobs/auto-intervention.md): 获取或更新运行中任务的自动干预规则。当指标在可配置窗口内越过阈值时触发规则。
- [分析训练指标并检测奖励作弊](https://docs.ariacompute.cn/api-reference/pin/jobs/analysis.md): 获取任务的训练后指标分析，包括奖励统计、突增检测与奖励作弊风险标记。
- [删除或取消训练任务](https://docs.ariacompute.cn/api-reference/pin/jobs/delete.md): 删除训练任务并级联清理其模型、导出、事件与计费。对于运行中的任务，先销毁其容器。
- [列出 GPU 节点](https://docs.ariacompute.cn/api-reference/pin/gpu-nodes/list.md): 获取咏唱引擎 PIN 中注册的全部 GPU 节点，包括 SSH 访问详情、标签、状态与智能体数量。
- [创建 GPU 节点](https://docs.ariacompute.cn/api-reference/pin/gpu-nodes/create.md): 通过提供 SSH 凭据、标签与硬件规格，在咏唱引擎 PIN 中注册一个新的 GPU 节点。
- [获取 GPU 节点](https://docs.ariacompute.cn/api-reference/pin/gpu-nodes/get.md): 按 ID 从咏唱引擎 PIN 获取单个 GPU 节点，包括 SSH 详情、标签、状态与智能体数量。
- [更新 GPU 节点](https://docs.ariacompute.cn/api-reference/pin/gpu-nodes/update.md): 部分更新咏唱引擎 PIN 中的 GPU 节点，包括 SSH 凭据、标签、规格与状态。
- [删除 GPU 节点](https://docs.ariacompute.cn/api-reference/pin/gpu-nodes/delete.md): 从咏唱引擎 PIN 移除一个 GPU 节点，并级联删除其智能体与训练任务。
- [列出与部署节点智能体](https://docs.ariacompute.cn/api-reference/pin/gpu-nodes/agents.md): 列出 GPU 节点上的智能体或部署新的智能体，并查看咏唱引擎 PIN 中跨所有节点的全局智能体列表。
- [获取智能体](https://docs.ariacompute.cn/api-reference/pin/agents/get.md): 按 ID 从咏唱引擎 PIN 获取单个智能体，包括 GPU 详情、状态、版本与部署状态。
- [更新智能体](https://docs.ariacompute.cn/api-reference/pin/agents/update.md): 向咏唱引擎 PIN 中运行在 GPU 节点上的智能体推送更新后的二进制或配置。
- [重启 PIN 训练智能体进程](https://docs.ariacompute.cn/api-reference/pin/agents/restart.md): 在其 GPU 节点上重启 PIN 训练智能体进程，无需重新部署二进制，也不丢失其注册信息。
- [删除智能体](https://docs.ariacompute.cn/api-reference/pin/agents/delete.md): 从所属 GPU 节点卸载受管智能体，并从咏唱引擎 PIN 移除智能体记录。
- [列出 PIN 模型](https://docs.ariacompute.cn/api-reference/pin/models/list.md): 获取 PIN 服务中注册的全部模型的翻页列表。也可通过检查点别名接口访问。
- [获取 PIN 模型](https://docs.ariacompute.cn/api-reference/pin/models/get.md): 按 ID 获取单个模型，包括其 adapter、合并权重、GGUF、MLX、MNN 与 QNN 导出的产物映射。
- [下载 PIN 模型产物](https://docs.ariacompute.cn/api-reference/pin/models/download.md): 以 ZIP 归档形式流式下载模型产物。该产物必须存在于模型的 artifact_paths 映射中。
- [将 LoRA 适配器合并到基座模型](https://docs.ariacompute.cn/api-reference/pin/models/merge.md): 将 LoRA 或适配器检查点合并到其基座模型权重中。在导出为 GGUF、MLX、MNN 或 QNN 等格式之前需要进行合并。
- [将模型重新加载到服务运行时](https://docs.ariacompute.cn/api-reference/pin/models/reload.md): 重启为模型提供服务的智能体，使其加载最新权重。复用该智能体，因为它已持有训练产出。
- [将训练好的模型版本接纳为生产版本](https://docs.ariacompute.cn/api-reference/pin/models/accept.md): 记录对某个模型版本的生产接纳，用于生产部署。写入一份接纳报告并将其登记在模型产物之下。
- [将训练好的模型导出为 GGUF、MLX、MNN 或 QNN](https://docs.ariacompute.cn/api-reference/pin/models/export.md): 请求将训练好的模型异步导出为 GGUF、MLX、MNN 或 QNN 格式。返回可用于轮询状态的导出任务 ID。
- [列出全部模型导出任务 - PIN API](https://docs.ariacompute.cn/api-reference/pin/exports/list.md): 列出 PIN 控制平面中全部模型导出任务，包括其目标格式、状态，以及完成时的产物路径。
- [获取模型导出任务状态 - PIN API](https://docs.ariacompute.cn/api-reference/pin/exports/get.md): 按导出标识符获取 PIN 模型导出任务（gguf、mlx、mnn 或 qnn）的当前状态与产物路径。
- [列出全部训练检查点 - PIN API](https://docs.ariacompute.cn/api-reference/pin/checkpoints/list.md): 列出 PIN 控制平面中跨任务的全部训练检查点，是模型接口的只读伴随接口，用于查看训练运行。
- [创建评估](https://docs.ariacompute.cn/api-reference/pin/evaluations/create.md): 使用选定的验证数据集为模型入队一次基准评估运行。
- [列出评估](https://docs.ariacompute.cn/api-reference/pin/evaluations/list.md): 获取特定模型的全部评估运行，包括状态与风险摘要。
- [获取评估](https://docs.ariacompute.cn/api-reference/pin/evaluations/get.md): 获取单次评估运行，包括各基准指标与风险评估。
- [计费摘要](https://docs.ariacompute.cn/api-reference/pin/billing/summary.md): 返回钱包余额、累计总支出，以及最近 30 天的 GPU 与令牌用量。
- [计费用量](https://docs.ariacompute.cn/api-reference/pin/billing/usage.md): 获取翻页的计费记录，显示每个任务的 GPU 秒数、令牌数与费用。
- [节点智能体注册](https://docs.ariacompute.cn/api-reference/pin/node-agent/register.md): GPU 节点智能体向 PIN 控制器注册自身，上报 GPU 清单与标签。
- [节点智能体心跳](https://docs.ariacompute.cn/api-reference/pin/node-agent/heartbeat.md): GPU 节点智能体向 PIN 控制器上报存活状态与刷新后的 GPU 清单。
- [为节点智能体获取下一个待处理任务](https://docs.ariacompute.cn/api-reference/pin/node-agent/acquire.md): 节点智能体长轮询此接口，以获取 PIN 控制平面分配给它们的下一个待处理训练任务。
- [上报训练指标与状态 - 节点智能体](https://docs.ariacompute.cn/api-reference/pin/node-agent/metrics.md): 节点智能体使用 agent secret 向 PIN 控制平面推送其所属任务的逐步训练指标与状态转换。
- [节点智能体控制通道与干预](https://docs.ariacompute.cn/api-reference/pin/node-agent/control.md): 通过控制通道向 PIN 节点智能体下发生命周期与干预命令，并接收命令回执。
- [咏唱引擎 ROUTER：OpenAI 兼容推理网关](https://docs.ariacompute.cn/api-reference/router/introduction.md): 咏唱引擎 ROUTER 是一个自托管的推理网关，支持两种路由模式：语义路由（YAML v0.3 配方）与智能体路由（内建工具循环）。探索数据面与管理面接口。
- [向咏唱引擎 ROUTER 认证](https://docs.ariacompute.cn/api-reference/router/authentication.md): 了解如何向咏唱引擎 ROUTER 的数据面与管理面认证。推理使用 Bearer API 密钥，管理路由使用会话 Cookie 或 X-Api-Key。
- [GET /v1/models：列出 Router 入口与 provider 模型](https://docs.ariacompute.cn/api-reference/router/openai/list-models.md): 以 OpenAI 兼容格式返回可用模型。列出咏唱引擎 ROUTER 中配置的入口与共享 provider 模型。
- [POST /v1/chat/completions：OpenAI 兼容的聊天推理](https://docs.ariacompute.cn/api-reference/router/openai/chat-completions.md): 通过咏唱引擎 ROUTER 发送聊天补全请求。支持流式 SSE、工具调用与标准 OpenAI 参数。
- [在咏唱引擎 ROUTER 上注册账户](https://docs.ariacompute.cn/api-reference/router/auth/register.md): POST /v1/router/auth/register 在咏唱引擎 ROUTER 上创建新用户账户。可通过 GET /v1/router/auth/register-status 检查注册状态。
- [登录咏唱引擎 ROUTER 会话](https://docs.ariacompute.cn/api-reference/router/auth/login.md): POST /v1/router/auth/login 对用户进行认证，并设置一个会话 Cookie，用于咏唱引擎 ROUTER 的管理与数据面访问。
- [退出咏唱引擎 ROUTER 会话](https://docs.ariacompute.cn/api-reference/router/auth/logout.md): POST /v1/router/auth/logout 清除会话 Cookie 并结束当前的咏唱引擎 ROUTER 认证会话。
- [获取当前咏唱引擎 ROUTER 用户](https://docs.ariacompute.cn/api-reference/router/auth/me.md): GET /v1/router/auth/me 返回当前认证用户的资料，包括 id、用户名、邮箱、角色与禁用状态。
- [修改咏唱引擎 ROUTER 密码](https://docs.ariacompute.cn/api-reference/router/auth/password.md): POST /v1/router/auth/password 允许已认证用户通过提供当前密码与新密码来修改自己的密码。
- [更新咏唱引擎 ROUTER 邮箱地址](https://docs.ariacompute.cn/api-reference/router/auth/email.md): PUT /v1/router/auth/email 让已认证用户更新与其咏唱引擎 ROUTER 账户关联的邮箱地址。
- [Router 的 OAuth 与 Serve 账户绑定](https://docs.ariacompute.cn/api-reference/router/auth/oauth.md): 使用 POST /v1/router/auth/oauth/start 发起 OAuth 登录并通过回调完成。绑定并更新咏唱引擎 Serve 账户。
- [列出咏唱引擎 ROUTER 上的用户](https://docs.ariacompute.cn/api-reference/router/users/list.md): GET /v1/router/users 返回翻页的用户账户列表。此仅限管理员的接口用于咏唱引擎 ROUTER 的用户管理。
- [更新咏唱引擎 ROUTER 用户（管理员）](https://docs.ariacompute.cn/api-reference/router/users/update.md): 管理员接口，用于禁用用户账户或更新用户的邮箱。两者都需要管理员权限。
- [Router 健康与概览接口](https://docs.ariacompute.cn/api-reference/router/management/overview.md): 获取咏唱引擎 ROUTER 的实时健康快照，包括请求量、活跃入口点、运行时长与 provider 健康状态。
- [Router 拓扑与依赖图接口](https://docs.ariacompute.cn/api-reference/router/management/topology.md): 获取咏唱引擎 ROUTER 中入口点到配方与 provider 的实时依赖图映射。
- [Router 配置获取与更新接口](https://docs.ariacompute.cn/api-reference/router/management/config.md): 以 JSON 形式获取当前 router YAML 配置，或使用经过校验的配置对象更新它。写入需要管理员权限。
- [Router Provider 列表与 upsert 接口](https://docs.ariacompute.cn/api-reference/router/management/providers.md): 列出咏唱引擎 ROUTER 中全部已配置的 provider，或 upsert 一个 provider 规格。PUT 更新需要管理员权限。
- [Router 管理面模型列表接口](https://docs.ariacompute.cn/api-reference/router/management/models.md): 列出咏唱引擎 ROUTER 管理面暴露的全部 provider 归属模型。与 OpenAI 数据面的 /v1/models 接口不同。
- [Router 管理面聊天与路由测试接口](https://docs.ariacompute.cn/api-reference/router/management/chat.md): 通过咏唱引擎 ROUTER 发送一次测试聊天补全并预览路由决策。支持 dry-run 模式。
- [Router 配置校验接口](https://docs.ariacompute.cn/api-reference/router/management/validate.md): 根据咏唱引擎 ROUTER 的 schema 校验原始 YAML 或 JSON 配置。不会改动任何配置。
- [列出 ROUTER API 密钥接口](https://docs.ariacompute.cn/api-reference/router/keys/list.md): 列出咏唱引擎 ROUTER 中注册的全部 API 密钥。返回元数据、作用域与前缀信息，不暴露完整密钥值。
- [创建 ROUTER API 密钥接口](https://docs.ariacompute.cn/api-reference/router/keys/create.md): 为咏唱引擎 ROUTER 创建一个新的 API 密钥。一次性返回完整密钥值，请妥善保管。可选的作用域用于限制权限。
- [吊销 ROUTER API 密钥接口](https://docs.ariacompute.cn/api-reference/router/keys/revoke.md): 按标识符立即吊销咏唱引擎 ROUTER 中的 API 密钥。该密钥对后续所有请求失效。
- [Router 成本聚合接口](https://docs.ariacompute.cn/api-reference/router/cost.md): 从咏唱引擎 ROUTER 获取成本聚合数据，按用户、模型、入口点与时间段拆分。
- [列出可重放的 Router 请求接口](https://docs.ariacompute.cn/api-reference/router/replay/list.md): 列出咏唱引擎 ROUTER 中可供重放的已捕获请求。按入口点、模型、状态与时间筛选。
- [重路由已捕获的 Router 请求接口](https://docs.ariacompute.cn/api-reference/router/replay/reroute.md): 针对当前的路由配置重放一次捕获到的咏唱引擎 ROUTER 请求，以比较决策与响应。
- [AGENT API 概览：OpenAI Agents 接口](https://docs.ariacompute.cn/api-reference/agent/introduction.md): 咏唱引擎 AGENT API 暴露 OpenAI beta Agents 资源接口，具备持久化的 Postgres + pgvector 状态，并提供 JS 与 Python SDK。
- [AGENT API 认证：Bearer 与 ApiKey](https://docs.ariacompute.cn/api-reference/agent/authentication.md): 使用 Bearer 令牌或 ApiKey 头认证 AGENT API 请求。当 AGENT_CLOUD_API_KEY 在服务端启动时未设置时，认证是可选的。
- [创建智能体 - POST /v1/agents](https://docs.ariacompute.cn/api-reference/agent/agents/create.md): 通过提交一个 OpenAI 兼容的智能体对象（包含 name、model、instructions、tools 与 metadata）来创建新智能体。返回已创建的智能体。
- [列出智能体 - GET /v1/agents](https://docs.ariacompute.cn/api-reference/agent/agents/list.md): 检索全部智能体的列表。返回 OpenAI 兼容的列表对象，包含智能体数据，并支持标准分页字段。
- [按 ID 检索咏唱引擎云智能体](https://docs.ariacompute.cn/api-reference/agent/agents/get.md): 按标识符检索咏唱引擎云智能体，以 OpenAI beta 形态返回其模型、指令、工具与元数据。
- [更新咏唱引擎云智能体定义](https://docs.ariacompute.cn/api-reference/agent/agents/update.md): 更新咏唱引擎云智能体的名称、模型、指令、工具或元数据。支持使用 OpenAI beta 形态进行部分更新。
- [删除咏唱引擎云智能体定义](https://docs.ariacompute.cn/api-reference/agent/agents/delete.md): 按标识符删除咏唱引擎云智能体定义。已有会话保留其历史关联，但无法再开启新轮次。
- [为某个智能体创建咏唱引擎云会话](https://docs.ariacompute.cn/api-reference/agent/sessions/create.md): 创建绑定到某个智能体的咏唱引擎云会话。会话会累积轮次、条目、记忆片段与子智能体状态。
- [列出咏唱引擎云会话](https://docs.ariacompute.cn/api-reference/agent/sessions/list.md): 列出咏唱引擎云会话，可按智能体可选筛选，并使用兼容 OpenAI Agents SDK 的游标分页。
- [按 ID 检索咏唱引擎云会话](https://docs.ariacompute.cn/api-reference/agent/sessions/get.md): 按标识符检索咏唱引擎云会话，返回其绑定智能体、状态、元数据，以及轮次与条目的计数。
- [更新咏唱引擎云会话](https://docs.ariacompute.cn/api-reference/agent/sessions/update.md): 就地更新咏唱引擎云会话的状态或元数据。遵循 OpenAI beta 的部分更新约定，使用 POST。
- [按 ID 删除咏唱引擎云会话](https://docs.ariacompute.cn/api-reference/agent/sessions/delete.md): 按标识符删除咏唱引擎云会话，并一并删除其轮次、条目、记忆片段与子智能体。该操作不可逆。
- [创建智能体事件](https://docs.ariacompute.cn/api-reference/agent/events/create.md): 向智能体会话中发送用户消息或工具结果。事件会被持久化，助手响应会作为新的事件记录返回。
- [流式传输智能体事件](https://docs.ariacompute.cn/api-reference/agent/events/stream.md): 使用服务器推送事件（SSE）流式传输智能体会话的助手回复与中间增量。非常适合实时聊天界面。
- [列出智能体轮次](https://docs.ariacompute.cn/api-reference/agent/turns/list.md): 获取智能体会话的已完成轮次。每个轮次将一次完整的「用户输入到模型响应」循环归为一组。
- [获取智能体轮次](https://docs.ariacompute.cn/api-reference/agent/turns/get.md): 检索智能体会话中的某个特定轮次，包括其嵌套的条目数组与当前状态。
- [列出会话条目](https://docs.ariacompute.cn/api-reference/agent/items/list.md): 检索智能体会话内的全部原始条目，包括消息、工具调用与工具输出，以翻页列表形式返回。
- [获取记忆项](https://docs.ariacompute.cn/api-reference/agent/memory/get.md): 按 key 从智能体会话中检索单个记忆项，包括其值、元数据与创建时间戳。
- [写入与搜索会话记忆](https://docs.ariacompute.cn/api-reference/agent/memory/put-search.md): 使用语义搜索检索，在智能体会话中存储键值形式的上下文片段。使用 POST 写入，使用 GET 搜索记忆项。
- [列出子智能体](https://docs.ariacompute.cn/api-reference/agent/subagents/list.md): 检索智能体会话内启动的全部子智能体。每个子智能体都是拥有自身消息历史的独立子智能体。
- [获取子智能体](https://docs.ariacompute.cn/api-reference/agent/subagents/get.md): 在智能体会话内按 ID 获取单个子智能体，以检查其状态与配置详情。
- [列出子智能体条目](https://docs.ariacompute.cn/api-reference/agent/subagents/items.md): 检索属于某个特定子智能体的全部原始条目，包括其消息、工具调用与工具输出。
- [列出子智能体轮次](https://docs.ariacompute.cn/api-reference/agent/subagents/turns.md): 获取某个特定子智能体的已完成轮次。每个轮次代表子智能体内部一次完整的「用户输入到模型响应」循环。
- [获取子智能体轮次](https://docs.ariacompute.cn/api-reference/agent/subagents/turn-get.md): 按 ID 从子智能体中检索单个轮次，包括其状态与嵌套的条目数组。
- [创建与列出 API 密钥](https://docs.ariacompute.cn/api-reference/agent/api-keys/create-list.md): 生成带有可选作用域的新 API 密钥，并列出已有密钥。原始密钥仅在创建时返回一次。
- [吊销 API 密钥](https://docs.ariacompute.cn/api-reference/agent/api-keys/revoke.md): 按 ID 永久删除一个 API 密钥。吊销后，该密钥将无法再用于认证请求。