创建素材资产（CreateAsset）

POST

https://api.example.com/api/v3/

在指定的 Asset Group（素材资产组合）内传入 Asset（素材资产）。

注意：上传素材为异步接口，系统处理可能出现排队，视频类素材处理时间更长。

请求方式：

POST /api/v3/?Action=CreateAsset&Version=2024-01-01

curl 示例：

请求透传说明：

从 Authorization: Bearer {token} 中提取 new-api token

请求 headers、body 透传到豆包上游

豆包官方响应原样透传给调用方（包括错误响应）

素材限制：

图片：jpeg/png/webp/bmp/tiff/gif/heic/heif，宽高比 (0.4, 2.5)，尺寸 (300, 6000)px，< 30MB

视频：mp4/mov，480p/720p，时长 [2, 15]s，< 50MB

音频：wav/mp3，时长 [2, 15]s，< 15MB

仅支持 URL 格式，不支持 Base64

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Query 参数

Body 参数application/json必填

示例

上传图片类型素材资产上传视频类型素材资产

{
    "GroupId": "group-2026xxxxxxxxxx-xxxxx",
    "URL": "https://example.com/portrait.jpg",
    "Name": "人物正面照",
    "AssetType": "Image",
    "ProjectName": "default"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

上传图片类型素材资产上传视频类型素材资产

curl --location 'https://api.example.com/api/v3/?Action=CreateAsset&Version=2024-01-01' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "GroupId": "group-2026xxxxxxxxxx-xxxxx",
    "URL": "https://example.com/portrait.jpg",
    "Name": "人物正面照",
    "AssetType": "Image",
    "ProjectName": "default"
}'

返回响应

🟢200

application/json

创建成功（素材异步处理中）

Bodyapplication/json

示例

{
    "ResponseMetadata": {
        "RequestId": 2.0260328e+31,
        "Action": "CreateAsset",
        "Version": "2024-01-01T00:00:00.000Z",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "Id": "asset-2026xxxxxxxxxx-xxxxx"
    }
}

🟠400

🟠401

修改于 2026-05-19 09:04:28

更新素材资产组合信息（UpdateAssetGroup）

查询素材资产信息（GetAsset）