Skip to main content

Referencia de la API HappyOyster-Acting-End Travel

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
  • EE. UU. (Virginia)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/endReemplace {WorkspaceId} con su ID de espacio de trabajo real.

Parámetros de solicitud

  • Finalización normal
  • 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}",
    "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
  • Finalización por tiempo de espera sin flujo
{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "completed",
        "endedAt": "2026-09-09T08:33:00Z",
        "durationSec": 180
    }
}
code integerCódigo de retorno. 0 indica éxito; un valor distinto de cero es un código de error.
message stringMensaje de error. null en caso de éxito.
data objectDatos de respuesta. null en caso de fallo.

Propiedades

encryptedTravelId stringEl ID de viaje cifrado que se finalizó.status stringEstado de finalización:
  • completed: finalización normal
  • failed: finalización por fallo cuando se proporciona un failCode compatible
errorCode stringCódigo de motivo de fallo; se devuelve solo en una finalización por fallo.errorMessage stringDescripción del fallo; se devuelve solo en una finalización por fallo.endedAt stringHora de finalización, en formato ISO 8601; puede ser null cuando aún no está disponible.durationSec integerDuració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: