新建素材目录

POST

/v1/assets/folders

创建素材目录。普通目录通常会直接返回 approved。素人或普通个人真人人脸素材可先选择普通目录尝试上传和生成；公众人物、演员、网红、主播等建议直接使用真人目录并走扫码授权流程。真人目录会返回 h5_link，终端用户完成真人认证后可轮询详情接口刷新状态。

请求参数

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200

application/json

成功创建素材目录

Bodyapplication/json

🟠400

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://tk.wxdatas.cn/v1/assets/folders' \
--header 'Authorization: Bearer sk-xxxxxx' \
--header 'Content-Type: application/json' \
--data '{
    "kind": "real",
    "name": "本人认证"
}'

响应示例

200 - 示例 1

{
    "success": true,
    "message": "",
    "data": {
        "id": "na_folder_0d8c1b3a4f5e",
        "kind": "real",
        "name": "本人认证",
        "verify_status": "pending",
        "h5_link": "https://example.com/verify?token=xxx",
        "error_message": "string",
        "created_time": 1780666000,
        "updated_time": 1780666000
    }
}

修改于 2026-07-27 00:40:26

Seedance人像素材用户使用说明

查询素材目录列表