MoonApiX Docs

Appearance

图像素材 ​

图像素材用于在图片编辑、图生图、视频参考和多步骤创作中复用图片文件。外部图片 URL 不稳定时，建议先上传为 MoonApiX 托管 URL。

常用入口 ​

方法路径用途
POST/v1/assets/uploads上传图片素材。
GET/v1/assets查询素材列表。
GET/v1/assets/{asset_id}查询素材详情。

上传示例 ​

bash
curl https://moonapix.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -F "file=@./product.png" \
  -F "type=image" \
  -F "purpose=image_reference" \
  -F "mode=oss"

接入建议 ​

  • 图片编辑和混合图可以直接使用公网 URL，也可以先上传为托管 URL。
  • 多次复用的图片建议保存素材 ID、URL、文件名和用途。
  • 用户删除素材后，业务侧应同步更新引用状态，避免继续提交失效 URL。

相关页面 ​