修改素材描述

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

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params application/jsonRequired

Example

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

Request Code Samples

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"
}'

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{
    "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
}

Modified at 2026-08-11 02:37:59

查询单个素材

删除素材