Référence de l'API HappyOyster-Directing-Rewind Travel - Alibaba Cloud Model Studio

Rembobiner un Voyage à un horodatage vidéo spécifié et reprendre l'exécution depuis le point d'atterrissage réel. Le Voyage doit d'abord entrer dans l'état paused.

Scope

Rembobiner un Voyage à un horodatage vidéo spécifié et reprendre l'exécution depuis le point d'atterrissage réel. Avant d'appeler, confirmez les points suivants :

Authentification : La clé API principale n'est pas requise ; la clé principale ou une clé API temporaire peut l'appeler. Pour savoir comment les obtenir, voir Obtenir les identifiants d'authentification.
Prérequis : Le Voyage doit d'abord entrer dans l'état paused ; il ne peut pas être rembobiné directement pendant running. Confirm via Interroger le statut du voyage.
Appelant : Votre serveur ou votre client peut l'appeler.

Requête HTTP

Singapore

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

Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.

États-Unis (Virginie)

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

Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.

Paramètres de la requête

Rembobiner le voyage

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(Requis)

Type de contenu de la requête. Ce paramètre doit être défini sur application/json.

Authorization string (Requis)

Authentification par clé API. La clé API principale n'est pas requise ; la clé principale ou une clé API temporaire peut l'appeler.

Clé API principale : commence par sk-, par ex. sk-xxx.
Clé API temporaire : commence par st-, par exemple st-xxx.

Corps de la requête

encryptedTravelId string (Obligatoire)

L'ID de Voyage chiffré Directing à rembobiner. Retourné par Entrer dans le voyage.

rewindToSec number (Obligatoire)

Le temps vidéo cible, en secondes. Supérieur ou égal à 0 ; un multiple de 4 est recommandé (tel que 4, 8, 12). Le serveur l'arrondit à la limite de 4 secondes la plus proche en utilisant Math.round(rewindToSec / 4) × 4. Le point d'atterrissage réel est déterminé par resumedAtSec / actualRewindToSec dans la réponse.

userAgent string (Facultatif)

Identifiant de version du SDK ou du client. Une chaîne non vide ; prévaut sur le User-Agent HTTP.

Paramètres de réponse

Rembobinage réussi

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

code integer

Code de retour. 0 indique un succès ; une valeur non nulle correspond à un code d'erreur.

message string

Message d'erreur. null en cas de succès.

data object

Données de réponse. null en cas d'échec.

Propriétés

encryptedTravelId string

L'identifiant de voyage chiffré.

status string

Le statut après la fin du rembobinage ; retourne running.

resumedAtSec number

Le nombre réel de secondes auquel la lecture reprend ; il peut s'écarter légèrement de la valeur demandée.

actualRewindToSec number

Le point d'atterrissage réel du rembobinage ; identique à resumedAtSec.

États préalables et notes d'appel

Le Voyage doit d'abord entrer en paused ; il ne peut pas être rembobiné directement pendant running.
Mettre le voyage en pause a une barrière de confirmation asynchrone d'environ 3 secondes. Après avoir reçu la réponse de pause, vous devez continuer à poller Interroger le statut du voyage et confirmer que le statut visible extérieurement est déjà paused avant d'appeler ce point de terminaison.
Le script est organisé en Blocs de 4 secondes ; un multiple de 4 tel que 4, 8 ou 12 est recommandé pour rewindToSec (par exemple, 6 → 8).
Le point d'atterrissage réel est déterminé par resumedAtSec / actualRewindToSec.

Codes d'erreur

Si l'appel du modèle échoue et renvoie une erreur, consultez Codes d'erreur HappyOyster pour la résoudre.

Étapes suivantes

Après le rembobinage, le Voyage revient à running :

Interroger le statut du voyage : confirmer le statut d'exécution.
Mode standard : Envoyer une instruction de processus.
Mettre le voyage en pause : mettre à nouveau en pause pour le prochain rembobinage.
Terminer le voyage : terminer la session et traiter les artefacts.