Skip to main content
Acting (Invitational Preview)

HappyOyster-Acting-Pause Travel API Reference

Request to pause a running Acting Travel. After the pause, video generation stops and you can continue via the Resume Travel endpoint.

POST
/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/pause
cURL - Pause Travel
curl --location 'https://dashscope-intl.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/pause' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "encryptedTravelId": "{encryptedTravelId}",
  "userAgent": "HappyOyster-Web/1.2.0"
}'
{
  "code": 0,
  "message": null,
  "data": {
    "encryptedTravelId": "trvl_a1b2****",
    "status": "paused"
  }
}

Scope

Request to pause a running Acting Travel. Before calling, confirm the following:
  • Authentication: The primary API Key is not required; either the primary or a temporary API Key can call it.
  • Prerequisites: The Travel status must be running. Confirm via Query Travel Status.
  • Caller: Either your server or your client can call it.
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

The Acting encrypted Travel ID to control. Returned by Enter Travel (Client).

string

SDK or client version identifier. A non-empty string; takes precedence over the HTTP User-Agent, used for SDK version and platform statistics.

Response

200-application/json
integer

Return code. 0 means success; non-zero is an error code.

string

Error message. null on success.

object

Response data. null on failure.