素材库常见问题

常见问题

控制台创建的分组在接口里看不到

控制台创建的分组会出现在 GET /api/v1/materials/groups。如果手上只有分组 ID，也可以直接在 POST /api/v1/materials/assets 里作为 group_id 使用，平台会先确认分组存在，再把它绑定到当前账号，之后就会出现在分组列表里。

审核失败的原因在哪里看

查询素材返回的 data.asset.error_message 就是失败原因，只有 status 为 Failed 时才有内容，正常和可用状态为 null。

图片审核需要多久

审核和预处理是异步的，时间取决于素材本身，平台不对所有图片承诺统一时长。程序应轮询同一个素材 ID，不要因为初始状态是 Processing 就重复提交。

频繁查询会不会被限制

状态查询是轻量接口，但不要在一个轮询周期内重复并发请求，建议 5～10 秒查询一次同一个素材 ID。请求过于频繁时接口返回 HTTP 429，稍后重试即可，已提交的素材不受影响。

图片地址有什么要求

必须是平台服务端能直接下载的 http(s) 地址（http 和 https 都支持），不能依赖 Cookie、Referer、登录页面或 IP 白名单。如果图片在需要登录的地址后面、在内网或只有本地文件，请先转存到对象存储或使用 data_url，否则会出现素材处理失败。

只要能提供公网地址就优先用 image_url：平台原样透传地址，不做下载和转存，提审速度最快；data_url 需要上传整张图的 base64，明显更慢，并且会占用平台存储。