Créer un Monde d'exploration. Créer un Monde à partir d'une invite en langage naturel et d'une première image obligatoire ; l'API retourne immédiatement un ID chiffré de Monde, le Monde se construit de manière asynchrone en arrière-plan, et le client interroge la progression de la construction jusqu'à son achèvement.
Scope
Créer un Monde Adventure. 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.
-
Mode d'appel : Le mode asynchrone est recommandé.
- Mode asynchrone (par défaut) :
async=true, l'API retourne immédiatementencryptedWorldId; interrogez Interroger l'état de construction du Monde pour suivre la progression. - Mode synchrone :
async=false, le serveur interroge en interne (toutes les 3s, jusqu'à 120s) et retourne un résultat lorsque la construction est terminée ; en cas de délai d'attente dépassé, il revient au mode asynchrone et le client continue d'interroger.
- Mode asynchrone (par défaut) :
-
Restrictions du point de terminaison : Ce point de terminaison peut uniquement créer un Monde Adventure. Vous n'avez pas besoin de passer
mode(le serveur écrit1; passer une valeur autre que1retourne400000).creationModelest toujourssimple,uploadModeest fixé àfirst_frame, et la version d'entrée en salle est fixée àwanderV2.
Requête HTTP
- Singapore
- Chine (Pékin)
- États-Unis (Virginie)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worldsRemplacez {WorkspaceId} par votre véritable ID d'espace de travail.Paramètres de la requête |
|
Content-Typestring(Requis)Type de contenu de la requête. Ce paramètre doit être défini sur application/json. | |
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. | |
Corps de la requête | |
async boolean (Facultatif)Indique s'il faut créer de manière asynchrone. La valeur par défaut est true :
| |
perspective string (Obligatoire)Perspective. Valeurs autorisées :
400000. | |
prompt string (Requis)Description du thème du Monde ; le chinois et l'anglais sont pris en charge. Non vide, jusqu'à 2000 caractères. Si manquant, vide ou trop long, retourne 400000. | |
creationModel string (Facultatif)Sous-mode de création. La valeur par défaut est simple ; Adventure prend uniquement en charge simple. | |
uploadMode string (Facultatif)Mode de téléchargement d'image. La valeur par défaut est first_frame ; Adventure prend uniquement en charge first_frame. | |
refWorldId string (Facultatif)Dériver une nouvelle création à partir d'un Monde Adventure existant. Doit être un ID chiffré de Monde Adventure sous le compte principal actuel ; un Monde provenant d'un autre modèle ou d'un autre compte principal retourne 403001. | |
firstFrameImage object (Requis)Une référence d'image réutilisée directement comme première image du Monde. url et base64 sont mutuellement exclusifs (choisissez-en un). Contraintes de l'image :
Propriétés url string (Conditionnellement requis)URL de l'image de la première frame. Mutuellement exclusif avec base64 (choisir l'un ou l'autre). Contraintes :
string (Conditionnellement requis)Base64 de l'image de la première frame. Mutuellement exclusif avec url (choisir l'un ou l'autre). Contraintes :
string (Facultatif)Type d'image de référence. La valeur par défaut est default, et elle est actuellement utilisée comme default. |
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 stringL'ID de Monde chiffré généré par le serveur. Retourné dans les modes synchrone et asynchrone ; utilisé pour l'interrogation ultérieure de l'état de construction, les requêtes de détails et l'échange d'informations d'identification de voyage.status stringStatut de création actuel : generating (en cours de construction) ou ready ; peut également être failed lorsqu'une construction synchrone échoue.firstFrame stringURL de la première image du Monde ; null avant sa génération. |
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
Après une création réussie, vous pouvez :
- Interroger l'état de construction du Monde : interroger toutes les 3–5 secondes jusqu'à ce que le Monde passe à l'état
ready. - Une fois que le Monde est passé à l'état
ready, appelez Obtenir les informations d'identification de voyage pour les échanger contre unticketà usage unique. - Interroger les détails du Monde : interroger toutes les métadonnées de création.