Paginar pelos Mundos Acting sob a conta primária atual. O endpoint é isolado automaticamente por modelo e nunca retorna Mundos Directing ou Adventure.
Escopo
Paginar pelos Mundos Acting sob a conta primária atual. Antes de chamar, confirme o seguinte:
-
Autenticação: Apenas a API Key primária é suportada; API Keys temporárias não podem ser usadas (código de erro
403003).- Obtenha a API Key primária: Obter e configurar uma API Key.
- Caller: Chamado pelo seu servidor.
Solicitação HTTP
- Singapore
- EUA (Virgínia)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worldsSubstitua {WorkspaceId} pelo seu ID do Workspace real.Parâmetros da solicitação |
|
Authorization string (Obrigatório)Autenticação por API Key. Apenas a API Key primária é suportada; ela começa com sk-, ex. sk-xxx. É tipicamente configurada como a variável de ambiente $DASHSCOPE_API_KEY. Uma API Key temporária (começando com st-) retorna 403003. | |
Parâmetros de consulta | |
page integer (Opcional)Número da página, o padrão é 1. Quando page <= 0, é tratado como 1. | |
pageSize integer (Opcional)Itens por página, o padrão é 20. Quando pageSize <= 0, é tratado como 20; quando maior que 100, é limitado a 100. | |
status string (Opcional)Filtrar por status de construção. Valores desconhecidos não são aplicados como filtro. Valores permitidos:
| |
mode integer (Opcional)Não é necessário passar isso. A lista já está filtrada para o modelo Acting, e items[].mode é sempre 3. Se você ainda assim passar e o valor não for 3, 400000 será retornado. |
Parâmetros de resposta | Query succeeded |
code integerCódigo de retorno. 0 indica sucesso; diferente de zero é um código de erro. | |
message stringMensagem de erro. null em caso de sucesso. | |
data objectDados da resposta. null em caso de falha.
Propriedades items arrayOs Mundos na página atual; um array vazio quando não há resultado. Cada item contém encryptedWorldId, name, status (generating / ready / failed), mode (sempre 3), previewUrl (geralmente null), createdAt, perspective (geralmente null), creationModel (sempre simple) e uploadMode (fixado em first_frame).pagination objectInformações de paginação. Contém page (número da página atual), pageSize (itens reais por página), total (número total de registros) e hasMore (true quando page × pageSize < total). |
Estados pré-requisitos e notas de chamada
- A filtragem por modelo entra em vigor automaticamente; a lista nunca mistura Mundos de outros modelos, e
items[].modeé sempre3. - Os itens da lista são instantâneos leves; eles não retornam imagens, prompts,
resolution,aspectRatioourefWorldId. Quando precisar da configuração completa, chame Consultar Detalhes do Mundo. - Ao paginar, use
pagination.pageSizeehasMoreda resposta; não assuma que os valores solicitados são adotados literalmente. - Um resultado vazio não é um erro; ele retorna
items=[]e as informações de paginação correspondentes.
Códigos de erro
Se a chamada do modelo falhar e retornar um erro, consulte Códigos de Erro do HappyOyster para resolvê-lo.
Próximos passos
- Consultar Detalhes do Mundo: visualize os metadados completos de um único Mundo.
- Excluir Mundo: exclua um Mundo que você não utiliza mais.