查询单个 Adventure World 的完整元数据和可回显创建参数。构建进度轮询请使用查询World构建状态接口。
适用范围
查询单个 Adventure World 的完整元数据和可回显创建参数。调用前请确认以下事项：
-
鉴权要求：仅支持主 API Key调用，临时 API Key 不可用（错误码
403003）。- 获取主 API Key：获取与配置 API Key。
-
前置条件：使用创建World接口返回的
encryptedWorldId查询。构建进度轮询应使用查询World构建状态。 - 调用方：您的服务端调用。
HTTP调用
- 新加坡
- 华北2（北京）
- 美国（弗吉尼亚）
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds/detail调用时请将{WorkspaceId}替换为真实的Workspace ID。请求参数 |
|
Authorization string （必选）API Key 鉴权。仅支持主 API Key，以 sk- 开头，如 sk-xxx。通常配置为环境变量 $DASHSCOPE_API_KEY。临时 API Key（st- 开头）调用返回 403003。 | |
Query 参数 | |
encryptedWorldId string （必选）当前主账号名下的 Adventure 加密 World ID。由创建World接口返回。 |
响应参数 |
|
code integer返回码。0 表示成功，非 0 为错误码。 | |
message string错误信息。成功时为 null。 | |
data object响应数据。失败时为 null。
属性 encryptedWorldId string加密 World ID。name stringWorld 名称。status string构建状态：generating / ready / failed。mode integerAdventure 恒为 1。creationModel stringAdventure 恒为 simple。prompt string创建时提交的顶层 Prompt。eventStyle nullAdventure 不使用该创建参数，通常为 null。该字段仅 Directing creationModel=simple 生效。perspective string视角：first_person / third_person。uploadMode string固定为 first_frame。resolution nullAdventure 不使用该字段，通常为 null。aspectRatio nullAdventure 不使用该字段，固定为 null。layout nullAdventure 不使用该字段，通常为 null。narrative nullAdventure 不使用该字段，通常为 null。refWorldId string衍生创建时使用的加密参考 World ID；无则为 null。firstFrameImage object创建时的必填首帧图片；只返回 URL 形式。含 url 和 referenceType。inputImages nullAdventure 当前不使用该字段。scriptList nullAdventure 不支持 ScriptList，固定为 null。previewUrl null当前固定为 null。createdAt string创建时间，ISO 8601 格式。updatedAt string最近更新时间，ISO 8601 格式。 |
前置状态与调用注意事项
- 本接口可查询
generating、ready或failedWorld；部分构建产物在未就绪时可能为null。 - 详情接口不回显
async，因为它是调用行为开关，不是 World 属性。 - 图片只返回 URL 和
referenceType，不会回传创建请求中的 base64 内容。 - 查询其它模型、其它主账号或已删除的 World 均返回
403001，不会泄漏资源是否存在。