火山方舟
火山方舟
API参考
请输入
- 文档首页
火山方舟Managed Agents APISkills查询技能详情
复制全文
下载 pdf查询技能详情
文档反馈
问问助手GET https://ark.cn-beijing.volces.com/api/v3/skills/{skill_id}
查询指定技能的详细信息。
鉴权
- API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
请求参数
Path 参数
skill_id string 必选 | 技能 ID
用于指定要查询的技能。
响应参数
created_at integer | 创建时间
技能创建时间，为 Unix 时间戳，单位为秒。
display_title string | 展示名称
技能的展示名称。未配置时，服务端返回 SKILL.md 中的 name。
id string | 技能 ID
用于唯一标识技能。更新、删除技能或管理技能版本时需要使用该 ID。
- 自定义技能和方舟平台预置技能的 ID 以 skill- 开头。
- Skill Hub 技能的 ID 以 s- 开头。
latest_version string | 最新版本
表示技能的最新版本号。
object string | 资源类型
用于标识响应对象的资源类型，固定为 skill。
protection_enabled boolean | 内容保护开关
表示技能是否已启用内容保护。true 表示已启用，false 表示未启用。
source string | 技能来源
该字段表示技能来源：
- custom 表示上传或导入的自定义技能。
- skill_hub 表示来自 Skill Hub 的公共技能。
- ark 表示方舟平台预置技能。
updated_at integer | 技能更新时间
技能最后更新时间，为 Unix 时间戳，单位为秒。
description string | 技能描述
表示方舟平台从 SKILL.md 中解析出的技能描述。
name string | 技能名称
表示 SKILL.md 中定义的技能名称。
查询技能详情
发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！
Request
cURL
curl -sS --fail-with-body "https://ark.cn-beijing.volces.com/api/v3/skills/<SKILL_ID>" \
-H "Authorization: Bearer $ARK_API_KEY"Response
{
"id": "<SKILL_ID>",
"object": "skill",
"created_at": 1790072430,
"description": "从 PDF/DOCX 中抽取结构化字段并输出 JSON",
"latest_version": "1",
"display_title": "文档抽取助手",
"source": "custom",
"updated_at": 1790072430,
"name": "document-extractor",
"protection_enabled": false
}最近更新时间：2026.10.09 19:08:08
这个页面对您有帮助吗？
有用
有用
无用
无用