Skip to main content
QwenCloud home page
Docs
Directing

HappyOyster-Directing-Rewind Travel API Reference

Rewind a Travel to a specified video timestamp and resume running from the actual landing point. The Travel must first enter the paused state.

POST
/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/rewind
cURL - Rewind Travel
curl --location 'https://dashscope-intl.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"
}'
{
  "code": 0,
  "message": null,
  "data": {
    "encryptedTravelId": "trvl_a1b2****",
    "status": "running",
    "resumedAtSec": 84,
    "actualRewindToSec": 84
  }
}

Scope

  • The primary API Key is not required; either the primary or a temporary API Key can call it.
  • The Travel must first enter the paused state; it cannot be rewound directly while running.
  • A multiple of 4 is recommended for rewindToSec (e.g. 4, 8, 12).
If the model call fails and returns an error, see HappyOyster Error Codes to resolve it.

Authorizations

​
string
header
required

QwenCloud API Key. Only the primary API Key (sk- prefix) is supported. See Get an API Key.

Header Parameters

​
string
default"application/json"
required

Request content type. This parameter must be set to application/json.

​
string
required

API Key authentication. The primary API Key is not required; either the primary or a temporary API Key can call it.

  • Primary API Key: starts with sk-, e.g. sk-xxx.
  • Temporary API Key: starts with st-, e.g. st-xxx.

Body

application/json
​
string
required
​
number
required

The target video time, in seconds. Greater than or equal to 0; a multiple of 4 is recommended.

​
string

Response

200-application/json
​
integer
​
string
​
object