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