创建素材资产

POST

/v1/seedance_assets/

在指定素材资产组合中创建图片、视频或音频素材。

真实请求地址：

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

本操作是异步入库。创建成功只表示素材已提交处理，客户端应通过 GetAsset 或
ListAssets 查询状态，直到变为 Active 或 Failed。Processing 状态的素材
不能用于视频生成。

来源文件需要满足绑定渠道的要求。为兼容火山方舟，建议遵循：

图片：jpeg、png、webp、bmp、tiff、gif、heic、heif；小于 30 MB；
宽高比 (0.4, 2.5)，宽和高在 (300, 6000) px。

视频：mp4、mov；480p、720p 或 1080p；时长 2～15 秒；不超过 200 MB；
帧率 24～60 FPS。

音频：wav、mp3；时长 2～15 秒；不超过 15 MB。

请求参数

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/portrait.png",
    "Name": "人物正面图",
    "AssetType": "Image",
    "ProjectName": "default"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

创建图片素材创建视频素材创建音频素材

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/portrait.png",
    "Name": "人物正面图",
    "AssetType": "Image",
    "ProjectName": "default"
}'

返回响应

🟢200

application/json

提交成功，返回平台逻辑素材 ID。

Bodyapplication/json

示例

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

🟠400AssetError

🟠401TokenAuthError

🟠403AssetError

🟠404AssetError

🟠409AssetError

🟠429UpstreamRateLimit

🔴500AssetError

🔴503AssetError

修改于 2026-07-27 08:18:46

删除素材资产组合

查询素材资产列表