上传虚拟人素材接口文档
1 上传素材
接口地址：https://gemini-api.cn/api/asset/create
头信息：Authorization：Bearer xxx(wetoken的令牌密钥)
参数格式：JSON
请求方式：POST
上传素材后，需要等几秒，查询素材状态正常后才可以使用，查询素材接口不支持高流量并发查询，上传成功后，本地落库使用
参数：
| 参数名 | 类型 | 要求 | 说明 |
|---|---|---|---|
| url | string | 必填 | 外网可访问的图片地址| 格式：jpeg、png、webp、bmp、tiff、gif、heic/heif 宽高比（宽/高）： (0.4, 2.5) 宽高长度（px）：(300, 6000) 大小：单张图片小于 30 MB。 |
| name | string | 必填 | 素材名称 |
成功返回格式：
{
"ResponseMetadata": {
"RequestId": "202603241118118399E4527AE2BDDDEAC2",
"Action": "CreateAsset",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"Id": "asset-20260324111811-p9fjp"
}
}
请求样例：
curl --request POST \
--url https://gemini-api.cn/api/asset/create \
--header 'Accept: */*' \
--header 'Accept-Encoding: gzip, deflate, br' \
--header 'Authorization: Bearer sk-xxxxxxxxx' \
--header 'Connection: keep-alive' \
--header 'Content-Type: application/json' \
--data '{
"url":"你的图片地址",
"name":"大门"
}'
2 查询素材
接口地址：https://gemini-api.cn/api/asset/get?id=xx
头信息：Authorization：Bearer xxx(wetoken的令牌密钥)
请求方式：GET
参数：
| 参数名 | 类型 | 要求 | 说明 |
|---|---|---|---|
| id | string | 必填 | asset_id |
Status状态说明：
任务状态。
- Active：素材资产（Asset）已处理完毕，可以使用。
- Processing：素材资产（Asset）正在预处理，无法使用。
- Failed：素材资产（Asset）处理失败。
成功返回格式：
{
"ResponseMetadata": {
"RequestId": "20260324112034D08AB02396C659CB0BCD",
"Action": "GetAsset",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"Id": "asset-xxx",
"Name": "大门",
"URL": "xxxxx",
"AssetType": "Image",
"GroupId": "xxxx",
"Status": "Active",
"CreateTime": "2026-03-23T07:17:36Z",
"UpdateTime": "2026-03-23T07:17:41Z",
"ProjectName": "default"
}
}
请求样例：
curl --request GET \
--url 'https://gemini-api.cn/api/asset/get?id=asset_id' \
--header 'Accept: */*' \
--header 'Accept-Encoding: gzip, deflate, br' \
--header 'Authorization: Bearer sk-xxxx' \
3 上传多媒体素材
接口地址：https://gemini-api.cn/api/asset/createMedia
头信息：Authorization：Bearer xxx(wetoken的令牌密钥)
参数格式：JSON
请求方式：POST
上传素材后，需要等几秒，查询素材状态正常后才可以使用，查询素材接口不支持高流量并发查询，上传成功后，本地落库使用
参数：
| 参数名 | 类型 | 要求 | 说明 |
|---|---|---|---|
| url | string | 必填 | 素材的公网地址 |
| name | string | 必填 | 素材名称 |
| assetType | string | 必填 | 素材类型，取值范围：Image，Video，Audio 传入单个图像要求 - 格式：jpeg、png、webp、bmp、tiff、gif、heic/heif - 宽高比（宽/高）： (0.4, 2.5) - 宽高长度（px）：(300, 6000) - 大小：单张图片小于 30 MB 传入单个视频要求 - 格式：mp4、mov - 分辨率：480p、720p - 时长：单个视频时长 [2, 15] s - 尺寸： - 宽高比（宽/高）：[0.4, 2.5] - 宽高长度（px）：[300, 6000] - 总像素数：[640×640=409600, 834×1112=927408]，即宽和高的乘积符合 [409600, 927408] 的区间要求。 - 大小：单个视频不超过 50 MB - 帧率 (FPS)：[24, 60] 传入单个音频要求 - 格式：wav、mp3 - 时长：单个音频时长 [2, 15] s - 大小：单个音频不超过 15 MB |
成功返回格式：
{
"ResponseMetadata": {
"RequestId": "202603241118118399E4527AE2BDDDEAC2",
"Action": "CreateAsset",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"Id": "asset-20260324111811-p9fjp"
}
}
请求样例：
curl --request POST \
--url https://gemini-api.cn/api/asset/createMedia \
--header 'Authorization: Bearer sk-xxx' \
--header 'Content-Type: application/json' \
--data '{
"url":"素材公网地址",
"name":"素材名称",
"assetType":"素材类型，例：Audio"
}'
4 如何使用素材
提交视频任务接口中，修改content.<模态>_url.url 字段中使用 素材 URI，下例：为参考视频使用素材
curl -X POST http://localhost:8081/v1/videos \
-H "Authorization: Bearer YOUR_DOUBAO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "d-s-2-0-260128",
"prompt": "使用参考视频的镜头语言，并使用参考音频作为背景音乐",
"reference_image_urls": [
"asset://ASSET_ID",
"asset://ASSET_ID"
],
"reference_video_url": "asset://ASSET_ID",
"duration": 5,
"ratio": "adaptive",
"resolution": "720p",
"generate_audio": true
}'
5
对外统一通过调用以下路径，
POST /api/asset/createGET /api/asset/getPOST /api/asset/createMedia
计费配置
仅对下面两个动作按次计费：
create对应价格模型：asset_createcreateMedia对应价格模型：asset_create_media
get 查询接口不计费。\r\n\r\n结算条件：\r\n\r\n- create、createMedia 仅在上游返回 2xx 且响应体 Result.Id 非空时才最终扣费；\r\n- 仅 2xx 但 Result.Id 为空，或上游异常时，会自动退款。
修改于 2026-03-27 09:16:49