Skip to content

管理素材 ​

编辑自己的素材名称、说明或分组,或停用不再使用的记录。

编辑素材与移动分组 ​

bash
curl -X PATCH https://moonnexai.com/v1/assets/asset_xxx \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "product-reference",
  "description": "Updated reference",
  "group_id": "group_target"
}'

name、description、group_id 至少传一个。省略字段保持原值;空 description 可清空说明,name 不能为空。目标组必须启用且属于当前账号。

成功返回 HTTP 200 和更新后的平铺素材对象。移动保留原素材 ID、内容和已有准备结果,不会替换文件或为新模型建立准备。

删除素材 ​

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

此操作为本地软删除。以 HTTP 200、deleted=true、status=disabled 确认成功;素材不存在、不属于当前账号或已停用时,返回 404 / asset_not_found。

停用保留历史与审计,不承诺立即清除托管文件、使已发 URL 失效、取消生成任务或删除其他服务保存的媒体。删除分组是另一项操作,不会停用组内素材,见素材分组。

常见错误 ​

HTTP错误码说明
400invalid_asset_id、invalid_name、invalid_group_id、missing_update_fieldsID、名称或编辑字段无效。
404asset_not_found素材不存在、不属于当前账号或已停用。
404group_not_found目标组不存在、不属于当前账号或不可用。

相关页面 ​