Skip to main content
Referensi Open API Directing

Referensi API HappyOyster-Directing-Update Script

Kirimkan rangkaian lengkap 45 giliran dalam Travel mode naskah untuk sepenuhnya menggantikan acts milik Travel saat ini. Hanya creationModel=scriptlist yang didukung.

Cakupan

Kirimkan rangkaian lengkap 45 giliran dalam Travel mode naskah (creationModel=scriptlist) untuk sepenuhnya menggantikan acts milik Travel saat ini. 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: creationModel Travel harus berupa scriptlist, dan statusnya harus running atau pending. Konfirmasikan melalui Kueri Status Travel.
  • Pemanggil: Server atau klien Anda dapat memanggilnya.

Permintaan HTTP

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

Parameter permintaan

  • Perbarui naskah
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/update-script' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "scriptList": {
        "acts": [
            {
                "turn": 1,
                "content": "[character_1] wakes up and looks toward the door.",
                "cameraType": "Static",
                "shotSize": "Medium",
                "cut": "long-take"
            },
            {
                "turn": 2,
                "content": "[character_1] walks slowly across the dark room.",
                "cameraType": "Tracking",
                "shotSize": "Wide",
                "cut": "hard-cut"
            }
        ]
    },
    "userAgent": "your-client/1.2.0"
}'
Contoh hanya menampilkan act 1 dan 2 untuk mengilustrasikan struktur dan tidak boleh dikirimkan apa adanya. Permintaan aktual harus memuat seluruh 45 entri, giliran 1–45, berurutan dan tanpa duplikasi.
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 Directing yang akan diperbarui; creationModel-nya harus berupa scriptlist. Dikembalikan oleh Masuk Travel.
scriptList object (Wajib)Kontainer naskah lengkap. Hanya acts yang berlaku; meskipun menyertakan subjects, synopsis, scene, style, speed, language, setting, soundtrack, prologue, atau videoTags, bidang-bidang tersebut akan diabaikan dan platform tetap menggunakan nilai yang disimpan saat pembuatan World.scriptList.acts array (Wajib)Daftar act lengkap. Batasan:
  • Harus tepat 45 entri
  • turn harus mencakup 1–45, berurutan dan tidak boleh duplikat
  • content tidak boleh kosong, hingga 2000 karakter per beat; seluruh content berjumlah hingga 100000 karakter
  • cameraType (opsional, default Static), shotSize (opsional, Wide / Medium / Close-up, default Medium), cut (opsional, default long-take)
Endpoint ini merupakan penggantian penuh dan tidak mendukung pengiriman hanya giliran yang diubah.
userAgent string (Opsional)Pengidentifikasi versi SDK atau klien. String tidak kosong; didahulukan daripada HTTP User-Agent.

Parameter respons

  • Pembaruan diterima
{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "accepted": true,
        "turnCount": 45
    }
}
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 yang terenkripsi.accepted booleanApakah skrip lengkap telah diterima dan masuk ke alur pemrosesan.turnCount integerJumlah giliran dalam pembaruan penuh ini, ditetapkan pada 45.

Status prasyarat dan catatan pemanggilan

  • Hanya creationModel=scriptlist yang mendukung endpoint ini; Travel mode standar yang memanggilnya secara keliru akan mengembalikan 409000.
  • Status Travel harus running atau pending.
  • acts harus tepat 45 entri; turn harus 1–45, berurutan dan tidak boleh duplikat, jika tidak maka 400000 akan dikembalikan.
  • Konten skrip yang gagal dalam kebijakan keamanan konten mengembalikan 403004; penolakan kepatuhan hak cipta atau IP mengembalikan 403005.

Kode kesalahan

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

Langkah selanjutnya

Setelah pembaruan:
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