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

Consulte los metadatos completos y los parámetros de creación reproducibles de un solo Acting World. Para el sondeo del progreso de construcción, utilice el endpoint Query World Build Status.

Ámbito

Consulta los metadatos completos y los parámetros de creación reflejables de un único World de Acting. Antes de realizar la llamada, 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-acting/openapi/v1/worlds/detail?encryptedWorldId={encryptedWorldId}' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedWorldId": "enc_a1b2****",
        "name": "Late-Night Video Call",
        "status": "ready",
        "mode": 3,
        "creationModel": "simple",
        "prompt": "During a late-night video call, a quiet girl smiles back at the camera",
        "eventStyle": "first_frame",
        "perspective": null,
        "uploadMode": "first_frame",
        "resolution": "480p",
        "aspectRatio": "9:16",
        "layout": null,
        "narrative": null,
        "refWorldId": null,
        "firstFrameImage": {
            "url": "https://cdn.happyoyster.com/frames/portrait-call.jpg",
            "referenceType": "default"
        },
        "inputImages": null,
        "sceneImage": null,
        "roleImage": null,
        "scenePrompt": null,
        "rolePrompt": null,
        "scriptList": null,
        "previewUrl": null,
        "createdAt": "2026-09-09T08:00:00Z",
        "updatedAt": "2026-09-09T08:05:00Z"
    }
}

Estados previos y notas de llamada

• Este endpoint puede consultar un World en estado generating, ready o failed; algunos artefactos de construcción pueden ser null antes de estar listos.
• El endpoint de detalle no refleja async, porque es un modificador de comportamiento de llamada, no un atributo del World.
• Las imágenes se devuelven solo como URL y referenceType; el contenido base64 de la solicitud de creación no se devuelve.
• eventStyle suele tener el mismo valor que uploadMode; los clientes deben tratar uploadMode como el campo autoritativo para el modo de creación de Acting.
• El reproductor puede preleer aspectRatio, pero al entrar realmente a la sala debe seguir estableciendo la orientación a partir del valor de respuesta de Ingresar a Travel.
• 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

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