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'
encryptedWorldIdretourné 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
- Singapore
- États-Unis (Virginie)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/worlds/detailRemplacez {WorkspaceId} par votre véritable ID d'espace de travail.Paramètres de la requête |
|
Authorization string (Requis)Authentification par clé API. Seule la clé API principale est prise en charge ; elle commence par sk-, par ex. sk-xxx. Elle est généralement configurée comme variable d'environnement $DASHSCOPE_API_KEY. Une clé API temporaire (commençant par st-) renvoie 403003. | |
Paramètres de requête | |
encryptedWorldId string (Requis)Un ID de Monde chiffré Directing sous le compte principal actuel. Retourné par Créer un monde. |
Paramètres de réponse |
|
code integerCode de retour. 0 indique un succès ; une valeur non nulle correspond à un code d'erreur. | |
message stringMessage d'erreur. null en cas de succès. | |
data objectDonnées de réponse. null en cas d'échec.
Propriétés encryptedWorldId stringID chiffré du World.name stringNom du World.status stringStatut de la construction : generating / ready / failed.mode integerToujours 2 pour la mise en scène.creationModel stringsimple / scriptlist ; détermine quels points de terminaison de contrôle le Voyage peut appeler.prompt stringLe Prompt utilisé lors de la création en mode simple ; fixé à null pour scriptlist.eventStyle stringLe style d'événement à la création : normal / dramatic / regular.perspective nullGénéralement null pour le modèle Directing.uploadMode nullGénéralement null pour un Monde Directing.resolution string480p / 720p.layout stringLe style de mouvement de caméra pour le mode simple ; généralement null lorsqu'il n'est pas passé ou pour scriptlist.narrative stringLe style narratif pour le mode simple ; généralement null lorsqu'il n'est pas passé ou pour scriptlist.refWorldId stringL'ID de Monde de référence chiffré utilisé pour une création dérivée.firstFrameImage objectL'image de la première frame à la création ; base64 n'est pas retourné dans la réponse.inputImages arrayLes images de référence persistantes lors de la création en mode simple ; scriptlist n'accepte pas ce champ, il est donc généralement null.scriptList objectA une valeur uniquement pour un Monde scriptlist ; null lorsque l'analyse du script structuré échoue. Contient synopsis, videoTitle, scene, style, speed, language, setting, soundtrack, prologue, videoTags, subjects (avec label/name/type/refImage, etc.), et acts (retourné intégralement selon le contenu stocké, avec turn/content/cameraType/shotSize/cut).previewUrl nullActuellement fixé à null.aspectRatio nullFixé à null pour le modèle de mise en scène.createdAt stringHeure de création, au format ISO 8601.updatedAt stringHeure de dernière mise à jour, au format ISO 8601. |
États préalables et notes d'appel
- Ce point de terminaison peut interroger un Monde
generating,readyoufailed. - Il ne renvoie pas le champ
asyncde la requête de création. - Les champs d'image retournent uniquement l'URL et
referenceType, et ne retournent jamais base64. LesinputImagespour le modesimplesont persistants en tant qu'images de référence et peuvent être retournés dans le détail ;scriptlistn'accepte pas ce champ. - Lorsque
scriptListest analysé normalement, la structure stockée complète est retournée, etactsest retourné intégralement selon le contenu stocké ; en cas d'échec de l'analyse,scriptList=nullest retourné, et unactsvide 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.