Alibaba Cloud Model Studio:Référence de l'API HappyOyster-Directing-Query World Detail

Interroger le statut actuel, les paramètres de création et les informations ScriptList retournables d'un seul Monde Directing. Pour le polling de la progression de la construction, utilisez le point de terminaison Query World Build Status.

Scope

Interroger le statut actuel, les paramètres de création et les informations ScriptList retournables d'un seul Monde Directing. Avant d'appeler, confirmez les points suivants :

• Authentification : Seule la clé API principale est prise en charge ; les clés API temporaires ne peuvent pas être utilisées (code d'erreur 403003).

  • Obtenir la clé API principale : Obtenir et configurer une clé API.

• Prérequis : Interroger avec l'encryptedWorldId retourné par Create World. Pour le sondage de la progression de la construction, utiliser Query World Build Status.

• Appelant : Appelé par votre serveur.

Requête 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"
    }
}

États préalables et notes d'appel

• Ce point de terminaison peut interroger un Monde generating, ready ou failed.
• Il ne renvoie pas le champ async de la requête de création.
• Les champs d'image retournent uniquement l'URL et referenceType, et ne retournent jamais base64. Les inputImages pour le mode simple sont persistants en tant qu'images de référence et peuvent être retournés dans le détail ; scriptlist n'accepte pas ce champ.
• Lorsque scriptList est analysé normalement, la structure stockée complète est retournée, et acts est retourné intégralement selon le contenu stocké ; en cas d'échec de l'analyse, scriptList=null est retourné, et un acts vide n'est pas utilisé pour indiquer un échec d'analyse.
• L'interrogation d'un World provenant d'un autre modèle, d'un autre compte principal, ou d'un World supprimé retourne toujours 403001, sans révéler si la ressource existe.

Codes d'erreur

Si l'appel du modèle échoue et renvoie une erreur, consultez Codes d'erreur HappyOyster pour la résoudre.

Étapes suivantes

• Interroger la liste des mondes : paginer à travers tous les Mondes Directing.
• Delete World : supprimer un World que vous n'utilisez plus.
• Lorsque le World est ready, vous pouvez Get Travel Credential.