Skip to main content
Referensi Open API Adventure

Referensi API HappyOyster-Adventure-End Travel

Akhiri Adventure Travel secara aktif. Setelah akhir normal, Travel memasuki completed; pada akhir karena waktu habis tanpa stream, Travel memasuki failed dan tidak ada artefak pemutaran ulang yang dihasilkan. Server juga mengakhirinya secara otomatis ketika maxExperienceTimeSec tercapai.

Cakupan

Akhiri Adventure Travel secara aktif. Setelah akhir normal, Travel memasuki completed; pada akhir karena waktu habis tanpa stream, Travel memasuki failed. Sebelum memanggil, pastikan hal berikut:
  • 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

  • Singapore
  • Tiongkok (Beijing)
  • AS (Virginia)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/endGanti {WorkspaceId} dengan ID Workspace Anda yang sebenarnya.

Parameter permintaan

  • Pengakhiran normal
  • Pengakhiran batas waktu tanpa stream
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/end' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "userAgent": "HappyOyster-Web/0.1.0"
}'
Content-Typestring(Wajib)Tipe konten permintaan. Parameter ini harus diatur ke application/json.
Authorization string (Wajib)Autentikasi Kunci API. Kunci API utama tidak wajib; kunci API utama atau sementara dapat digunakan untuk memanggilnya.
  • API Key Utama: dimulai dengan sk-, misalnya sk-xxx.
  • Kunci API Sementara: diawali dengan st-, misalnya st-xxx.
Request Body
encryptedTravelId string (Wajib)ID Travel terenkripsi Adventure yang akan diakhiri. Dikembalikan oleh Masuk Travel.
failCode string (Opsional)Alasan pengakhiran kegagalan karena batas waktu tanpa stream. Jika dihilangkan, hal ini dianggap sebagai pengakhiran normal. Saat ini hanya mendukung:
  • TRAVEL_NO_STREAM_AUTO_END: untuk skenario ketika tidak ada stream yang diterima setelah masuk ke room selama lebih dari noStreamAutoEndTimeoutSec; jenis pengakhiran ini tidak menghasilkan artefak replay
Meneruskan nilai yang tidak didukung akan mengembalikan 400000.
userAgent string (Opsional)Pengidentifikasi versi SDK atau klien. String tidak kosong; didahulukan daripada HTTP User-Agent.

Parameter respons

  • Pengakhiran normal
  • Pengakhiran batas waktu tanpa stream
{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "completed",
        "errorCode": null,
        "errorMessage": null,
        "endedAt": "2026-06-04T00:03:00Z",
        "durationSec": 90
    }
}
code integerKode pengembalian. 0 berarti berhasil; bukan nol adalah kode kesalahan.
message stringPesan kesalahan. null jika berhasil.
data objectData respons. null jika gagal.

Properti

encryptedTravelId stringID Travel terenkripsi yang telah diakhiri.status stringStatus akhir:
  • completed: berakhir normal
  • failed: pengakhiran karena kegagalan ketika failCode yang didukung disediakan
errorCode stringKode alasan kegagalan; null pada akhir normal.errorMessage stringDeskripsi kegagalan; null pada akhir normal.endedAt stringWaktu berakhir, dalam format ISO 8601.durationSec integerDurasi video efektif dalam detik; null pada pengakhiran kegagalan tanpa stream atau ketika durasi belum dapat diuraikan.

Status prasyarat dan catatan pemanggilan

  • encryptedTravelId harus milik akun utama saat ini dan model Adventure.
  • Jika failCode dihilangkan, hal ini dianggap sebagai pengakhiran normal; meneruskan nilai yang tidak didukung akan mengembalikan 400000.
  • Server secara otomatis mengakhiri Travel setelah maxExperienceTimeSec tercapai; klien harus menyelaraskan status lokalnya dari callback status atau hasil kueri status.
  • Pada pengakhiran normal, durationSec secara prioritas menggunakan durasi aktual dari video jadi yang tersedia; nilainya mungkin null jika durasi video jadi belum dapat diuraikan.
  • Setelah pengakhiran normal mencapai completed, artefak komposit mungkin masih diproses; kueri dan lakukan polling terhadapnya sesuai Kueri Artefak Travel.

Kode kesalahan

Jika pemanggilan model gagal dan mengembalikan kesalahan, lihat Kode Kesalahan HappyOyster untuk menyelesaikannya.

Langkah selanjutnya

Setelah Travel memasuki status completed:
Penggunaan API
Generasi teks
Pembuatan Gambar
  • FAQ
Video Generation
Model Dunia
Audio
  • Pembuatan audio
Real-time multimodal
Realtime API
Penyematan Teks
Lainnya Model
Toolkit/Framework
TokenPlan
Model production
Manajemen file
Penagihan
Manajemen Model
Lebih Banyak Tentang Model