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