Paginer à travers les Worlds Acting sous le compte principal actuel. Le point de terminaison est automatiquement isolé par modèle et ne retourne jamais de Worlds Directing ou Adventure.
Scope
Paginer à travers les Worlds Acting sous le compte principal actuel. Avant d'appeler, confirmer 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.
- 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-acting/openapi/v1/worldsRemplacez {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 | |
page integer (Facultatif)Numéro de page, par défaut 1. Lorsque page <= 0, il est traité comme 1. | |
pageSize integer (Facultatif)Éléments par page, par défaut 20. Lorsque pageSize <= 0, il est traité comme 20 ; lorsqu'il est supérieur à 100, il est plafonné à 100. | |
status string (Facultatif)Filtrer par statut de construction. Les valeurs inconnues ne sont pas appliquées comme filtre. Valeurs autorisées :
| |
mode integer (Facultatif)Il n'est pas nécessaire de transmettre ceci. La liste est déjà filtrée sur le modèle Acting, et items[].mode est toujours 3. Si vous le transmettez tout de même et que la valeur n'est pas 3, 400000 est retourné. |
Paramètres de réponse | Query succeeded |
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 items arrayLes Worlds sur la page actuelle ; un tableau vide lorsqu'il n'y a aucun résultat. Chaque élément contient encryptedWorldId, name, status (generating / ready / failed), mode (toujours 3), previewUrl (généralement null), createdAt, perspective (généralement null), creationModel (toujours simple) et uploadMode (fixé à first_frame).pagination objectInformations de pagination. Contient page (numéro de page actuel), pageSize (nombre réel d'éléments par page), total (nombre total d'enregistrements) et hasMore (true lorsque page × pageSize < total). |
États préalables et notes d'appel
- Le filtrage par modèle prend effet automatiquement ; la liste ne mélange jamais de Worlds provenant d'autres modèles, et
items[].modeest toujours3. - Les éléments de la liste sont des instantanés légers ; ils ne retournent pas les images, les prompts,
resolution,aspectRatioourefWorldId. Lorsque vous avez besoin de la configuration complète, appelez Query World Detail. - Lors de la pagination, utiliser
pagination.pageSizeethasMorede la réponse ; ne pas supposer que les valeurs demandées sont adoptées telles quelles. - Un résultat vide n'est pas une erreur ; il renvoie
items=[]et les informations de pagination correspondantes.
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
- Query World Detail : afficher les métadonnées complètes d'un seul World.
- Delete World : supprimer un World que vous n'utilisez plus.