asset:// 加素材 ID 即可，不用自己托管文件或维护公网链接。
- 素材只有你自己的密钥能看到和引用。
- 文件会一直保存，直到你删除。
- 上传和存储免费，只按生成计费。
- 控制台的 素材库 页面和在线使用里的「从素材库选择」用的是同一个素材库：网页上传的素材可以在 API 里引用，API 上传的也能在网页里看到和使用。
上传素材
POST /v1/assets，用 multipart/form-data 提交：
file
必填
素材文件。格式以文件内容为准：图片支持 PNG、JPEG、WebP（不超过 30 MB），视频支持 MP4（不超过 50 MB），音频支持 MP3、WAV（不超过 15 MB）。
string
素材名称，不超过 100 个字符，方便你自己辨认。
人像素材（真人照片）
带真人人脸的照片直接用链接传给 Seedance，会被上游审核拦截（任务失败，报错InputImageSensitiveContentDetected.PrivacyInformation，费用自动退回）。真人照片请作为人像素材上传，再用 asset:// 引用：
string
默认值:"general"
general（普通素材）或 portrait（人像素材）。人像素材只支持 PNG、JPEG、WebP 图片。string
上传人像素材时必须传
true，表示你确认：照片中的人物是你本人，或你已取得其本人对该照片用于 AI 视频生成的单独同意，且不会用于冒充他人、虚假信息或其他违法用途。平台会记录本次确认的时间与来源 IP。- 上传时平台会先把照片提交给视频服务方做人像审核，通常 10 秒左右完成，服务方繁忙时可能要几分钟。审核通过后
status为ready；上传最多等 20 秒，还没完成时返回processing，可以用GET /v1/assets/{id}查看进度。 - 引用还在
processing的人像素材时，生成请求最多等 30 秒；仍未完成会返回 409（asset_not_ready），不会扣费，请过几分钟再试。 - 照片未通过审核时上传返回 400，素材不会保存，请换一张清晰的单人正脸照片。
- 上传时返回
processing、之后才审核失败的照片，status会变为failed。引用它的生成请求返回 400（asset_rejected），不会扣费。请删除这个素材，换一张照片重新上传。 - 人像素材目前只能用于 Seedance 系列模型。其他模型引用人像素材时，请求会因为没有可用渠道而失败。
- 删除人像素材时，平台会同时删除服务方那边的副本。服务方还在处理这张照片时，删除会返回 202（
status为deleting）：素材立即不能再引用，平台会在后台继续完成删除。
在生成请求里引用
把uri 填到原本放链接的位置。以 Seedance 多模态参考为例：
asset://ast_… 的字段值会被识别，写在提示词文字里的、或者用作字段名的不会被替换。
引用只在 JSON 请求体（Content-Type: application/json）里生效。multipart/form-data 或表单请求里出现 asset:// 会直接返回 400；Responses WebSocket 暂不支持。请改用 JSON 请求，或直接传文件链接。