上传资产
/v1/assets向当前用户资产库上传文件。
此接口用于普通资产库资产和供应商接入资产。 返回结构始终为统一资产对象（统一模型）。
身份验证
Authorization Bearer
在 Authorization 请求头中使用 API key 作为 bearer token。
选择一种上传来源：
- 上传本地文件：从你的机器或服务器发送文件。
- 从 URL 导入：提供公开 HTTPS
sourceUrl，Token360 会下载并存储该文件。 - 上传 Base64 内容：当你已有 Base64 编码的文件内容时，提供
contentBase64。
提供 assetGroupId（或 groupId 以 legacy_rf_ 开头）会走供应商接入上传路径。
上传本地文件
当文件位于你的机器或服务器上时，使用此来源。
遗留 /api/v1/assets alias 仅支持本地文件来源。
请求体
filefilerequired要上传的文件。
namestring可选展示名称。
groupIdstring可选标准资产分组 ID，可从 GET /v1/asset-groups 获取。
assetGroupIdintegerLegacy 分组 ID，用于外部接入资产。
modelstringReal Face 或 Virtual Portrait 校验时可选目标模型名称。
响应
codeinteger响应状态码。
dataobject上传结果对象，统一资产模型。
data.idinteger内部资产 ID（外部上传返回遗留 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失败时的业务码。
错误处理
本地文件上传使用标准响应结构。缺失 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