创建素材资产
更新时间：2026-07-27
POST
https://qianfan.baidubce.com/beta/aigc/generations/qianfan-assets
在指定的素材资产表内创建/传入素材资产。通过公共可访问的 URL 上传图片、视频或音频素材，并归属到指定的素材资产组合，返回素材资产的 id 用于后续使用。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
GroupId
string
素材资产所属的素材资产组合的 Id
可选
URL
string
上传素材资产的公共可访问地址URL
可选
Name
string
素材资产名称，上限 64 个字符
可选
AssetType
string
素材资产的类型
图片：
格式：jpeg、png、webp、bmp、tiff、gif、heic、heif
宽高比（宽/高）：(0.4, 2.5)
宽高长度（px）：(300, 6000)
大小：单张图片 < 30MB
视频：
格式：mp4、mov
分辨率：480p、720p、1080p
时长：单个视频时长 [2, 15]s
宽高比（宽/高）：[0.4, 2.5]
宽高长度（px）：[300, 6000]
总像素数：宽×高 ∈ [409600, 2086876]
大小：单个视频不超过 50MB
帧率（FPS）：[24, 60]
音频：
格式：wav、mp3
时长：单个音频时长 [2, 15]s
大小：单个音频不超过 15MB
可选
请求结构
POST /beta/aigc/generations/qianfan-assets HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"GroupId": "6a5de0*****3b11735",
"URL": "https://example.com/image.jpg",
"Name": "qf-test-asset-0720-01",
"AssetType": "Image"
}示例代码
请求示例
curl -X POST "https://qianfan.baidubce.com/beta/aigc/generations/qianfan-assets" \
-H "Authorization: Bearer bce-v3/ALTAK-*************eb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"GroupId": "6a5de0060b6a0aca73b11735",
"URL": "https://example.com/image.jpg",
"Name": "qf-test-asset-0720-01",
"AssetType": "Image"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
错误码，0 表示操作成功
可选
message
string
错误信息，操作成功时为空字符串
可选
request_id
string
本次请求的 ID
可选
result
object {1}
创建结果对象
可选
显示子属性
隐藏子属性
id
string
素材资产的 Id
可选
响应示例
{
"code": 0,
"message": "",
"request_id": "as-z2qn19gf1v",
"result": {
"id": "6a5de0100b6a0aca73b11737"
}
}评价此篇文章