Referensi API HappyOyster-Acting-Create World

​

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.
• Mode pemanggilan: Mode asinkron direkomendasikan.
  • Mode asinkron (default): async=true, API segera mengembalikan encryptedWorldId; lakukan polling Query World Build Status untuk melihat progres.
  • Mode sinkron: async=false, server melakukan polling secara internal (setiap 3 detik, hingga 120 detik) dan mengembalikan hasil saat pembangunan selesai; jika waktu habis, sistem kembali ke mode asinkron dan klien terus melakukan polling.
• Batasan endpoint: Endpoint ini hanya dapat membuat Acting World. Anda tidak perlu meneruskan mode (server menuliskan 3; meneruskan nilai selain 3 akan mengembalikan 400000). creationModel selalu bernilai simple, uploadMode ditetapkan ke first_frame, dan versi masuk ruangan ditetapkan ke actingV2.

​

Permintaan HTTP

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "async": true,
    "prompt": "A blonde girl with twin tails, a white bow, and a golden crescent crown on her forehead; a white shirt with a navy sailor collar and a blue bow tie, and a blue-and-white argyle short skirt. Her right hand holds up a yellow sticky note that reads \"Good night\". Behind her are a deep-red velvet curtain and a cluster of flowers. Facing the camera, an anime-realistic blend, warm indoor lighting.",
    "resolution": "480p",
    "aspectRatio": "9:16",
    "firstFrameImage": {
        "url": "https://g-adoc.alcasset.com/media/maas_docs/sfm-cn/common/images/6a4b3c2d1e0f9fc5.png",
        "referenceType": "default"
    }
}'

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "async": true,
    "prompt": "A relaxed conversation on the living-room sofa, with the character naturally looking toward the camera",
    "resolution": "480p",
    "aspectRatio": "9:16",
    "firstFrameImage": {
        "base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...",
        "referenceType": "default"
    }
}'

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedWorldId": "enc_a1b2****",
        "status": "generating",
        "firstFrame": null
    }
}

{
    "code": 400000,
    "message": "Invalid request parameters.",
    "data": null
}

​

Kode kesalahan

​

Langkah selanjutnya

• Query World Build Status: lakukan polling setiap 3–5 detik hingga World memasuki status ready.
• Setelah World memasuki status ready, panggil Get Travel Credential untuk ditukarkan dengan ticket sekali pakai.
• Query World Detail: kueri metadata pembuatan lengkap.