OpenAI 列出技能版本

列出技能版本

get /skills/{skill_id}/versions

列出某个技能的版本。

路径参数

• skill_id: string

技能的标识符。

查询参数

• after: optional string

从该技能版本 ID 之后开始分页。

• limit: optional integer

要检索的版本数。

minimum: 0, maximum: 100

• order: optional "asc" or "desc"

按版本号排列结果的顺序。

• "asc"

• "desc"

返回值

• SkillVersionList object { data, first_id, has_more, 2 more }

• data: array of SkillVersion

项目列表。

• id: string

技能版本的唯一标识符。

• created_at: integer

版本创建时的 Unix 时间戳，单位为秒。

format: unixtime

• description: string

技能版本的描述。

• name: string

技能版本的名称。

• object: "skill.version" (default: "skill.version")

对象类型，其值为 skill.version。

• "skill.version"

• skill_id: string

此版本所属技能的标识符。

• version: string

此技能的版本号。

• first_id: string or null

列表中第一项的 ID。

• has_more: boolean

是否还有更多项目可供获取。

• last_id: string or null

列表中最后一项的 ID。

• object: "list" (default: "list")

返回的对象类型，必须为 list。

• "list"

示例

## 从环境变量读取 API 密钥；运行前替换技能 ID、版本号及文件示例占位值。
curl https://api.openai.com/v1/skills/$SKILL_ID/versions \
    -H "Authorization: Bearer $OPENAI_API_KEY"

200：示例

{
  "data": [
    {
      "id": "id",
      "created_at": 0,
      "description": "技能描述示例",
      "name": "示例技能",
      "object": "skill.version",
      "skill_id": "skill_id",
      "version": "version"
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id",
  "object": "list"
}