You need to enable JavaScript to run this app.
Lake AI Service

Lake AI Service

Copy page
Download PDF
Dataset Management
CreateDataset - Create dataset
Copy page
Download PDF
CreateDataset - Create dataset
Create dataset​
Debug​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
Request parameters​
Only the request parameters specific to this API and some common parameters are listed below. For more information, see Common parameters.​
Action string required Example: CreateDataset​
Operation to perform. Value: CreateDataset​
​
Version string required Example: 2025-08-15​
API version. Value: 2025-08-15​
​
ClientToken string Optional Example: uuid-xxxxxx​
Client token​
​
Tags object[] Optional Example: ---​
tags​
Key string Optional Example: test_key​
Tag key​
​
Value string Optional Example: test_value​
Tag value​
​
​
Format string required Example: Lance​
Dataset data format​
​
Storage string required Example: TOS​
File source: TOS​
​
Category string Optional Example: Common​
Dataset category​
​
DataPath string required Example: tos://my-bucket/image-dataset/​
Dataset resource path​
​
Nickname string Optional Example: MyImageDataset​
Dataset nickname​
​
SourceType string Optional Example: User​
Dataset source​
​
CatalogInfo object Optional Example: ---​
Dataset catalog information​
TableName string Optional Example: image_table​
Table name​
​
SchemaName string Optional Example: image_schema​
Database name​
​
CatalogName string Optional Example: las_catalog​
Catalog name​
​
​
DatasetName string required Example: my_image_dataset_001​
Dataset name​
​
Description string Optional Example: A dataset containing 10,000 images for classification task​
Dataset description​
​
​
​
Response parameters​
Only the response parameters specific to this API are listed below. For more information, see Response structure.​
DatasetName string Example: my_image_dataset_001​
Dataset name​
​
​
​
Request example​
​
POST /?Action=CreateDataset&Version=2025-08-15 HTTP/1.1​
Host: open.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20251128T062817Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251128/cn-beijing/las/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"ClientToken": "uuid-xxxxxx",​
"Tags": [​
{​
"Key": "test_key",​
"Value": "test_value"​
}​
],​
"Format": "Lance",​
"Storage": "TOS",​
"Category": "Common",​
"DataPath": "tos://my-bucket/image-dataset/",​
"Nickname": "MyImageDataset",​
"SourceType": "User",​
"CatalogInfo": {​
"TableName": "image_table",​
"SchemaName": "image_schema",​
"CatalogName": "las_catalog"​
},​
"DatasetName": "my_image_dataset_001",​
"Description": "A dataset containing 10,000 images for classification task"​
}​
​
Response example​
​
{​
"ResponseMetadata": {​
"RequestId": "20251127115843208067209247E0C5D8",​
"Action": "CreateDataset",​
"Version": "2025-08-15",​
"Service": "las",​
"Region": "cn-beijing"​
},​
"Result": {​
"DatasetName": "my_image_dataset_001"​
}​
}​
​
Error codes​
The following table lists the error codes related to the business logic of this API. For common error codes, see the Common error codes documentation.​
​
Status code​
Error code​
Error message​
Note​
400​
MissingParameter​
The required parameter {} is missing.​
The required parameter {} is missing.​
400​
InvalidRequestParam​
Invalid request param {}, cause {}​
Invalid request parameter {}, cause {}​
400​
DryRunOperation​
The request is validated by a dryrun operation.​
This request is validated by a dry run operation.​
400​
InvalidParameter​
The specified parameter {} is invalid.​
The specified parameter {} is invalid.​
400​
AccessDenied​
Access Denied​
​
500​
InternalError​
The request has failed due to an unknown error.​
The request failed due to an unknown error.​
​
Last updated: 2026.08.03 10:44:00