Referencia de la API HappyOyster-Acting-End Travel - Alibaba Cloud Model Studio

Finaliza activamente un viaje de Acting. Después de una finalización normal, entra en completed y comienza a procesar artefactos; en una finalización por tiempo de espera sin flujo, entra en failed y no se generan artefactos de reproducción.

Ámbito

Finalizar activamente un viaje de Acting. Después de una finalización normal, el viaje entra en completed y comienza a procesar artefactos; en una finalización por tiempo de espera sin flujo, entra en failed y no se generan artefactos de reproducción. Antes de llamar, confirme lo siguiente:

Autenticación: La clave de API principal no es obligatoria; pueden invocarla tanto la clave principal como una temporal. Para saber cómo obtenerlas, consulte Obtener credenciales de autenticación.
Requisitos previos: El viaje no debe haber entrado todavía en un estado terminal y debe estar en un estado que el servidor pueda finalizar. Confírmelo mediante Consultar estado del viaje.
Solicitante: Puede invocarla su servidor o su cliente.

Solicitud HTTP

Singapore

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

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

EE. UU. (Virginia)

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

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

Parámetros de solicitud

Finalización normal

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/end' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "userAgent": "HappyOyster-Web/1.2.0"
}'

Finalización por tiempo de espera sin flujo

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/end' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "failCode": "TRAVEL_NO_STREAM_AUTO_END",
    "userAgent": "HappyOyster-Web/1.2.0"
}'

Content-Typestring(Requerido)

Tipo de contenido de la solicitud. Este parámetro debe establecerse en application/json.

Authorization string (Requerido)

Autenticación mediante clave de API. No se requiere la clave de API principal; pueden invocarla tanto la clave principal como una temporal.

Clave de API principal: comienza con sk-, por ejemplo, sk-xxx.
Clave de API temporal: comienza con st-, por ejemplo, st-xxx.

Cuerpo de la solicitud

encryptedTravelId string (Obligatorio)

El ID de viaje cifrado de Acting que se va a finalizar. Devuelto por Enter Travel.

failCode string (Opcional)

El motivo de finalización por fallo para un tiempo de espera sin flujo. Cuando se omite, se trata como una finalización normal. Actualmente solo se admite:

TRAVEL_NO_STREAM_AUTO_END: para el escenario en el que no se recibe ningún flujo después de entrar en la sala durante más de noStreamAutoEndTimeoutSec; este tipo de finalización no genera artefactos de reproducción

Pasar un valor no compatible devuelve 400000.

userAgent string (Opcional)

Identificador de versión del SDK o del cliente. Una cadena no vacía; tiene prioridad sobre el User-Agent HTTP.

Parámetros de respuesta

Finalización normal

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "completed",
        "endedAt": "2026-09-09T08:33:00Z",
        "durationSec": 180
    }
}

Finalización por tiempo de espera sin flujo

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "failed",
        "errorCode": "TRAVEL_NO_STREAM_AUTO_END",
        "errorMessage": "Something went wrong.",
        "endedAt": "2026-09-09T08:33:00Z",
        "durationSec": null
    }
}

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

encryptedTravelId string

El ID de viaje cifrado que se finalizó.

status string

Estado de finalización:

completed: finalización normal
failed: finalización por fallo cuando se proporciona un failCode compatible

errorCode string

Código de motivo de fallo; se devuelve solo en una finalización por fallo.

errorMessage string

Descripción del fallo; se devuelve solo en una finalización por fallo.

endedAt string

Hora de finalización, en formato ISO 8601; puede ser null cuando aún no está disponible.

durationSec integer

Duración efectiva del video en segundos; null en una finalización por fallo sin flujo o cuando la duración aún no se puede analizar.

Estados previos y notas de llamada

El encryptedTravelId debe pertenecer a la cuenta principal actual y al modelo de Acting.
El viaje no debe haber entrado todavía en un estado terminal y debe estar en un estado que el servidor pueda finalizar.
Cuando se omite failCode, se trata como una finalización normal; pasar un valor no compatible devuelve 400000.
En una finalización normal, durationSec utiliza preferentemente la duración real del video finalizado disponible; puede ser null cuando la duración del video finalizado aún no se puede analizar.
Acting no utiliza maxExperienceTimeSec y no finalizará automáticamente después de esa duración cuando el cliente lo pase.
Después de que una finalización normal alcance completed, los artefactos compuestos pueden seguir procesándose; consúltelos y sondee según Consultar artefactos del viaje.

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

Después de que el viaje entre en completed:

Consultar artefactos del viaje: sondear para obtener las variantes originales grabadas y compuestas.
Consultar lista de viajes: ver viajes históricos.