{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/9mnzot7x8","result":{"data":{"markdownRemark":{"html":"\n
\n
\n
\n
\n
POST
\n
\nhttps://qianfan.baidubce.com/v2/dataset?Action=CreateDataset\n
\n
\n
\n

本接口用于创建新的数据集，数据集创建完成后自带版本V1。

\n
\n
\n

权限说明

\n

调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：

\n\n

鉴权说明

\n

调用本文API，使用\"基于安全认证AK/SK\"进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参考HTTP调用鉴权说明。

\n
\n
\n

请求参数

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
Query 参数
\n
\n
\n
\n
\n
\n\nAction\n\nstring\n
\n

方法名称，固定值CreateDataset

\n
\n
必选
\n
\n
\n
\n
\n
\n
\n
Body 参数
\n
\n
\n
\n
\n
\n\ndatasetName\n\nstring\n
\n

数据集名称

\n
\n
必选
\n
\n
\n
\n\ndataFormat\n\nstring\n
\n

数据格式，可选值如下：
· PromptResponse：表示Prompt+Response
· Role：表示Role(user+assistant)
· SFT_FIM：表示Prefix+Suffix+Middle数据格式
· Text：表示纯文本
· DPO_PromptChosenRejected：表示DPO数据格式
· KTO_PromptChosenRejected：表示KTO数据格式
· PromptSortedresponses：表示Prompt+多Response排序
· Prompt：表示Prompt集
· PromptImage：表示Prompt+图片
· PromptImageResponse：表示Prompt+Image+Response。可选值: PromptResponse, Role, SFT_FIM, Text, DPO_PromptChosenRejected, KTO_PromptChosenRejected, PromptSortedresponses, Prompt, PromptImage, PromptImageResponse

\n
\n
必选
\n
\n
\n
\n\nstorageType\n\nstring\n
\n

存储类型，可选值：
· BOS：表示对象存储BOS
· sysStorage：表示平台共享存储。可选值: BOS, sysStorage

\n
\n
必选
\n
\n
\n
\n\nstoragePath\n\nstring\n
\n

存储类型为对象存储BOS时，说明：
（1）对应的完整存储路径即：bos:/bucket/dir
（2）示例：将数据集存储到 bucket：yourBucket，dir：yourDir/text需填写的bosPath为 bos:/yourBucket/yourDir/text/，注意：以左斜杠结尾

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
请求结构
\n\n
\n
\n\n
\n
POST /v2/dataset?Action=CreateDataset HTTP/1.1\nHOST: qianfan.baidubce.com\nAuthorization: authorization string\nContent-Type: application/json\n{\n    \"datasetName\": \"hello_dataset\",\n    \"dataFormat\": \"PromptResponse\",\n    \"storageType\": \"BOS\",\n    \"storagePath\": \"bos:/yourBucket/yourDir/\"\n}
\n
\n
\n
\n
\n
\n
\n
\n

示例代码

\n
\n
\n\n\n
\n
\n
\n
\n\n
\n
\n
\n
curl
\n\n
\n
\n\n
\n
curl -i --location 'https://qianfan.baidubce.com/v2/dataset?Action=CreateDataset'\\\n--header 'Authorization: bce-auth-v1/f0ee7axxxx/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8ee58a8f44axxxxxx016e374525543'\\ \n--header 'x-bce-date: 2023-09-19T13:37:10Z'\\\n--header 'Content-Type: application/json'\\ \n--data '{\n    \"datasetName\": \"hello_dataset\",\n    \"dataFormat\": \"PromptResponse\",\n    \"storageType\": \"BOS\",\n    \"storagePath\":\"bos:/yourBucket/yourDir/\"\n}'
\n
\n
\n
\n
\n\n
\n
\n
\n
\n\n
\n
\n\n
\n
curl -i --location 'https://qianfan.baidubce.com/v2/dataset?Action=CreateDataset'\\\n--header 'Authorization: bce-auth-v1/f0ee7axxxx/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8ee58a8f44axxxxxx016e374525543'\\ \n--header 'x-bce-date: 2023-09-19T13:37:10Z'\\\n--header 'Content-Type: application/json'\\ \n--data '{\n\t\"datasetName\": \"goodBye_dataset\",\n\t\"dataFormat\": \"PromptImage\",\n\t\"storagePath\": \"bos:/yourBucket/yourDir/\",\n    \"storageType\": \"BOS\"\n}'
\n
\n
\n
\n
\n
\n
\n
\n

返回响应

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
返回参数
\n
\n
\n
\n
\n
\n\nrequestId\n\nstring\n
\n

请求ID

\n
\n
可选
\n
\n
\n
\n\nresult\n\nobject {9}\n
\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\ndatasetId\n\nstring\n
\n

数据集ID

\n
\n
可选
\n
\n
\n
\n\nversionId\n\nstring\n
\n

数据集版本ID

\n
\n
可选
\n
\n
\n
\n\nversionNumber\n\ninteger\n
\n

数据集版本序号

\n
\n
可选
\n
\n
\n
\n\ndatasetName\n\nstring\n
\n

数据集名称

\n
\n
可选
\n
\n
\n
\n\ndataFormat\n\nstring\n
\n

数据格式，说明：
· PromptResponse：表示Prompt+Response
· Role：表示Role(user+assistant)
· SFT_FIM：表示Prefix+Suffix+Middle数据格式
· Text：表示纯文本
· DPO_PromptChosenRejected：表示DPO数据格式
· KTO_PromptChosenRejected：表示KTO数据格式
· PromptSortedresponses：表示Prompt+多Response排序
· Prompt：表示Prompt集
· PromptImage：表示Prompt+图片
· PromptImageResponse：表示Prompt+Image+Response。可选值: PromptResponse, Role, SFT_FIM, Text, DPO_PromptChosenRejected, KTO_PromptChosenRejected, PromptSortedresponses, Prompt, PromptImage, PromptImageResponse

\n
\n
可选
\n
\n
\n
\n\nstorageType\n\nstring\n
\n

存储类型，说明：
· BOS：表示对象存储BOS
· sysStorage：表示平台共享存储。可选值: BOS, sysStorage

\n
\n
可选
\n
\n
\n
\n\nstoragePath\n\nstring\n
\n

存储类型为对象存储BOS时，对应的完整存储路径

\n
\n
可选
\n
\n
\n
\n\ncreator\n\nstring\n
\n

创建人

\n
\n
可选
\n
\n
\n
\n\ncreateTime\n\nstring\n
\n

创建时间，格式：YYYY-MM-DD hh:mm:ss

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n\ncode\n\nstring\n
\n

错误码，错误时返回

\n
\n
可选
\n
\n
\n
\n\nmessage\n\nstring\n
\n

错误信息，请求失败时返回

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n\n\n\n
\n
\n
\n
\n\n
\n
\n
\n
JSON
\n\n
\n
\n\n
\n
{\n    \"requestId\": \"1bef3f87-c5b2-4419-936b-50f9884f10d4\",\n    \"result\": {\n        \"versionId\": \"ds-xxx\",\n        \"datasetId\": \"dg-xxx\",\n        \"datasetName\": \"hello_dataset\",\n        \"versionNumber\": 1,\n        \"dataFormat\": \"PromptResponse\",\n        \"storageType\": \"BOS\",\n        \"storagePath\": \"bos:/yourBucket/yourDir/_system_/ds-4saih7rhmcqrp2gu/texts\",\n        \"creator\": \"accountName\",\n        \"createTime\": \"2023-10-25 16:16:38\"\n    }\n}
\n
\n
\n
\n
\n\n
\n
\n
\n
JSON
\n\n
\n
\n\n
\n
{\n    \"requestId\": \"1bef3f87-c5b2-4419-936b-50f9884f10d4\",\n    \"result\": {\n        \"versionId\": \"ds-xxx\",\n        \"datasetId\": \"dg-xxx\",\n        \"datasetName\": \"goodBye_dataset\",\n        \"versionNumber\": 1,\n        \"dataFormat\": \"PromptImage\",\n        \"storageType\": \"BOS\",\n        \"storagePath\": \"bos:/yourBucket/yourDir/_system_/dataset/ds-xxx/images\",\n        \"createTime\": \"2023-11-02 14:50:30\"\n    }\n}
\n
\n
\n
\n
\n\n
\n
\n
\n
JSON
\n\n
\n
\n\n
\n
{\n    \"requestId\": \"6ba7b810-xxxc04fd430c8\",\n    \"code\": \"AccessDenied\",\n    \"message\": \"Access denied.\"\n}
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

错误码

\n

若请求错误，服务器将返回的JSON文本包含以下参数：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
名称描述
requestId请求ID
code错误码
message错误描述信息，帮助理解和解决发生的错误
\n

例如错误返回：

\n
text
{\n    \"requestId\":\"6ba7b810-xxxc04fd430c8\",\n    \"code\":\"AccessDenied\",\n    \"message\":\"Access denied.\"\n}\n
\n

更多其他错误码，也可以查看错误码说明。

\n
\n
","fields":{"slug":"9mnzot7x8","title":"创建数据集","date":"2026-04-16","extractedHeadings":[{"value":"权限说明","depth":2},{"value":"鉴权说明","depth":2},{"value":"请求参数","depth":2},{"value":"示例代码","depth":2},{"value":"返回响应","depth":2},{"value":"错误码","depth":2}]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"9mnzot7x8","prev":{"id":"gmnzp6s4r","name":"删除数据集","path":"gmnzp6s4r","filePath":"模型/管控面API/数据管理/数据集管理/删除数据集.md","seo":null,"parentIds":["Hm9b3tx1a","Imm1s6uow","Rmnqvs9wv","rmnqvt54v"],"parents":[{"id":"Hm9b3tx1a","documentId":"d53594ee-6426-4489-ab0f-d46881463d5d","name":"模型","repoName":"qianfan-api","filePath":"模型","disabled":false,"path":"Hm9b3tx1a","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null},{"id":"Imm1s6uow","documentId":"587c47b1-bbae-46f0-ab50-a1c4d41d24e0","name":"管控面API","repoName":"qianfan-api","filePath":"模型/管控面API","disabled":false,"path":"Imm1s6uow","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"Rmnqvs9wv","documentId":"9e2ca435-7b2f-4df7-b80b-a9c1e482bfde","name":"数据管理","repoName":"qianfan-api","filePath":"模型/管控面API/数据管理","disabled":false,"path":"Rmnqvs9wv","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"rmnqvt54v","documentId":"3115b046-21b1-46dd-abd9-0628923e6afb","name":"数据集管理","repoName":"qianfan-api","filePath":"模型/管控面API/数据管理/数据集管理","disabled":false,"path":"rmnqvt54v","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}]},"next":{"id":"5mo1ewi5y","name":"应用接入","path":"5mo1ewi5y","filePath":"模型/管控面API/应用接入/获取应用身份列表.md","seo":null,"parentIds":["Hm9b3tx1a","Imm1s6uow","mmo1942v6"],"parents":[{"id":"Hm9b3tx1a","documentId":"d53594ee-6426-4489-ab0f-d46881463d5d","name":"模型","repoName":"qianfan-api","filePath":"模型","disabled":false,"path":"Hm9b3tx1a","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null},{"id":"Imm1s6uow","documentId":"587c47b1-bbae-46f0-ab50-a1c4d41d24e0","name":"管控面API","repoName":"qianfan-api","filePath":"模型/管控面API","disabled":false,"path":"Imm1s6uow","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"mmo1942v6","documentId":"1b06c4c4-591a-482d-a42d-0a030ab1aa9e","name":"应用接入","repoName":"qianfan-api","filePath":"模型/管控面API/应用接入","disabled":false,"path":"mmo1942v6","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}]},"parents":[{"id":"Hm9b3tx1a","documentId":"d53594ee-6426-4489-ab0f-d46881463d5d","name":"模型","repoName":"qianfan-api","filePath":"模型","disabled":false,"path":"Hm9b3tx1a","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null},{"id":"Imm1s6uow","documentId":"587c47b1-bbae-46f0-ab50-a1c4d41d24e0","name":"管控面API","repoName":"qianfan-api","filePath":"模型/管控面API","disabled":false,"path":"Imm1s6uow","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"Rmnqvs9wv","documentId":"9e2ca435-7b2f-4df7-b80b-a9c1e482bfde","name":"数据管理","repoName":"qianfan-api","filePath":"模型/管控面API/数据管理","disabled":false,"path":"Rmnqvs9wv","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"rmnqvt54v","documentId":"3115b046-21b1-46dd-abd9-0628923e6afb","name":"数据集管理","repoName":"qianfan-api","filePath":"模型/管控面API/数据管理/数据集管理","disabled":false,"path":"rmnqvt54v","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}],"specificSeo":null}}}