Skip to content

上传与素材 ​

生成接口支持公网媒体 URL 时,可以直接提交 URL。模型要求素材引用,或需要复用媒体时,再创建素材。

选择流程 ​

你的输入下一步
模型支持的稳定公网 URL直接放入生成请求。
需要复用的模型素材引用上传 URL,再查询准备结果。
用于联调的本地文件用 multipart 上传,在模型支持时使用返回的 URL。
需要按项目整理素材创建素材分组,上传时传入 group_id。

需要模型素材引用时,在上传请求中传入实际使用的 model 和 mode=asset;保存返回的 asset_id。处于 syncing 时继续查询同一 ID 的详情,详情查询会尝试同步已提交的准备结果。失败时查看 sync_error,不要无条件重复上传或继续生成。

ID、URL 与可用状态 ​

asset_xxx 是你的 MoonNexAI 素材 ID。Asset://asset_xxx 只适用于支持该引用的模型,需要显式放入每次生成请求;上传不会自动把素材附加到后续任务。

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

MoonNexAI OSS 仅供联调测试,不承诺长期保存或持续可用。正式业务使用自有存储的稳定匿名公网直链。上传与素材准备的收费以控制台和实际记录为准;生成按模型单独计费。

接口文档 ​