MoonApiX Docs

简体中文

English

简体中文

English

外观

素材管理 ​

编辑素材名称、说明或所属分组，以及停用不再使用的素材。以下操作继续使用 MoonApiX asset_id；查询详情和目标模型准备状态见查询素材。

编辑素材与移动分组 ​

http
PATCH /v1/assets/{asset_id}

只能编辑当前账号的未禁用素材。请求至少包含 name、description、group_id 中的一个字段；省略的字段保持原值。

bash
curl -X PATCH https://moonapix.com/v1/assets/asset_xxx \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "product-reference",
    "description": "Updated reference",
    "group_id": "group_target"
  }'
字段类型说明
namestring可选。去除首尾空白后不能为空。
descriptionstring可选。传空字符串可清空说明。
group_idstring可选。移动到指定分组；目标组必须属于当前账号、处于 enabled 状态，且 domain 与素材一致。

成功返回 HTTP 200 和更新后的素材对象。V2 素材保留身份与存储表示，历史素材沿用既有响应表示；编辑不会启动目标模型准备。移动分组保留原 asset_id、文件内容和已有认证引用，不会重新上传或认证。此接口不能用来替换素材文件内容。

HTTP 状态错误码说明
400invalid_asset_id、invalid_name、invalid_group_id、missing_update_fieldsID、名称或更新字段无效。
404asset_not_found素材不存在、不属于当前账号或已禁用。
404group_not_found目标组不存在、不属于当前账号或未启用。
409group_domain_mismatch目标组与素材的用途域不一致。

删除素材 ​

http
DELETE /v1/assets/{asset_id}
bash
curl -X DELETE https://moonapix.com/v1/assets/asset_xxx \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

删除为软删除：只将当前账号的素材状态改为 disabled。请求无需正文，成功返回 HTTP 200 和带 deleted=true 的素材对象，关键字段如下：

json
{
  "object": "asset",
  "asset_id": "asset_xxx",
  "status": "disabled",
  "deleted": true
}

其余字段随该素材的既有表示返回，不能把本例当作查询目标模型准备状态的响应。请以本次 HTTP 200、deleted=true 和 status=disabled 确认删除结果。素材不存在、不属于当前账号或已经禁用时，返回 HTTP 404 / asset_not_found；重复删除不会再次返回成功对象。

软删除保留历史和审计记录，不物理清除托管文件，也不撤销其他服务中已有的认证引用。它不是清理存储空间、立即使已发出 URL 失效或取消已提交生成任务的操作。删除分组是另一个操作，且不会连带删除组内素材，见删除素材分组。

相关页面 ​