Alibaba Cloud Model Studio:HappyOyster-Directing-Delete World APIリファレンス

現在のプライマリアカウント配下のDirectingワールドを削除します。同じアカウント配下にワールドが存在しなくなった場合、冪等にdeleted=falseを返します。

スコープ

現在のプライマリアカウント配下のDirectingワールドを削除します。呼び出す前に、以下を確認してください。

• 認証：プライマリ API Key のみがサポートされています。一時的な API Key は使用できません（エラーコード 403003）。

  • プライマリ API Key を取得する：API Key の取得と設定。

• 前提条件：Create World によって返された encryptedWorldId を使用して削除します。

• 呼び出し元：お使いのサーバーから呼び出されます。このエンドポイントはリクエストボディフィールド userAgent を受け付けません。

HTTP リクエスト

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/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
    }
}

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedWorldId": "enc_a1b2****",
        "deleted": false
    }
}

前提条件となるステータスと呼び出しに関する注意事項

• 同じアカウントの下に World が存在しなくなった場合、403001 ではなく code=0 と deleted=false が返されます。
• IDが解析可能であってもアカウントを跨ぐ場合、ワークスペースと一致しない場合、またはリソースがDirectingワールドではない場合は、403001が返されます。
• 削除後、このワールドへの後続のクエリは存在しないまたは削除済みのリソースとして処理されます。

エラーコード

モデルの呼び出しに失敗してエラーが返された場合は、HappyOyster エラーコードを参照して解決してください。

次のステップ

• ワールドリストの照会：残りのDirectingワールドを表示します。
• ワールドの作成：新しいDirectingワールドを作成します。