Skip to main content

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:

Solicitud HTTP

  • Singapore
  • EE. UU. (Virginia)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/detailReemplace {WorkspaceId} con su ID de espacio de trabajo real.

Parámetros de solicitud

  • Consultar detalle de World
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"
Authorization string (Requerido)Autenticación mediante API Key. Solo se admite la API Key principal; comienza con sk-, p. ej., sk-xxx. Normalmente se configura como la variable de entorno $DASHSCOPE_API_KEY. Una API Key temporal (que comienza con st-) devuelve 403003.
Parámetros de consulta
encryptedWorldId string (Requerido)Un ID de World cifrado de Acting bajo la cuenta principal actual. Devuelto por Crear World.

Parámetros de respuesta

Query succeeded
{
    "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"
    }
}
code integerCódigo de retorno. 0 indica éxito; un valor distinto de cero es un código de error.
message stringMensaje de error. null en caso de éxito.
data objectDatos de respuesta. null en caso de fallo.

Propiedades

encryptedWorldId stringID de World cifrado.name stringNombre del World.status stringEstado de construcción: generating / ready / failed.mode integerSiempre 3 para Acting.creationModel stringSiempre simple para Acting.prompt stringEl prompt de nivel superior enviado durante la creación.eventStyle stringUn campo de retorno por compatibilidad; cuando una creación conforme omite este campo, el servidor generalmente lo asigna desde uploadMode y refleja first_frame. No es un parámetro de creación de Acting, y los clientes no deben devolverlo.perspective nullActing no acepta un parámetro de creación de perspectiva; fijo en null.uploadMode stringFijo en first_frame.resolution string480p / 720p; 480p si no se especificó en la creación.aspectRatio string9:16 / 16:9; 9:16 si no se especificó en la creación.layout nullActing no acepta este parámetro de creación; fijo en null.narrative nullActing no acepta este parámetro de creación; fijo en null.refWorldId stringEl ID de World de referencia cifrado de Acting utilizado para una creación derivada; null si none.firstFrameImage objectLa imagen de primer fotograma requerida en la creación; se devuelve solo en formato URL, no se devuelve base64. Contiene url y referenceType.inputImages nullActing no utiliza actualmente este campo.sceneImage nullActing no utiliza las ranuras de imagen de escena/rol; fijo en null.roleImage nullActing no utiliza las ranuras de imagen de escena/rol; fijo en null.scenePrompt nullActing no utiliza prompts de escena/rol; fijo en null.rolePrompt nullActing no utiliza prompts de escena/rol; fijo en null.scriptList nullActing no admite ScriptList; fijo en null.previewUrl nullActualmente fijo en null.createdAt stringHora de creación, en formato ISO 8601.updatedAt stringÚltima hora de actualización, en formato ISO 8601.

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