图像素材
在图片编辑、图生图与视频参考中复用图片。模型支持时可直接使用稳定公网 URL;是否支持或需要模型素材引用取决于目标模型。
上传本地文件
bash
curl https://moonnexai.com/v1/assets/uploads \
-H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
-F "file=@./reference.png" \
-F "type=image" \
-F "purpose=video_reference" \
-F "mode=oss"此请求创建 MoonNexAI OSS 测试 URL。OSS 仅供测试,不承诺长期保存或持续可用;正式业务使用自有存储。
模型素材引用
需要模型素材引用时,在上传请求中传入实际使用的 model 和 mode=asset;保存返回的 asset_id。处于 syncing 时继续查询同一 ID 的详情,详情查询会尝试同步已提交的准备结果。失败时查看 sync_error,不要无条件重复上传或继续生成。
使用素材引用前,确认 status=ready、preparation_status=ready 且 generation_ready=true,并确认上传时选择的模型支持此引用。review_status / review_passed 是补充状态,不能替代准备结果;已返回审核失败或错误时先处理错误。只有 OSS URL 可用不等于任意模型都支持 Asset://。