上传素材

POST

/v1/assets

向已认证通过的素材目录上传公网素材 URL。素人或普通个人真人人脸素材可先上传到普通目录并尝试生成；公众人物、演员、网红、主播等真人人脸建议直接使用真人目录扫码授权。如果普通目录生成失败、素材被拒绝或提示需要真人认证，再使用真人目录。上传后系统异步认证素材，需刷新素材状态到 approved 后，才能使用返回的 asset_uri 生成视频。

请求参数

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200

application/json

成功提交素材入库

Bodyapplication/json

🟠400

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://tk.wxdatas.cn/v1/assets' \
--header 'Authorization: Bearer sk-xxxxxx' \
--header 'Content-Type: application/json' \
--data '{
    "folder_id": "na_folder_0d8c1b3a4f5e",
    "url": "https://example.com/face.png",
    "type": "Image",
    "name": "正面特写"
}'

响应示例

200 - 示例 1

{
    "success": true,
    "message": "",
    "data": {
        "id": "na_asset_04718ba913b24a65b3fce0a0d279220d",
        "folder_id": "na_folder_0d8c1b3a4f5e",
        "name": "正面特写",
        "url": "https://example.com/face.png",
        "type": "Image",
        "verify_status": "reviewing",
        "error_message": "string",
        "asset_id": "na_asset_04718ba913b24a65b3fce0a0d279220d",
        "asset_uri": "asset://na_asset_04718ba913b24a65b3fce0a0d279220d",
        "created_time": 1780666000,
        "updated_time": 1780666000
    }
}

修改于 2026-08-27 03:48:22

删除素材目录

查询素材列表