修改素材描述

PUT

https://wdwds.cn/v1/assets/{asset_id}

修改素材的描述（purpose）。不改变素材本身与其状态。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Body 参数application/json必填

示例

{
    "purpose": "string",
    "group_id": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://wdwds.cn/v1/assets/asset-20260801101943-faQxK' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "purpose": "string",
    "group_id": "string"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "data": {
        "asset_id": "asset-20260801101943-faQxK",
        "created_at": 1784686780,
        "group_id": "ak-******",
        "original_url": "https://cdn.example.com/portrait.jpg",
        "purpose": "更新后的人物参考描述",
        "status": "ready",
        "type": "image"
    },
    "message": "",
    "success": true
}

修改于 2026-08-18 08:06:21

查询单个素材

删除素材