Kueri status saat ini, parameter pembuatan, dan informasi ScriptList yang dapat dikembalikan dari satu Directing World. Untuk polling progres pembangunan, gunakan endpoint Query World Build Status.
Cakupan
Kueri status saat ini, parameter pembuatan, dan informasi ScriptList yang dapat dikembalikan dari satu Directing World. Sebelum memanggil, pastikan hal berikut:
-
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
encryptedWorldIdyang dikembalikan oleh Create World. Untuk polling progres pembangunan, gunakan Query World Build Status. - Pemanggil: Dipanggil oleh server Anda.
Permintaan HTTP
- Singapore
- AS (Virginia)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/worlds/detailGanti {WorkspaceId} dengan ID Workspace Anda yang sebenarnya.Parameter permintaan |
|
Authorization string (Wajib)Autentikasi API Key. Hanya API Key utama yang didukung; dimulai dengan sk-, misalnya sk-xxx. Biasanya dikonfigurasi sebagai variabel lingkungan $DASHSCOPE_API_KEY. API Key sementara (dimulai dengan st-) akan mengembalikan 403003. | |
Parameter kueri | |
encryptedWorldId string (Wajib)ID World terenkripsi Directing di bawah akun utama saat ini. Dikembalikan oleh Create World. |
Parameter respons |
|
code integerKode pengembalian. 0 berarti berhasil; bukan nol adalah kode kesalahan. | |
message stringPesan kesalahan. null jika berhasil. | |
data objectData respons. null jika gagal.
Properti encryptedWorldId stringID World terenkripsi.name stringNama World.status stringStatus pembangunan: generating / ready / failed.mode integerSelalu 2 untuk Directing.creationModel stringsimple / scriptlist; menentukan endpoint kontrol mana yang dapat dipanggil oleh Travel.prompt stringPrompt yang digunakan saat membuat dalam mode simple; ditetapkan ke null untuk scriptlist.eventStyle stringGaya peristiwa saat pembuatan: normal / dramatic / regular.perspective nullBiasanya null untuk model Directing.uploadMode nullBiasanya null untuk Directing World.resolution string480p / 720p.layout stringGaya pergerakan kamera untuk mode simple; biasanya null jika tidak diteruskan atau untuk scriptlist.narrative stringGaya narasi untuk mode simple; biasanya null jika tidak diteruskan atau untuk scriptlist.refWorldId stringID World referensi terenkripsi yang digunakan untuk pembuatan turunan.firstFrameImage objectGambar frame pertama saat pembuatan; base64 tidak dikembalikan dalam respons.inputImages arrayGambar referensi yang disimpan saat membuat dalam mode simple; scriptlist tidak menerima bidang ini, sehingga biasanya bernilai null.scriptList objectMemiliki nilai hanya untuk World scriptlist; null ketika penguraian skrip terstruktur gagal. Berisi synopsis, videoTitle, scene, style, speed, language, setting, soundtrack, prologue, videoTags, subjects (dengan label/name/type/refImage, dll.), dan acts (dikembalikan secara lengkap sesuai dengan konten yang tersimpan, dengan turn/content/cameraType/shotSize/cut).previewUrl nullSaat ini ditetapkan ke null.aspectRatio nullDitetapkan ke null untuk model Directing.createdAt stringWaktu pembuatan, dalam format ISO 8601.updatedAt stringWaktu pembaruan terakhir, dalam format ISO 8601. |
Status prasyarat dan catatan pemanggilan
- Endpoint ini dapat melakukan kueri pada World
generating,ready, ataufailed. - Ini tidak menggemakan bidang
asyncdari permintaan pembuatan. - Bidang gambar hanya mengembalikan URL dan
referenceType, dan tidak pernah mengembalikan base64.inputImagesuntuk modesimpledisimpan sebagai gambar referensi dan dapat dikembalikan dalam detail;scriptlisttidak menerima bidang ini. - Ketika
scriptListberhasil diuraikan, struktur tersimpan lengkap dikembalikan, danactsdikembalikan secara lengkap sesuai dengan konten yang tersimpan; ketika penguraian gagal,scriptList=nulldikembalikan, danactskosong tidak digunakan untuk menunjukkan kegagalan penguraian. - 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
Jika pemanggilan model gagal dan mengembalikan kesalahan, lihat Kode Kesalahan HappyOyster untuk menyelesaikannya.
Langkah selanjutnya
- Query World List: melakukan paginasi melalui semua Directing World.
- Delete World: hapus World yang tidak lagi Anda gunakan.
- Ketika World berstatus
ready, Anda dapat Get Travel Credential.