修改素材描述

PUT

/v1/assets/{asset_id}

修改素材的描述（purpose）。不改变素材本身与其状态。
该素材文档支持模型如下：
doubao-seedance-2-0-260128
doubao-seedance-2-0-fast-260128
doubao-seedance-2-0-mini-260615
doubao-seedance-2-5-260628
dreamina-seedance-2-0-hc
dreamina-seedance-2-0-fast-hc
dreamina-seedance-2-0-mini-hc
dreamina-seedance-2-5-hc

请求参数

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://www.aiide.com/v1/assets/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "purpose": "string",
    "group_id": "string"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

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

修改于 2026-08-11 02:37:59

查询单个素材

删除素材