Referensi API HappyOyster-Acting-End 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: Travel belum boleh memasuki status terminal dan harus berada dalam status yang dapat diakhiri oleh server. Konfirmasikan melalui Kueri Status Travel.
• 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-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"
}'

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

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

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

​

Status prasyarat dan catatan pemanggilan

• encryptedTravelId harus dimiliki oleh akun utama saat ini dan model Acting.
• Travel belum boleh memasuki status terminal dan harus berada dalam status yang dapat diakhiri oleh server.
• Jika failCode dihilangkan, hal ini dianggap sebagai pengakhiran normal; meneruskan nilai yang tidak didukung akan mengembalikan 400000.
• Pada pengakhiran normal, durationSec secara prioritas menggunakan durasi aktual dari video jadi yang tersedia; nilainya mungkin null jika durasi video jadi belum dapat diuraikan.
• Acting tidak menggunakan maxExperienceTimeSec dan tidak akan mengakhiri secara otomatis setelah durasi tersebut ketika klien meneruskannya.
• Setelah pengakhiran normal mencapai completed, artefak komposit mungkin masih diproses; kueri dan lakukan polling terhadapnya sesuai Kueri Artefak Travel.

​

Kode kesalahan

​

Langkah selanjutnya

• Kueri Artefak Travel: melakukan polling untuk mendapatkan varian asli dan komposit yang telah direkam.
• Kueri Daftar Travel: melihat riwayat Travel.