上传与管理私有素材

完成上传确认、选择参考图、理解私有素材 ID 与临时链接，并处理大小、归属和格式错误。

更新日期 2026-10-01

开始之前

素材管理显示自己的素材，可按类型、状态或名称筛选。预览链接只用于展示，任务应使用平台返回的引用标识。不要将其他用户的素材 ID、临时预览 URL 或供应商素材 ID 混作自己的 asset:// 引用。

选择本地文件或已有素材
在创作输入区选择本地上传，或从自己的素材库选择。文件类型必须符合所选模型。
等上传和确认完成
上传进度结束不代表 active。SDK 先 begin，再向短期存储地址 PUT，最后 complete 确认；确认失败可恢复该 upload_id。
使用返回的 reference
把资产返回的 asset:// 引用提交给图片/视频接口。本站 Key 不会发送到对象存储，私有素材由服务器验证归属后处理。
检查配额再删除
删除可能影响后续引用。先确认任务不再使用该素材；删除素材并不等于删除历史费用或取消生成任务。

JPG/PNG/WebP 原图默认最多 100 MiB；组级配额或管理员可更低。转发图片单张 10 MiB、总量 20 MiB 与像素解码限制仍保留。视频和音频不是按这个图片上限处理，是否可引用及具体限制以模型详情和素材接口校验为准。

现象	先检查什么	如何处理
上传成功但无法选择	是否已 complete、active 且为支持类型	完成确认并刷新素材列表。
确认请求断网	upload_id 是否仍有效	恢复 complete，不盲目重复上传同一个文件。
404 素材不存在	引用是否属于本人	核对当前账户与 reference，不能跨用户共享数字 ID。
容量/数量超限	个人和分组配额	清理不再需要的素材或联系管理员，不能用不同后缀绕过。

完成上传确认、选择参考图、理解私有素材 ID 与临时链接，并处理大小、归属和格式错误。

更新日期 2026-10-01

选择本地文件或已有素材
在创作输入区选择本地上传，或从自己的素材库选择。文件类型必须符合所选模型。
等上传和确认完成
上传进度结束不代表 active。SDK 先 begin，再向短期存储地址 PUT，最后 complete 确认；确认失败可恢复该 upload_id。
使用返回的 reference
把资产返回的 asset:// 引用提交给图片/视频接口。本站 Key 不会发送到对象存储，私有素材由服务器验证归属后处理。
检查配额再删除
删除可能影响后续引用。先确认任务不再使用该素材；删除素材并不等于删除历史费用或取消生成任务。

现象	先检查什么	如何处理
上传成功但无法选择	是否已 complete、active 且为支持类型	完成确认并刷新素材列表。
确认请求断网	upload_id 是否仍有效	恢复 complete，不盲目重复上传同一个文件。
404 素材不存在	引用是否属于本人	核对当前账户与 reference，不能跨用户共享数字 ID。
容量/数量超限	个人和分组配额	清理不再需要的素材或联系管理员，不能用不同后缀绕过。