跳转到主要内容
千问AI平台 home page
文档
Adventure

HappyOyster-Adventure-删除World API参考

删除当前千问AI平台账号名下的 Adventure World。同账号下 World 已不存在时幂等返回 deleted=false。

POST
/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds/delete
cURL - 删除World
curl --location 'https://maas.qianwenaiapi.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds/delete' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "encryptedWorldId": "{encryptedWorldId}"
}'
{
  "code": 0,
  "message": null,
  "data": {
    "encryptedWorldId": "enc_a1b2****",
    "deleted": true
  }
}

适用范围

删除当前千问AI平台账号名下的 Adventure World。调用前请确认：
  • 仅支持主 API Key调用，临时 API Key 不可用（错误码 403003）。
  • 使用创建World接口返回的 encryptedWorldId 删除。
  • 同账号下 World 已不存在时返回 code=0 且 deleted=false，不返回 403001。
调用失败时，请参见HappyOyster 错误码。

鉴权

​
string
header
必填

千问AI平台 API Key。仅支持主 API Key（sk- 开头）。详见获取 API Key。

Header 参数

​
string
默认值"application/json"
必填

请求内容类型。此参数必须设置为 application/json。

​
string
必填

API Key 鉴权。仅支持主 API Key，以 sk- 开头，如 sk-xxx。通常配置为环境变量 $DASHSCOPE_API_KEY。临时 API Key（st- 开头）调用返回 403003。

请求体

application/json
​
string
必填

要删除的 Adventure 加密 World ID。由创建World接口返回。

响应

200-application/json
​
integer

返回码。0 表示成功，非 0 为错误码。

​
string

错误信息。成功时为 null。

​
object

响应数据。失败时为 null。