文档首页/魔坊（ModelArts）模型训推平台/API参考/历史API/数据管理（旧版）/创建数据集标注版本
更新时间：2025-06-30 GMT+08:00
查看PDF
分享

创建数据集标注版本

功能介绍

创建数据集标注版本。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v2/{project_id}/datasets/{dataset_id}/versions

表1 路径参数

参数

是否必选

参数类型

描述

dataset_id

是

String

数据集ID。

project_id

是

String

用户项目ID。获取方法请参见获取项目ID和名称。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

clear_hard_property

否

Boolean

是否清空难例属性。可选值如下：

  • true：清空难例属性（默认值）

  • false：不清空难例属性

description

否

String

版本描述信息，默认为空，长度为0-256位，不能包含!<>=&"'特殊字符。

export_images

否

Boolean

发布时是否导出图片到版本输出目录。可选值如下：

  • true：导出图片到版本输出目录

  • false：不导出图片到版本输出目录（默认值）

remove_sample_usage

否

Boolean

发布时是否清除数据集已有的usage信息。可选值如下：

  • true：发布时清除数据集已有的usage信息（默认值）

  • false：发布时不清除数据集已有的usage信息

train_evaluate_sample_ratio

否

String

发布版本时切分训练验证比例，默认为1.00，即全部分为训练集。

version_format

否

String

数据集版本格式。可选值如下：

  • Default：默认格式

  • CarbonData：Carbon格式（仅表格数据集支持）

  • CSV：CSV格式

version_name

否

String

版本名称。

with_column_header

否

Boolean

发布时是否将列名写到CSV文件的第一行，对于表格数据集有效。可选值如下：

  • true：发布时将列名写到CSV文件的第一行（默认值）

  • false：发布时不将列名写到CSV文件的第一行

响应参数

状态码： 201

表3 响应Body参数

参数

参数类型

描述

version_id

String

数据集版本ID。

请求示例

创建数据集标注版本。设置版本名称为“V004”，数据集版本格式为“Default”。

{
  "version_name" : "V004",
  "version_format" : "Default",
  "description" : "",
  "clear_hard_property" : true
}

响应示例

状态码： 201

Created

{
  "version_id" : "sntOdOuB0D9C6fC4TXs"
}

状态码

状态码

描述

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码。

相关文档