查询单个 Directing World 的当前状态、创建参数和可返回的 ScriptList 信息。构建进度轮询请使用查询World构建状态接口。
适用范围
查询单个 Directing World 的当前状态、创建参数和可返回的 ScriptList 信息。调用前请确认以下事项：
-
鉴权要求：仅支持主 API Key调用，临时 API Key 不可用（错误码
403003）。- 获取主 API Key：获取与配置 API Key。
-
前置条件：使用创建World接口返回的
encryptedWorldId查询。构建进度轮询应使用查询World构建状态。 - 调用方：您的服务端调用。
HTTP调用
- 新加坡
- 美国（弗吉尼亚）
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/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 （必选）当前主账号名下的 Directing 加密 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 integerDirecting 恒为 2。creationModel stringsimple / scriptlist；决定 Travel 可调用的控制接口。prompt stringsimple 模式创建时的 Prompt；scriptlist 固定为 null。eventStyle string创建时的事件风格：normal / dramatic / regular。perspective nullDirecting 模型通常为 null。uploadMode nullDirecting World 通常为 null。resolution string480p / 720p。layout stringsimple 模式的镜头运动风格；未传或 scriptlist 时通常为 null。narrative stringsimple 模式的叙事风格；未传或 scriptlist 时通常为 null。refWorldId string衍生创建时使用的加密参考 World ID。firstFrameImage object创建时的首帧图；响应不返回 base64。inputImages arraysimple 模式创建时持久化的参考图；scriptlist 不接受该字段，通常为 null。scriptList object仅 scriptlist World 有值；结构化剧本反解失败时为 null。含 synopsis、videoTitle、scene、style、speed、language、setting、soundtrack、prologue、videoTags、subjects（含 label/name/type/refImage 等）、acts（按已存内容完整返回，含 turn/content/cameraType/shotSize/cut）。previewUrl null当前固定为 null。aspectRatio nullDirecting 模型固定为 null。createdAt string创建时间，ISO 8601 格式。updatedAt string最近更新时间，ISO 8601 格式。 |
前置状态与调用注意事项
- 本接口可查询
generating、ready或failedWorld。 - 不回显创建请求中的
async。 - 图片字段只返回 URL 和
referenceType，不会回传 base64。simple模式的inputImages会作为参考图持久化并可在详情中返回；scriptlist不接受该字段。 scriptList正常反解时返回已保存的完整结构，acts按已存内容完整返回；反解失败时返回scriptList=null，不会用空acts表示反解失败。- 查询其它模型、其它主账号或已删除的 World 均返回
403001，不会泄漏资源是否存在。