OpenAI 技能资源与对象

技能

创建技能

post /skills

创建新技能。

请求体参数

内容类型：application/json

• files: array of string or string

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

• array of string

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

maxItems: 500

• string

要上传的技能 ZIP 文件。

返回值

• Skill object { id, created_at, default_version, 4 more }

• id: string

技能的唯一标识符。

• created_at: integer

技能创建时的 Unix 时间戳，单位为秒。

format: unixtime

• default_version: string

技能的默认版本。

• description: string

技能的描述。

• latest_version: string

技能的最新版本。

• name: string

技能的名称。

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

对象类型，其值为 skill。

• "skill"

示例

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

200：示例

{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "技能描述示例",
  "latest_version": "latest_version",
  "name": "示例技能",
  "object": "skill"
}

删除技能

delete /skills/{skill_id}

根据 ID 删除技能。

路径参数

• skill_id: string

要删除的技能的标识符。

返回值

• DeletedSkill object { id, deleted, object }

• id: string

• deleted: boolean

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

• "skill.deleted"

示例

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

200：示例

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

列出技能

get /skills

列出当前项目的所有技能。

查询参数

• after: optional string

上一次分页请求中最后一项的标识符。

• limit: optional integer

要检索的项目数。

minimum: 0, maximum: 100

• order: optional "asc" or "desc"

按时间戳排列结果的顺序。使用 asc 表示升序，使用 desc 表示降序。

• "asc"

• "desc"

返回值

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

• data: array of Skill

项目列表。

• id: string

技能的唯一标识符。

• created_at: integer

技能创建时的 Unix 时间戳，单位为秒。

format: unixtime

• default_version: string

技能的默认版本。

• description: string

技能的描述。

• latest_version: string

技能的最新版本。

• name: string

技能的名称。

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

对象类型，其值为 skill。

• "skill"

• 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 \
    -H "Authorization: Bearer $OPENAI_API_KEY"

200：示例

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

检索技能

get /skills/{skill_id}

根据 ID 获取技能。

路径参数

• skill_id: string

要检索的技能的标识符。

返回值

• Skill object { id, created_at, default_version, 4 more }

• id: string

技能的唯一标识符。

• created_at: integer

技能创建时的 Unix 时间戳，单位为秒。

format: unixtime

• default_version: string

技能的默认版本。

• description: string

技能的描述。

• latest_version: string

技能的最新版本。

• name: string

技能的名称。

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

对象类型，其值为 skill。

• "skill"

示例

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

200：示例

{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "技能描述示例",
  "latest_version": "latest_version",
  "name": "示例技能",
  "object": "skill"
}

更新技能默认版本

post /skills/{skill_id}

更新技能的默认版本指针。

路径参数

• skill_id: string

技能的标识符。

请求体参数

内容类型：application/json

• default_version: string

要设为默认版本的技能版本号。

返回值

• Skill object { id, created_at, default_version, 4 more }

• id: string

技能的唯一标识符。

• created_at: integer

技能创建时的 Unix 时间戳，单位为秒。

format: unixtime

• default_version: string

技能的默认版本。

• description: string

技能的描述。

• latest_version: string

技能的最新版本。

• name: string

技能的名称。

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

对象类型，其值为 skill。

• "skill"

示例

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

200：示例

{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "技能描述示例",
  "latest_version": "latest_version",
  "name": "示例技能",
  "object": "skill"
}

数据类型

已删除的技能

• DeletedSkill object { id, deleted, object }

• id: string

• deleted: boolean

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

• "skill.deleted"

技能

• Skill object { id, created_at, default_version, 4 more }

• id: string

技能的唯一标识符。

• created_at: integer

技能创建时的 Unix 时间戳，单位为秒。

format: unixtime

• default_version: string

技能的默认版本。

• description: string

技能的描述。

• latest_version: string

技能的最新版本。

• name: string

技能的名称。

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

对象类型，其值为 skill。

• "skill"

技能列表

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

• data: array of Skill

项目列表。

• id: string

技能的唯一标识符。

• created_at: integer

技能创建时的 Unix 时间戳，单位为秒。

format: unixtime

• default_version: string

技能的默认版本。

• description: string

技能的描述。

• latest_version: string

技能的最新版本。

• name: string

技能的名称。

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

对象类型，其值为 skill。

• "skill"

• 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}/content

根据技能 ID 下载技能 ZIP 文件包。

路径参数

• skill_id: string

要下载的技能的标识符。

返回值

file

示例

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

版本

创建技能版本

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"