火山方舟
火山方舟
API参考
请输入
- 文档首页
火山方舟Managed Agents APISkills查询技能的版本列表
复制全文
下载 pdf查询技能的版本列表
文档反馈
问问助手GET https://ark.cn-beijing.volces.com/api/v3/skills/{skill_id}/versions
查询指定技能的版本。
鉴权
- API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
请求参数
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；没有下一页时，不返回该字段。
默认
Request
cURL
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
}最近更新时间：2026.10.23 21:12:27
这个页面对您有帮助吗？
有用
有用
无用
无用