Skip to content

素材资源 ​

生成接口支持稳定公网媒体 URL 时,可直接使用 URL。只有目标模型支持或要求素材引用时,才使用素材 ID。

上传、查询与使用 ​

  1. 上传时传入实际目标 model 和 mode=asset,保持原始 URL 可访问。
  2. 保存返回的 MoonNexAI asset_id、asset_ref。
  3. 查询同一 ID 的详情;处于 syncing 时,详情查询会尝试继续同步已有准备。
  4. 确认就绪后,在生成接口支持的媒体字段中显式传入引用。

使用素材引用前,确认 status=ready、preparation_status=ready 且 generation_ready=true,并确认上传时选择的模型支持此引用。review_status / review_passed 是补充状态,不能替代准备结果;已返回审核失败或错误时先处理错误。只有 OSS URL 可用不等于任意模型都支持 Asset://。

文件与项目整理 ​

本地文件可用 multipart mode=oss 取得托管测试 URL。MoonNexAI OSS 仅供测试,不承诺长期保存或持续可用;正式业务使用自有存储。其他模式和批量上传见高级选项。

分组用于整理自己的媒体。素材管理提供改名、移动与停用。以上操作都不会自动把媒体加入生成任务。