创建素材

POST

/v1/seedance_assets/

完整请求 URI：

POST /v1/seedance_assets/?Action=CreateAsset&Version=2024-01-01

在逻辑素材组中创建图片、视频或音频素材。URL 必须是上游可访问的公网 HTTPS
地址，并在异步处理完成前保持有效。响应只暴露 seedance_asset_* 逻辑 ID。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

Body 参数application/json必填

示例

{
    "GroupId": "seedance_group_550e8400-e29b-41d4-a716-446655440000",
    "URL": "https://example.com/reference-image.jpg",
    "Name": "人物正面图",
    "AssetType": "Image",
    "ProjectName": "default"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/seedance_assets/?Action=CreateAsset&Version=2024-01-01' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "GroupId": "seedance_group_550e8400-e29b-41d4-a716-446655440000",
    "URL": "https://example.com/reference-image.jpg",
    "Name": "人物正面图",
    "AssetType": "Image",
    "ProjectName": "default"
}'

返回响应

🟢200

application/json

创建成功，返回平台逻辑素材 ID。

Bodyapplication/json

示例

{
    "ResponseMetadata": {
        "RequestId": "req_202608100006",
        "Action": "CreateAsset",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "Id": "seedance_asset_6ba7b810-9dad-41d1-80b4-00c04fd430c8"
    }
}

🟠400AssetBadRequest

🟠401TokenAuthError

🟠403AssetError

🟠404AssetError

🟠429UpstreamRateLimit

🔴500AssetError

🔴502EmbeddedBusinessError

🔴503AssetError

修改于 2026-08-10 08:43:01

删除素材组

查询素材列表