Referensi API HappyOyster-Acting-Query World Detail

​

Cakupan

• Autentikasi: Hanya API Key utama yang didukung; API Key sementara tidak dapat digunakan (kode kesalahan 403003).
  • Dapatkan API Key utama: Mendapatkan dan mengonfigurasi API Key.
• Prasyarat: Lakukan kueri dengan encryptedWorldId yang dikembalikan oleh Create World. Untuk polling progres pembangunan, gunakan Query World Build Status.
• Pemanggil: Dipanggil oleh server Anda.

​

Permintaan HTTP

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/detail?encryptedWorldId={encryptedWorldId}' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedWorldId": "enc_a1b2****",
        "name": "Late-Night Video Call",
        "status": "ready",
        "mode": 3,
        "creationModel": "simple",
        "prompt": "During a late-night video call, a quiet girl smiles back at the camera",
        "eventStyle": "first_frame",
        "perspective": null,
        "uploadMode": "first_frame",
        "resolution": "480p",
        "aspectRatio": "9:16",
        "layout": null,
        "narrative": null,
        "refWorldId": null,
        "firstFrameImage": {
            "url": "https://cdn.happyoyster.com/frames/portrait-call.jpg",
            "referenceType": "default"
        },
        "inputImages": null,
        "sceneImage": null,
        "roleImage": null,
        "scenePrompt": null,
        "rolePrompt": null,
        "scriptList": null,
        "previewUrl": null,
        "createdAt": "2026-09-09T08:00:00Z",
        "updatedAt": "2026-09-09T08:05:00Z"
    }
}

​

Status prasyarat dan catatan pemanggilan

• Endpoint ini dapat mengkueri World generating, ready, atau failed; beberapa artefak pembangunan mungkin bernilai null sebelum siap.
• Endpoint detail tidak menggemakan async, karena ini adalah pengalih perilaku panggilan, bukan atribut World.
• Gambar hanya dikembalikan sebagai URL dan referenceType; konten base64 dalam permintaan pembuatan tidak dikembalikan.
• eventStyle biasanya memiliki nilai yang sama dengan uploadMode; klien harus menganggap uploadMode sebagai field otoritatif untuk mode pembuatan Acting.
• Pemutar dapat membaca sebelumnya aspectRatio, namun saat benar-benar memasuki ruangan, orientasi tetap harus diatur dari nilai respons Enter Travel.
• Melakukan kueri terhadap World dari model lain, akun utama lain, atau World yang telah dihapus akan selalu mengembalikan 403001, tanpa mengungkapkan apakah sumber daya tersebut ada atau tidak.

​

Kode kesalahan

​

Langkah selanjutnya

• Query World List: telusuri semua Acting World secara bertahap.
• Delete World: hapus World yang tidak lagi Anda gunakan.
• Ketika World berstatus ready, Anda dapat Get Travel Credential.