全部產品
Search
文件中心

Intelligent Media Services:SubmitTextGenerateJob

更新時間:Oct 09, 2026

根據提交的關鍵字、字數、文案數,擴寫出行銷文案。由於中文的特殊性,輸出文案字數可能與需求字數有出入。提交任務成功後,根據 JobId 呼叫 GetSmartHandleJob 介面取得任務狀態與結果。

介面說明

  • 使用該介面前,您需要購買【企業訂閱服務】,以獲得功能使用權限。

  • 該介面按照生成內容的 token 數量進行計費,token 數與生成文本的字數呈正相關。詳情請參見智慧一鍵成片。如果合成任務失敗,將不會產生費用。

  • 該介面為非同步介面,提交任務後返回任務 ID(此時任務尚未完成,任務將進入後台排隊非同步執行),最終結果將透過回呼通知,也可透過獲取智慧任務結果主動查詢任務狀態。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:SubmitTextGenerateJob

create

*全部資源。

*

無 無

請求參數

名稱

類型

必填

描述

樣本值

Title

string

否

任務標題

- 長度不超過 128 位元組。

- UTF8 編碼。

Test Title

Description

string

否

任務描述,長度不超過 1024 位元組(UTF8 編碼)。

Test Description

Type

string

否

任務類型。列舉值:

  • MarketingCopy:行銷文案。

  • Title:短影片標題。

  • StoryboardScript:文案生成分鏡腳本。

枚舉值:

  • MarketingCopy :

    行銷文案。

  • Title :

    短影片標題。

MarketingCopy

GenerateConfig

string

否

生成設定。Type = Title 或 MarketingCopy 時,需填寫以下欄位:

  • keywords:生成標題或行銷文案的關鍵字。必填。

  • textLength:生成文案的字數,取值範圍 5~1000。實際生成的文案字數可能略少於或等於此值,但不會超過。必填。

  • targetCount:生成的文案數量,取值範圍 1~1000。必填。

Type = StoryboardScript 時,需填寫以下欄位:

  • originText:用於生成分鏡腳本的原始文案,必填。

{"keywords":"New store cake,Animal cream","textLength":100,"targetCount":3} or {"originText": "A new cake shop has opened on the street,Selling cream cakes,Fruit cake,Bread,Muffins, etc..A coffee shop has opened across from the cake shop,An endless stream of customers."}

UserData

string

否

自訂設定,Json 格式,長度限制為 512 位元組。支援自訂回呼位址設定。

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

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

Id of the request

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

JobId

string

智慧任務 ID。

****d80e4e4044975745c14b****

樣本

正常返回樣本

JSON格式

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情。