Skip to main content
QwenCloud home page
Docs
Acting (Invitational Preview)

HappyOyster-Acting-Query Travel Status API Reference

Query the Acting Travel lifecycle, server-side streaming status, sent text instructions, and chapter information; you can also report the client's pull-stream or playback heartbeat at the same time.

GET
/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/status
cURL - Query Travel status
curl --location 'https://dashscope-intl.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/status?encryptedTravelId={encryptedTravelId}&clientStreamStatus=PLAYING&clientStreamStatusTimeMs=1788940800000' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "code": 0,
  "message": null,
  "data": {
    "encryptedTravelId": "trvl_a1b2****",
    "status": "running",
    "rtcStatus": "PUSHING",
    "updateTime": "2026-09-09T08:30:00Z",
    "userInstructions": [
      {
        "instruction": "Greet with a smile and ask how my day is going",
        "relativeStartTimeMs": 12000,
        "relativeEndTimeMs": 16000,
        "startTime": 12,
        "endTime": 16,
        "status": "executed"
      }
    ],
    "chapters": [
      {
        "chapterId": 1,
        "title": "Greeting",
        "brief": "The character smiles at the camera and starts the conversation",
        "actRange": [
          0,
          10
        ],
        "startTime": 4,
        "endTime": 20,
        "chapterImage": "https://cdn.happyoyster.com/chapters/acting_ch1.jpg"
      }
    ],
    "characterActions": [],
    "environmentActions": []
  }
}

Scope

Query the Acting Travel lifecycle, server-side streaming status, sent text instructions, and chapter information; you can also report the client's pull-stream or playback heartbeat at the same time. 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: Query with the encryptedTravelId returned by Enter Travel (Client).
  • Caller: Either your server or your client can call it. Polling every 2-5 seconds is recommended.
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
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.

Query Parameters

​
string
required

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

​
enum<string>

The client's RTC pull-stream or playback status, case-insensitive. Unrecognized values are ignored.

Available options:DISCONNECTED,CONNECTING,CONNECTED,PLAYING,BUFFERING,PAUSED,RECONNECTING
​
integer

The millisecond timestamp of the client state change. Used together with clientStreamStatus.

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.

HappyOyster-Acting-Query Travel Status API Reference - QwenCloud