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

# 咏唱引擎 PIN API：训练后处理与评估

> 咏唱引擎 PIN API 概览：用于微调、LoRA、强化学习、评估与模型导出的端侧后训练服务。基础 URL、版本管理、认证与快捷链接。

咏唱引擎 PIN 是面向端侧后训练的微服务，提供微调、LoRA 适配、强化学习、评估与模型导出能力。PIN API 通过基础 URL `http://<pin-host>:8001` 下的 `/v1` 路径前缀以 HTTP 形式暴露这些能力。

除公开路由如 `/health`、`/version`、`/v1/auth/login` 与 `/v1/auth/register` 外，所有 `/v1/*` 路由都需要在 `Authorization` 头中携带 Bearer API 密钥。`/v1/agent/*` 下的路由使用节点智能体 HMAC 令牌方案，面向内部智能体回调。错误响应遵循标准信封：

```json theme={null}
{
  "error": "string",
  "detail?": "string"
}
```

常见状态码包括：`400` 表示校验错误，`401` 表示未授权请求，`404` 表示资源缺失，`500` 表示内部错误。

<CardGroup cols={2}>
  <Card title="认证" icon="key" href="/api-reference/pin/authentication">
    了解如何使用 Bearer API 密钥与节点智能体 HMAC 令牌进行认证。
  </Card>

  <Card title="创建任务" icon="plus" href="/api-reference/pin/jobs/create">
    通过 PIN API 提交微调、LoRA 或 RL 任务。
  </Card>

  <Card title="列出模型" icon="list" href="/api-reference/pin/models/list">
    浏览可用的基座模型与导出的检查点。
  </Card>

  <Card title="计费摘要" icon="money-bill" href="/api-reference/pin/billing/summary">
    获取你所在组织的用量与计费摘要。
  </Card>
</CardGroup>