All Products
Search

This Product

    Intelligent Media Services:SubmitTextGenerateJob

    Document Center

    Intelligent Media Services:SubmitTextGenerateJob

    Last Updated:Jun 11, 2026

    Menghasilkan salinan pemasaran berdasarkan kata kunci, jumlah karakter, dan jumlah salinan yang dikirimkan. Karena karakteristik bahasa Tionghoa, panjang salinan keluaran mungkin sedikit berbeda dari panjang yang diminta. Setelah tugas berhasil dikirim, panggil operasi GetSmartHandleJob dengan JobId untuk mendapatkan status dan hasil tugas.

    Deskripsi operasi

    • Sebelum menggunakan operasi ini, Anda harus membeli [Enterprise Subscription Service] untuk mendapatkan izin menggunakan fitur ini.

    • Operasi ini ditagih berdasarkan jumlah token dalam konten yang dihasilkan. Jumlah token berkorelasi positif dengan panjang teks yang dihasilkan. Untuk informasi selengkapnya, lihat Smart One-Click Production. Jika tugas sintesis gagal, tidak ada biaya yang akan dikenakan.

    • Operasi ini merupakan operasi asinkron. Setelah tugas dikirim, ID tugas akan dikembalikan (pada titik ini tugas belum selesai dan akan mengantre di latar belakang untuk eksekusi asinkron). Hasil akhir dikirim melalui notifikasi callback, atau Anda dapat memanggil GetSmartHandleJob untuk secara aktif mengkueri status tugas.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ice:SubmitTextGenerateJob

    create

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Title

    string

    No

    Judul tugas.

    - Panjang tidak boleh melebihi 128 byte.

    - Dikodekan dalam UTF-8.

    测试标题
    Description

    string

    No

    Deskripsi tugas. Panjang tidak boleh melebihi 1.024 byte (dikodekan dalam UTF-8).

    测试描述
    Type

    string

    No

    Tipe tugas.

    Nilai valid:

    • MarketingCopy: salinan pemasaran.

    • Title: judul video pendek.

    • StoryboardScript: skrip storyboard yang dihasilkan dari salinan.

    Valid values:

    • MarketingCopy :

      Salinan pemasaran.

    • Title :

      Judul video pendek.

    MarketingCopy
    GenerateConfig

    string

    No

    Konfigurasi pembuatan.

    Ketika Type = Title atau MarketingCopy, bidang berikut harus ditentukan:

    • keywords: kata kunci yang digunakan untuk membuat judul atau salinan pemasaran. Wajib.

    • textLength: panjang salinan yang dihasilkan. Nilai valid: 5 hingga 1000. Panjang sebenarnya dari salinan yang dihasilkan mungkin sedikit kurang dari atau sama dengan nilai ini, tetapi tidak akan melebihinya. Wajib.

    • targetCount: jumlah salinan yang dihasilkan. Nilai valid: 1 hingga 1000. Wajib.

    Ketika Type = StoryboardScript, bidang berikut harus ditentukan:

    • originText: salinan asli yang digunakan untuk membuat skrip storyboard. Wajib.

    {"keywords":"新开店蛋糕，动物奶油","textLength":100,"targetCount":3} 或 {"originText": "街边新开了一家蛋糕店，售卖奶油蛋糕、水果蛋糕、面包、松饼等。蛋糕店对面开了一家咖啡馆，客人络绎不绝。"}
    UserData

    string

    No

    Pengaturan kustom, dalam format JSON. Panjang dibatasi hingga 512 byte. Mendukung konfigurasi alamat callback kustom.

    {"NotifyAddress":"http://xx.xx.xxx"}或{"NotifyAddress":"https://xx.xx.xxx"}或{"NotifyAddress":"ice-callback-demo"}

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan.

    ******11-DB8D-4A9A-875B-275798******
    JobId

    string

    ID tugas pintar.

    ****d80e4e4044975745c14b****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "JobId": "****d80e4e4044975745c14b****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.