管理素材
编辑自己的素材名称、说明或分组,或停用不再使用的记录。
编辑素材与移动分组
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 | 错误码 | 说明 |
|---|---|---|
400 | invalid_asset_id、invalid_name、invalid_group_id、missing_update_fields | ID、名称或编辑字段无效。 |
404 | asset_not_found | 素材不存在、不属于当前账号或已停用。 |
404 | group_not_found | 目标组不存在、不属于当前账号或不可用。 |