> ## 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 控制平面中跨任务的全部训练检查点，是模型接口的只读伴随接口，用于查看训练运行。

返回跨任务捕获的全部训练检查点。检查点是训练运行过程中写入的中间产物；模型接口以相同的记录暴露更多生命周期操作，例如合并与导出。

## 接口

```http theme={null}
GET /v1/checkpoints
```

## 认证

`Authorization: Bearer <api_key or JWT>`。

## 查询参数

<ParamField query="job_id" type="string">
  筛选来自单个任务的检查点。
</ParamField>

<ParamField query="limit" type="integer">
  返回的最大条目数。
</ParamField>

## 响应

<ResponseField name="code" type="integer">
  成功时为 `0`。
</ResponseField>

<ResponseField name="data" type="object">
  信封，包含 `items` 数组，每个检查点记录带有 `id`、`job_id`、`step`、`metric` 快照、`artifact_paths` 与 `created_at`。
</ResponseField>

## 示例

```bash theme={null}
curl https://ariapin.example.com/v1/checkpoints \
  -H "Authorization: Bearer $ARIAPIN_API_KEY"
```

```json theme={null}
{
  "code": 0,
  "data": {
    "items": [
      {
        "id": "ckpt_0198c...",
        "job_id": "job_0198a...",
        "step": 500,
        "created_at": "2025-09-01T12:00:00Z"
      }
    ]
  },
  "message": ""
}
```

<Note>
  检查点与模型共享同一底层存储。当你需要按模型执行合并、重载或导出等生命周期操作时，请使用 [列出模型](/api-reference/pin/models/list)。
</Note>