# 查询技能的版本列表

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

`GET https://ark.cn-beijing.volces.com/api/v3/skills/{skill_id}/versions`

查询指定技能的版本。

## 鉴权

本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。

* API Key 鉴权，请在 [API Key 管理](https://ark.volcengine.com/region:cn-beijing/apiKey) 页面，获取长效 API Key。

---

<span id="request-parameters"></span>
## 请求参数

### Path 参数

**skill_id** `string` `必选` | 技能 ID

用于指定要查询版本的技能。

### Query 参数

> 在 URL Query String 中传入。

**limit** `integer` `默认值 20` | 每页数量

用于设置单页最多返回的记录数。

**取值范围**：`[1, 100]`

**page** `string` | 下一页标识

首次请求时省略该参数。后续请求将上一次响应返回的 `next_page` 原样传入该参数。

该值由服务端生成，不是页码。不要解析、生成或修改该值。

## 响应参数

**data** `object[]` | 技能的版本列表

包含当前页返回的不同版本的技能。

**created_at** `string` | 创建时间

`data.created_at`

该版本的创建时间，采用 RFC 3339 格式。

**display_title** `string` | 展示名称

`data.display_title`

表示该版本的展示名称。

**id** `string` | 版本 ID

`data.id`

用于唯一标识该版本，值以 `skillver-` 开头。

**skill_id** `string` | 技能 ID

`data.skill_id`

表示该版本所属技能的 ID。

**type** `string` | 资源类型

`data.type`

用于标识响应对象的资源类型，固定为 `skill_version`。

**version** `string` | 版本号

`data.version`

表示技能的版本号。

**description** `string` | 技能描述

`data.description`

表示方舟平台从该版本的 `SKILL.md` 中解析出的技能描述。

**has_more** `boolean` | 是否有下一页

表示是否还有下一页数据：

* `true`：仍有数据，可以继续分页查询。
* `false`：已返回最后一页。

**next_page** `string` | 下一页标识

服务端生成的下一页标识。`has_more` 为 `true` 时，将该值原样传入下一次请求的 `page`；没有下一页时，不返回该字段。


## 代码示例

## 默认

### cURL


#### Request

```Bash
curl -sS --fail-with-body "https://ark.cn-beijing.volces.com/api/v3/skills/<SKILL_ID>/versions?limit=20" \
  -H "Authorization: Bearer $ARK_API_KEY"
```

#### Response

```
{
  "data": [
    {
      "id": "skillver-20260922102510-b2c3d",
      "type": "skill_version",
      "skill_id": "<SKILL_ID>",
      "version": "2",
      "display_title": "文档处理",
      "description": "提取文档中的结构化信息",
      "created_at": "2026-09-22T10:25:10Z"
    }
  ],
  "has_more": false
}
```