上传资产
/v1/assets向当前用户资产库上传文件。
此接口用于普通资产库资产和供应商接入资产。 返回结构始终为统一资产对象（统一模型）。
身份验证
Authorization Bearer
在 Authorization 请求头中使用 API key 作为 bearer token。
请求体
filefilerequired要上传的文件。
namestring可选展示名称。
groupIdstring可选标准资产分组 ID，可从 GET /v1/asset-groups 获取。
assetGroupIdintegerLegacy provider 分组 ID，用于供应商接入资产。
modelstringRealFace 或 Virtual Portrait 校验时可选目标模型名称。
提供 assetGroupId（或 groupId 以 legacy_rf_ 开头）会走供应商接入上传路径。
响应
codeinteger响应状态码。
dataobject上传结果对象，统一资产模型。
data.idinteger内部资产 ID（供应商上传返回遗留的 provider ID）。
data.assetIdstring资产公共 ID。
data.token360AssetIdstringassetId 的兼容别名。
data.tenantIdinteger租户 ID。
data.userIdinteger所有者用户 ID。
data.userNamestring所有者显示名。
data.sharedboolean是否已共享给调用方。
data.sharePermissionstring共享时的权限。
data.shareExpiresAtstring共享到期时间（存在时）。
data.assetGroupIdstring分组公共 ID。
data.groupNamestring分组名称。
data.mediaTypestring检测到的媒体类型。
data.assetKindstring资产类型。
data.sourceTypestring来源类型。
data.statusstring初始状态。
data.namestring资产名称。
data.assetTypestring资产类型标签。
data.filenamestring存储后的文件名。
data.mimeTypestring资源 MIME 类型。
data.sizeBytesinteger文件大小（字节）。
data.fileTypestring文件扩展名或格式。
data.widthinteger图片/视频宽度（单位像素），可用时返回。
data.heightinteger图片/视频高度（单位像素），可用时返回。
data.aspectRatiostring图片/视频宽高比，可用时返回。
data.durationSecondsnumber音视频时长（秒），可用时返回。
data.frameRatenumber视频帧率，可用时返回。
data.providerLastErrorobject提供商错误详情（如有）。
data.urlstring访问链接。
data.thumbnailUrlstring缩略图链接（如果有）。
data.expiresAtstring到期时间（如果有）。
data.requestIdstring任务链路请求 ID。
data.modelNamestring生成资源使用的模型名。
data.modelTypestring生成资源使用的模型类型。
data.byteplusAssetIdstringBYTEPLUS 侧资产 ID。
data.providerRefsobject按提供商和引用类型聚合的映射关系。
data.originalFilenamestring上传时原始文件名。
data.createdAtstring创建时间。
data.updatedAtstring更新时间。
msgstring响应信息。
serviceCodestring | null失败时的业务码。
错误处理
资产上传使用标准响应结构。缺失 multipart file 会返回校验错误。文件大小被拒绝时会返回 ASSET_FILE_TOO_LARGE。
常见 serviceCode：
UNIFIED_ASSET_FILE_REQUIREDUNIFIED_ASSET_GROUP_REQUIREDUNIFIED_ASSET_GROUP_NOT_FOUNDASSET_GROUP_NOT_FOUNDASSET_GROUP_ACCESS_DENIEDASSET_GROUP_NOT_ACTIVEASSET_GROUP_TYPE_UNSUPPORTEDASSET_GROUP_PROVIDER_REF_MISSINGASSET_FILE_REQUIREDASSET_FILE_TYPE_UNSUPPORTEDASSET_FILE_TOO_LARGEASSET_PROVIDER_REJECTEDASSET_PROVIDER_UNAVAILABLE