CreateAsset

开发中

POST

/v1/super2/assets/CreateAsset

上传素材，获取素材ID
{
"Id": "Asset-2026**********-*****"
}

素材格式要求
图像

格式：jpeg、png、webp、bmp、tiff、gif、heic/heif
宽高比（宽/高）：(0.4, 2.5)
宽高长度（px）：(300, 6000)
大小：单张小于 30 MB
视频

格式：mp4、mov
分辨率：480p、720p
时长：[2, 15] 秒
宽高比（宽/高）：[0.4, 2.5]
宽高长度（px）：[300, 6000]
总像素数：[409600, 927408]（宽 × 高）
大小：单个不超过 50 MB
帧率 (FPS)：[24, 60]
音频

格式：wav、mp3
时长：[2, 15] 秒
大小：单个不超过 15 MB

注意
仅需入库推理需使用的素材，不需使用的请勿入库。
仅可使用已入库且状态为 Active 的 Asset ID；状态为 Failed 表示处理失败，无法用于推理。
可轮询 GetAsset 接口查询素材 Status，审核耗时通常在几秒到几十秒之间。

请求参数

Header 参数

Body 参数application/json

示例

{
    "GroupId": "group-20260605112813-lpwt2",
    "URL": "https://js.modelport.ai/apps/images/girl.jpg",
    "Name": "人像参考图",
    "AssetType": "Image",
    "ProjectName": "default"
  }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.modelport.ai/v1/super2/assets/CreateAsset' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer 您的Key' \
--header 'User-ID: 用户ID 需要管理员加白' \
--header 'Content-Type: application/json' \
--data '{
    "GroupId": "group-20260605112813-lpwt2",
    "URL": "https://js.modelport.ai/apps/images/girl.jpg",
    "Name": "人像参考图",
    "AssetType": "Image",
    "ProjectName": "default"
  }'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "Id": "asset-20260605120240-9fcbx"
}

修改于 2026-06-05 04:08:54

CreateAssetGroup

GetAsset