OpenAI 技能版本资源与对象

版本

创建技能版本

post /skills/{skill_id}/versions

创建新的不可变技能版本。

路径参数

• skill_id: string

要为其创建版本的技能的标识符。

请求体参数

内容类型：application/json

• files: array of string or string

要上传的技能文件（目录上传），或单个 ZIP 文件。

• array of string

要上传的技能文件（目录上传），或单个 ZIP 文件。

maxItems: 500

• string

要上传的技能 ZIP 文件。

• default: optional boolean

是否将此版本设为默认版本。

返回值

• SkillVersion object { id, created_at, description, 4 more }

• 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

此技能的版本号。

示例

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

200：示例

{
  "id": "id",
  "created_at": 0,
  "description": "技能描述示例",
  "name": "示例技能",
  "object": "skill.version",
  "skill_id": "skill_id",
  "version": "version"
}

删除技能版本

delete /skills/{skill_id}/versions/{version}

删除技能版本。

路径参数

• skill_id: string

技能的标识符。

• version: string

技能版本号。

返回值

• DeletedSkillVersion object { id, deleted, object, version }

• id: string

• deleted: boolean

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

• "skill.version.deleted"

• version: string

已删除的技能版本。

示例

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

200：示例

{
  "id": "id",
  "deleted": true,
  "object": "skill.version.deleted",
  "version": "version"
}

列出技能版本

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"
}

检索技能版本

get /skills/{skill_id}/versions/{version}

获取指定的技能版本。

路径参数

• skill_id: string

技能的标识符。

• version: string

要检索的版本号。

返回值

• SkillVersion object { id, created_at, description, 4 more }

• 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

此技能的版本号。

示例

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

200：示例

{
  "id": "id",
  "created_at": 0,
  "description": "技能描述示例",
  "name": "示例技能",
  "object": "skill.version",
  "skill_id": "skill_id",
  "version": "version"
}

数据类型

已删除的技能版本

• DeletedSkillVersion object { id, deleted, object, version }

• id: string

• deleted: boolean

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

• "skill.version.deleted"

• version: string

已删除的技能版本。

技能版本

• SkillVersion object { id, created_at, description, 4 more }

• 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

此技能的版本号。

技能版本列表

• 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"

内容

检索技能版本内容

get /skills/{skill_id}/versions/{version}/content

下载技能版本 ZIP 文件包。

路径参数

• skill_id: string

技能的标识符。

• version: string

技能版本号。

返回值

file

示例

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