删除当前主账号名下的 Acting World。同账号下 World 已不存在时幂等返回 deleted=false。
适用范围
删除当前主账号名下的 Acting World。调用前请确认以下事项:
-
鉴权要求:仅支持主 API Key调用,临时 API Key 不可用(错误码
403003)。- 获取主 API Key:获取与配置 API Key。
-
前置条件:使用创建World接口返回的
encryptedWorldId删除。 -
调用方:您的服务端调用。本接口不接受请求体字段
userAgent。
HTTP调用
新加坡
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/delete
调用时请将{WorkspaceId}替换为真实的Workspace ID。
美国(弗吉尼亚)
POST https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/delete
调用时请将{WorkspaceId}替换为真实的Workspace ID。
请求参数 | |
Content-Type 请求内容类型。此参数必须设置为 | |
Authorization API Key 鉴权。仅支持主 API Key,以 | |
请求体(Request Body) | |
encryptedWorldId 要删除的 Acting 加密 World ID。由创建World接口返回。 |
响应参数 | |
code 返回码。 | |
message 错误信息。成功时为 | |
data 响应数据。失败时为 |
前置状态与调用注意事项
- 同账号下 World 已不存在时返回
code=0且deleted=false,不返回403001。 - ID 可解析但跨账号、workspace 不匹配或资源不是 Acting World 时,返回
403001。 - 删除后继续调用详情、构建状态或换凭证会按资源不存在处理。
- 已经签发但尚未使用的 ticket 不应被视为长期有效引用;进房时仍会重新校验 World 可用状态。
错误码
如果模型调用失败并返回报错信息,请参见HappyOyster 错误码进行解决。