Referensi API HappyOyster-Directing-Pause Travel

​

Cakupan

• Autentikasi: Kunci API utama tidak wajib; kunci API utama atau sementara dapat digunakan untuk memanggilnya. Untuk cara mendapatkannya, lihat Mendapatkan kredensial autentikasi.
• Prasyarat: Status Travel harus running. Konfirmasikan melalui Query Travel Status.
• Pemanggil: Server atau klien Anda dapat memanggilnya.

​

Permintaan HTTP

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/pause' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "userAgent": "your-client/1.2.0"
}'

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "paused"
    }
}

​

Status prasyarat dan catatan pemanggilan

• Status Travel saat ini harus running.
• version dalam respons enter-room harus storyV2; memasuki room untuk model ini selalu mengembalikan nilai ini.
• Konfirmasi status jeda di sisi server adalah proses asinkron. Ketika Anda perlu segera memanggil rewind atau resume, lakukan polling Query Travel Status hingga statusnya paused.

​

Kode kesalahan

​

Langkah selanjutnya

• Resume Travel: lanjutkan Travel yang dijeda dan teruskan eksekusi.
• Rewind Travel: kembali ke timestamp video tertentu.
• End Travel: akhiri Travel secara langsung.