> ## 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 数据集目录

> PIN API 的 GET /v1/dataset-catalog。获取精选数据集列表，包含元数据与目录说明。

使用数据集目录接口浏览可用于训练的精选数据集列表。响应包含数据集条目以及额外的目录说明，帮助你选择合适的训练数据。

## 接口

```http theme={null}
GET /v1/dataset-catalog
```

## 认证

需要有效的 `Authorization: Bearer <jwt-or-api-key>` 头。

## 响应

<ResponseField name="items" type="array">
  目录中可用的精选数据集列表。
</ResponseField>

<ResponseField name="notes" type="object">
  关于目录条目的额外元数据与说明。
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://ariapin.example.com:8001/v1/dataset-catalog \
    -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 0,
    "data": {
      "items": [
        {
          "id": "ds_catalog_1",
          "name": "General Instruction Tuning",
          "description": "A diverse instruction-following dataset."
        }
      ],
      "notes": {
        "last_updated": "2024-06-01",
        "source": "curated"
      }
    },
    "message": ""
  }
  ```
</ResponseExample>

使用数据集目录接口浏览可用于训练的精选数据集列表。响应包含数据集条目以及额外的目录说明，帮助你选择合适的训练数据。

## 接口

```http theme={null}
GET /v1/dataset-catalog
```

## 认证

需要有效的 `Authorization: Bearer <jwt-or-api-key>` 头。

## 响应

<ResponseField name="items" type="array">
  目录中可用的精选数据集列表。
</ResponseField>

<ResponseField name="notes" type="object">
  关于目录条目的额外元数据与说明。
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://ariapin.example.com:8001/v1/dataset-catalog \
    -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 0,
    "data": {
      "items": [
        {
          "id": "ds_catalog_1",
          "name": "General Instruction Tuning",
          "description": "A diverse instruction-following dataset."
        }
      ],
      "notes": {
        "last_updated": "2024-06-01",
        "source": "curated"
      }
    },
    "message": ""
  }
  ```
</ResponseExample>