HappyOyster-Acting-End Travel API Reference - Alibaba Cloud Model Studio

Actively end an Acting Travel. After a normal end it enters completed and starts processing artifacts; on a no-stream timeout end it enters failed and no replay artifacts are generated.

Scope

Actively end an Acting Travel. After a normal end the Travel enters completed and starts processing artifacts; on a no-stream timeout end it enters failed and no replay artifacts are generated. Before calling, confirm the following:

Authentication: The primary API Key is not required; either the primary or a temporary API Key can call it. For how to obtain them, see Obtain authentication credentials.
Prerequisites: The Travel must not yet have entered a terminal state and must be in a state the server can end. Confirm via Query Travel Status.
Caller: Either your server or your client can call it.

HTTP request

Singapore

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

Replace {WorkspaceId} with your actual Workspace ID.

US (Virginia)

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

Replace {WorkspaceId} with your actual Workspace ID.

Request parameters

Normal end

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"
}'

No-stream timeout end

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}",
    "failCode": "TRAVEL_NO_STREAM_AUTO_END",
    "userAgent": "HappyOyster-Web/1.2.0"
}'

Content-Typestring(Required)

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

Authorization 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.

Request Body

encryptedTravelId string (Required)

The Acting encrypted Travel ID to end. Returned by Enter Travel.

failCode string (Optional)

The failure end reason for a no-stream timeout. When omitted, it is treated as a normal end. Currently only supported:

TRAVEL_NO_STREAM_AUTO_END: for the scenario where no stream is received after entering the room for longer than noStreamAutoEndTimeoutSec; this end type does not generate replay artifacts

Passing an unsupported value returns 400000.

userAgent string (Optional)

SDK or client version identifier. A non-empty string; takes precedence over the HTTP User-Agent.

Response parameters

Normal end

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "completed",
        "endedAt": "2026-09-09T08:33:00Z",
        "durationSec": 180
    }
}

No-stream timeout end

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "failed",
        "errorCode": "TRAVEL_NO_STREAM_AUTO_END",
        "errorMessage": "Something went wrong.",
        "endedAt": "2026-09-09T08:33:00Z",
        "durationSec": null
    }
}

code integer

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

message string

Error message. null on success.

data object

Response data. null on failure.

Properties

encryptedTravelId string

The encrypted Travel ID that was ended.

status string

End status:

completed: normal end
failed: failure end when a supported failCode is provided

errorCode string

Failure reason code; returned only on a failure end.

errorMessage string

Failure description; returned only on a failure end.

endedAt string

End time, in ISO 8601 format; may be null when not yet available.

durationSec integer

Effective video duration in seconds; null on a no-stream failure end or when the duration cannot yet be parsed.

Prerequisite states and call notes

The encryptedTravelId must belong to the current primary account and the Acting model.
The Travel must not yet have entered a terminal state and must be in a state the server can end.
When failCode is omitted, it is treated as a normal end; passing an unsupported value returns 400000.
On a normal end, durationSec preferentially uses the actual duration of the available finished video; it may be null when the finished-video duration cannot yet be parsed.
Acting does not use maxExperienceTimeSec and will not auto-end after that duration when the client passes it.
After a normal end reaches completed, the composited artifacts may still be processing; query and poll them per Query Travel Artifacts.

Error codes

If the model call fails and returns an error, see HappyOyster Error Codes to resolve it.

Next steps

After the Travel enters completed:

Query Travel Artifacts: poll to obtain the recorded original and composited variants.
Query Travel List: view historical Travels.