素材分组
按项目或业务用户整理当前账号的素材。分组是 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 和已有引用不会随分组删除;需要停用素材时单独操作。