Alibaba Cloud Model Studio:Referencia de la API HappyOyster-Directing-Query World Detail

Consulte el estado actual, los parámetros de creación y la información ScriptList retornable de un solo World de Directing. Para el sondeo del progreso de construcción, utilice el endpoint Query World Build Status.

Ámbito

Consulte el estado actual, los parámetros de creación y la información ScriptList retornable de un solo World de Directing. Antes de llamar, confirme lo siguiente:

• Autenticación: Solo se admite la API Key principal; no se pueden utilizar API Keys temporales (código de error 403003).

  • Obtenga la API Key principal: Obtener y configurar una API Key.

• Requisitos previos: Consulte con el encryptedWorldId devuelto por Crear World. Para el sondeo del progreso de construcción, utilice Consultar estado de construcción de World.

• Caller: Llamado por su servidor.

Solicitud HTTP

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/worlds/detail?encryptedWorldId={encryptedWorldId}' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedWorldId": "enc_a1b2****",
        "name": "Midnight Visitor",
        "status": "ready",
        "mode": 2,
        "creationModel": "scriptlist",
        "prompt": null,
        "eventStyle": "normal",
        "perspective": null,
        "uploadMode": null,
        "resolution": "720p",
        "layout": null,
        "narrative": null,
        "refWorldId": null,
        "firstFrameImage": {
            "url": "https://cdn.happyoyster.com/frames/room.png",
            "referenceType": "default"
        },
        "inputImages": null,
        "scriptList": {
            "synopsis": "Late at night, Su Li is startled awake by a knock at the door.",
            "videoTitle": "Midnight Visitor",
            "subjects": [
                {
                    "label": "[character_1]",
                    "name": "Su Li",
                    "type": "character",
                    "refImage": {
                        "url": "https://cdn.happyoyster.com/subjects/suli.png",
                        "referenceType": "default"
                    }
                }
            ],
            "acts": [
                {
                    "turn": 1,
                    "content": "Rain beats against the window, and [character_1] is startled awake from sleep.",
                    "cameraType": "Static",
                    "shotSize": "Wide",
                    "cut": "long-take"
                },
                {
                    "turn": 2,
                    "content": "[character_1] walks toward the door, and the knocking sounds again outside.",
                    "cameraType": "Push-in",
                    "shotSize": "Close-up",
                    "cut": "long-take"
                }
            ]
        },
        "previewUrl": null,
        "aspectRatio": null,
        "createdAt": "2026-06-03T10:00:00Z",
        "updatedAt": "2026-06-03T10:05:00Z"
    }
}

Estados previos y notas de llamada

• Este endpoint puede consultar un World en estado generating, ready o failed.
• No refleja el campo async de la solicitud de creación.
• Los campos de imagen devuelven solo URL y referenceType, y nunca devuelven base64. Los inputImages para el modo simple se persisten como imágenes de referencia y pueden devolverse en el detalle; scriptlist no acepta este campo.
• Cuando scriptList se analiza correctamente, se devuelve la estructura almacenada completa, y acts se devuelve en su totalidad según el contenido almacenado; cuando falla el análisis, se devuelve scriptList=null, y no se utiliza un acts vacío para indicar un fallo de análisis.
• Consultar un World de otro modelo, de otra cuenta principal o uno que haya sido eliminado siempre devuelve 403001, sin revelar si el recurso existe.

Códigos de error

Si la llamada al modelo falla y devuelve un error, consulte Códigos de error de HappyOyster para resolverlo.

Siguientes pasos

• Query World List: paginar a través de todos los Worlds de Directing.
• Eliminar World: elimine un World que ya no utilice.
• Cuando el World está en estado ready, puede Obtener credencial de Travel.