Referencia de la API HappyOyster-Directing-Rewind Travel - Alibaba Cloud Model Studio

Rebobinar un Travel a una marca de tiempo de video especificada y reanudar la ejecución desde el punto de aterrizaje real. El Travel debe entrar primero en el estado de pausa.

Ámbito

Rebobinar un Travel a una marca de tiempo de video especificada y reanudar la ejecución desde el punto de aterrizaje real. 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.
Prerequisites: El Travel debe entrar primero en el estado paused; no se puede rebobinar directamente mientras está en running. Confirm mediante Query Travel Status.
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-directing/openapi/v1/travels/rewind

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-directing/openapi/v1/travels/rewind

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

Parámetros de solicitud

Rewind Travel

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/rewind' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "rewindToSec": 84.0,
    "userAgent": "your-client/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 Travel cifrado de Directing a rebobinar. Devuelto por Enter Travel.

rewindToSec number (Required)

El tiempo de video objetivo, en segundos. Mayor o igual a 0; se recomienda un múltiplo de 4 (como 4, 8, 12). El servidor lo redondea al límite de 4 segundos más cercano usando Math.round(rewindToSec / 4) × 4. El punto de aterrizaje real está determinado por resumedAtSec / actualRewindToSec en la respuesta.

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

Rebobinado exitoso

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "running",
        "resumedAtSec": 84.0,
        "actualRewindToSec": 84.0
    }
}

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.

status string

El estado después de que se completa el rebobinado; devuelve running.

resumedAtSec number

El número real de segundos en el que se reanuda la reproducción; puede desviarse ligeramente del valor solicitado.

actualRewindToSec number

El punto de aterrizaje real del rebobinado; idéntico a resumedAtSec.

Estados previos y notas de llamada

El Travel debe entrar primero en paused; no se puede rebobinar directamente mientras está en running.
Pause Travel tiene una barrera de confirmación asíncrona de aproximadamente 3 segundos. Después de recibir la respuesta de pausa, aún debe sondear Query Travel Status y confirmar que el estado visible externamente ya es paused antes de llamar a este endpoint.
El script está organizado en Bloques de 4 segundos; se recomienda un múltiplo de 4 como 4, 8 o 12 para rewindToSec (por ejemplo, 6 → 8).
El punto de aterrizaje real está determinado por resumedAtSec / actualRewindToSec.

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 del rebobinado, el Travel vuelve a running:

Query Travel Status: confirmar el estado de ejecución.
Modo estándar: Enviar instrucción de proceso.
Pause Travel: pausar nuevamente para el siguiente rebobinado.
End Travel: finalizar la sesión y procesar los artefactos.