Skip to content

素材分组 ​

按项目或业务用户整理当前账号的素材。分组是 MoonNexAI 本地记录,不代表素材已通过模型准备。上传未传 group_id 时使用默认分组。

创建分组 ​

bash
curl https://moonnexai.com/v1/asset-groups \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "project-a",
  "description": "Project A materials",
  "domain": "media"
}'

name 必填,description、domain 可选;媒体素材使用 media。保存返回的 group_id:

json
{
  "object": "asset_group",
  "id": "group_xxx",
  "group_id": "group_xxx",
  "name": "project-a",
  "description": "Project A materials",
  "domain": "media",
  "group_type": "custom",
  "status": "enabled",
  "visibility": "private"
}

查询分组列表与详情 ​

bash
curl "https://moonnexai.com/v1/asset-groups?domain=media&p=1&page_size=20" \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>"

使用 p、page_size(默认 10,最多 100)分页,可按 domain、status=enabled|disabled 筛选。列表返回 success=true、data[]、count、total。单组详情使用 GET /v1/asset-groups/{group_id}。

上传与查询中使用分组 ​

bash
curl https://moonnexai.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.0-kz-fast",
  "mode": "asset",
  "type": "image",
  "url": "https://example.com/reference.png",
  "group_id": "group_xxx"
}'

列表使用 GET /v1/assets?group_id=group_xxx&p=1&page_size=20;详情可附 ?group_id=group_xxx 校验,不匹配时返回未找到。分组筛选不会授予其他账号访问权。

更新分组 ​

bash
curl -X PATCH https://moonnexai.com/v1/asset-groups/group_xxx \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "project-a-updated",
  "description": "Updated materials"
}'

name、description 至少传一个。移动素材使用素材管理。

删除分组 ​

bash
curl -X DELETE https://moonnexai.com/v1/asset-groups/group_xxx \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>"

仅可停用自定义组;默认组和系统组不能删除。本地停用成功返回 HTTP 200、deleted=true、status=disabled。组内素材仍保留,ID 和已有引用不会随分组删除;需要停用素材时单独操作。

相关页面 ​