Referencia de API de HappyOyster-Acting-Query Travel List - Alibaba Cloud Model Studio

Paginar a través de los Travels de Acting bajo la cuenta principal actual, con filtrado opcional por estado o World asociado.

Ámbito

Paginar a través de los Travels de Acting bajo la cuenta principal actual, con filtrado opcional por estado o World asociado. Antes de realizar la llamada, confirme lo siguiente:

Autenticación: Solo se admite la API Key principal; no se pueden utilizar API Keys temporales (código de error 403003).
- Obtenga la API Key principal: Obtener y configurar una API Key.
Caller: Llamado por su servidor.

Solicitud HTTP

Singapore

GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels

Reemplace {WorkspaceId} con su ID de espacio de trabajo real.

EE. UU. (Virginia)

GET https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels

Reemplace {WorkspaceId} con su ID de espacio de trabajo real.

Parámetros de solicitud

Consultar lista de Travels

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels?page=1&pageSize=20&status=completed&encryptedWorldId={encryptedWorldId}' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Authorization string (Requerido)

Autenticación mediante API Key. Solo se admite la API Key principal; comienza con sk-, p. ej., sk-xxx. Normalmente se configura como la variable de entorno $DASHSCOPE_API_KEY. Una API Key temporal (que comienza con st-) devuelve 403003.

Parámetros de consulta

page integer (Opcional)

Número de página, el valor predeterminado es 1. Cuando page <= 0, se trata como 1.

pageSize integer (Opcional)

Elementos por página, el valor predeterminado es 20. Cuando pageSize <= 0, se trata como 20; cuando es mayor que 100, se limita a 100.

status string (Opcional)

Filtrar por estado del Travel. Los valores desconocidos no se aplican como filtro. Valores permitidos:

init: inicializando recursos de sesión
pending: en cola o esperando recursos del servicio
running: en ejecución
failed: el Travel falló; consulte errorCode / errorMessage para conocer el motivo
completed: el Travel ha finalizado; se pueden consultar los artefactos

encryptedWorldId string (Opcional)

Un ID de World de Acting bajo la cuenta principal actual. Cuando se proporciona, solo se devuelven los Travels de ese World. Este endpoint no admite el parámetro de consulta mode; el punto de entrada específico del modelo limita automáticamente los resultados a Acting.

Parámetros de respuesta

Consulta exitosa

{
    "code": 0,
    "message": null,
    "data": {
        "items": [
            {
                "encryptedTravelId": "trvl_a1b2****",
                "status": "completed",
                "mode": 3,
                "encryptedWorldId": "enc_a1b2****",
                "durationSec": 180,
                "createdAt": "2026-09-09T08:10:00Z",
                "endedAt": "2026-09-09T08:13:00Z"
            },
            {
                "encryptedTravelId": "trvl_g7h8****",
                "status": "running",
                "mode": 3,
                "encryptedWorldId": "enc_a1b2****",
                "durationSec": null,
                "createdAt": "2026-09-09T09:10:00Z",
                "endedAt": null
            },
            {
                "encryptedTravelId": "trvl_m3n4****",
                "status": "failed",
                "mode": 3,
                "encryptedWorldId": "enc_a1b2****",
                "durationSec": null,
                "createdAt": "2026-09-09T10:10:00Z",
                "endedAt": "2026-09-09T10:10:05Z",
                "errorCode": "TRAVEL_SESSION_INIT_FAILED",
                "errorMessage": "Failed to allocate inference resources."
            }
        ],
        "pagination": {
            "page": 1,
            "pageSize": 20,
            "total": 3,
            "hasMore": false
        }
    }
}

code integer

Código de retorno. 0 indica éxito; un valor distinto de cero es un código de error.

message string

Mensaje de error. null en caso de éxito.

data object

Datos de respuesta. null en caso de fallo.

Propiedades

items array

Los Travels en la página actual; una matriz vacía cuando no hay resultados. Cada elemento contiene encryptedTravelId, status, mode (siempre 3), encryptedWorldId, durationSec (null cuando está en ejecución, fallido o la duración aún no está disponible), createdAt y endedAt (null cuando aún está en ejecución); los elementos con status=failed incluyen adicionalmente errorCode (motivo de fallo estructurado; consulte Consultar estado del Travel para ver los valores) y errorMessage (descripción en inglés); los elementos en otros estados no incluyen estas dos claves.

pagination object

Información de paginación. Contiene page, pageSize, total y hasMore.

Estados previos y notas de llamada

El endpoint devuelve automáticamente solo Travels de tipo Acting, y items[].mode siempre es 3.
Al filtrar con encryptedWorldId, ese World debe pertenecer a la cuenta principal actual y al modelo Acting; un World de otro modelo devuelve 403001.
Para un Travel en ejecución, durationSec y endedAt suelen ser null.
Los elementos con estado failed incluyen adicionalmente errorCode / errorMessage; los elementos en otros estados no incluyen estas dos claves. Al mostrar el motivo del fallo en listas históricas, ramifique según errorCode.
Un valor desconocido de status no genera un error; se trata como si no hubiera filtro de estado. Para consultar el estado paused en tiempo real de un único Travel, utilice Consultar estado del Travel.
Un resultado vacío no constituye un error; devuelve items=[] y la información de paginación correspondiente.

Códigos de error

Si la llamada al modelo falla y devuelve un error, consulte Códigos de error de HappyOyster para resolverlo.

Siguientes pasos

Consultar estado del Travel: consultar el estado en tiempo real de un único Travel.
Consultar artefactos del Travel: consultar los artefactos de video de un Travel completado.