素材资源
生成接口支持稳定公网媒体 URL 时,可直接使用 URL。只有目标模型支持或要求素材引用时,才使用素材 ID。
上传、查询与使用
- 上传时传入实际目标
model和mode=asset,保持原始 URL 可访问。 - 保存返回的 MoonNexAI
asset_id、asset_ref。 - 查询同一 ID 的详情;处于 syncing 时,详情查询会尝试继续同步已有准备。
- 确认就绪后,在生成接口支持的媒体字段中显式传入引用。
使用素材引用前,确认 status=ready、preparation_status=ready 且 generation_ready=true,并确认上传时选择的模型支持此引用。review_status / review_passed 是补充状态,不能替代准备结果;已返回审核失败或错误时先处理错误。只有 OSS URL 可用不等于任意模型都支持 Asset://。
文件与项目整理
本地文件可用 multipart mode=oss 取得托管测试 URL。MoonNexAI OSS 仅供测试,不承诺长期保存或持续可用;正式业务使用自有存储。其他模式和批量上传见高级选项。