全部產品
Search
文件中心

Intelligent Media Services:GetSmartHandleJob - 擷取智慧工作提示結果

更新時間:Mar 21, 2026

擷取智慧工作提示結果,可以根據任務ID,擷取智慧工作提示資訊及執行結果。 本介面僅支援查詢近一年的剪輯任務資料。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:GetSmartHandleJob

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

JobId

string

任務 Id

****20b48fb04483915d4f2cd8ac****

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

請求 Id。

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

JobId

string

任務 Id。

****20b48fb04483915d4f2cd8ac****

Output

string

任務結果。

{}

JobResult

object

任務結果

MediaId

string

媒資 Id

****20b48fb04483915d4f2cd8ac****

AiResult

string

智能分析結果

拆條或智能標籤資訊

Usage

string

Token 使用量,僅在關鍵詞擴寫任務會返回

{"total_tokens":100}

MediaUrl

string

State

string

任務狀態。

枚舉值:

  • Finished :

    執行成功

  • Failed :

    執行失敗

  • Executing :

    執行中

  • Created :

    任務提交成功

Finished

UserData

string

使用者自訂資訊。

{"user":"data"}

SmartJobInfo

object

智慧工作提示資訊。

Title

string

任務標題。

測試標題

Description

string

任務描述。

測試描述

UserId

string

userid。

1974526429******

InputConfig

object

輸入參數。

InputFile

string

OSS 地址或內容庫素材 ID。

oss://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 或 ******11-DB8D-4A9A-875B-275798******

OutputConfig

object

輸出配置。

Bucket

string

OSS Bucket

test-bucket

Object

string

OSS Object

test-object

CreateTime

string

建立時間。

2020-12-26T04:11:10Z

ModifiedTime

string

修改時間。

2020-12-26T04:11:10Z

JobType

string

任務類型。

ASR

ErrorCode

string

ErrorMessage

string

每一種類型的智慧工作提示在擷取執行結果時返回內容在格式上有所不同,以下為您展示各種智慧工作提示執行結果的具體樣本。

ASR 智能字幕任務

{
  "RequestId": "******2D-443C-5043-B0E4-867070******",
  "JobId": "******042d5e4db6866f6289d1******",
  "State": "Finished",
  "SmartJobInfo": {
    "JobType": "ASR",
    "ModifiedTime": "2022-01-21T06:15:08Z",
    "CreateTime": "2022-01-21T06:15:02Z",
    "Title": "default_title_2022-01-21T06:15:02Z",
    "InputConfig": {
      "JobParameters": "{\"duration\":\"00:30:00\",\"start_time\":\"00:00:00\",\"request_params\":\"&enable_word_level_result=true\"}",
      "InputFile": "oss://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video.mp4"
    }
  },
  "JobResult": {
    "AiResult": "[{\"content\":\"提起\",\"from\":0.0,\"to\":0.846},{\"content\":\"現在可以說是紅的發紫了\",\"from\":0.846,\"to\":3.386},{\"content\":\"常常票價很高\",\"from\":3.386,\"to\":4.402},{\"content\":\"但是一開手就被瘋搶一空\",\"from\":4.402,\"to\":6.265},{\"content\":\"還參加各種相聲綜藝節目點評新人表演演員已經\",\"from\":6.265,\"to\":10.33}]"
  }
}

智能語音任務

{
  "RequestId": "******2D-443C-5043-B0E4-867070******",
  "JobId": "******042d5e4db6866f6289d1******",
  "State": "Finished",
  "SmartJobInfo": {
    "Title": "default_title_2022-01-21T06:15:07Z",
    "JobType": "TextToSpeech",
    "CreateTime": "2022-01-21T06:15:07Z",
    "ModifiedTime": "2022-01-21T06:15:07Z",
    "InputConfig": {
      "InputFile": "提起,現在可以說是紅的發紫了,常常票價很高,但是一開手就被瘋搶一空,還參加各種相聲綜藝節目點評新人表演演員已經"
    },
    "EditingConfig": "{\"format\":\"MP3\",\"pitch_rate\":0,\"sample_rate\":16000,\"speech_rate\":0,\"voice\":\"Siqi\",\"volume\":50}",
    "OutputConfig": {
      "Bucket": "your-bucket",
      "Object": "your-audio"
    }
  },
  "JobResult": {
    "MediaId": "******bf47c94e82b3b2014361******",
    "AiResult": "[{\"content\":\"提起\",\"from\":0.0,\"to\":0.846},{\"content\":\"現在可以說是紅的發紫了\",\"from\":0.846,\"to\":3.386},{\"content\":\"常常票價很高\",\"from\":3.386,\"to\":4.402},{\"content\":\"但是一開手就被瘋搶一空\",\"from\":4.402,\"to\":6.265},{\"content\":\"還參加各種相聲綜藝節目點評新人表演演員已經\",\"from\":6.265,\"to\":10.33}]"
  }
}

關鍵詞擴寫任務

{
	"RequestId":"******AC-5A01-1116-87A4-BF86F2******",
	"UserData":"{\"NotifyAddress\":\"https://****\"}",
	"JobResult":{
		"AiResult":"[\"新開店蛋糕,選用純正動物奶油,口感醇厚如絲般順滑,每一口都是甜蜜的驚喜,讓味蕾在新鮮與純粹中翩翩起舞!\",\"探索甜品新世界,我們的新開店蛋糕精選優質動物奶油,低甜不膩,層次豐富,每一款都承載著匠心獨運的甜蜜故事,靜待您來品味。\",\"獻給懂生活的你,新開業蛋糕店,嚴選動物奶油,拒絕人工添加,純正奶香四溢,輕盈綿密,每一口都是對美好生活的獨特禮讚。\"]",
    "Usage": "{\"total_tokens\":200}"
	},
	"State":"Finished",
	"JobId":"******8c784f461db57c99c9d9******",
	"SmartJobInfo":{
		"JobType":"TextGenerate",
		"ModifiedTime":"2024-01-17T08:46:17Z",
		"CreateTime":"2024-01-17T08:46:17Z",
		"Title":"default_title_2024-01-17T08:46:17Z",
		"EditingConfig":"{\"Type\":\"MarketingCopy\",\"GenerateConfig\":\"{\\\"keywords\\\":\\\"新開店蛋糕,動物奶油\\\",\\\"textLength\\\":100,\\\"targetCount\\\":3}\"}"
	}
}

樣本

正常返回樣本

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "JobId": "****20b48fb04483915d4f2cd8ac****",
  "Output": "{}",
  "JobResult": {
    "MediaId": "****20b48fb04483915d4f2cd8ac****",
    "AiResult": "拆條或智能標籤資訊",
    "Usage": "{\"total_tokens\":100}",
    "MediaUrl": ""
  },
  "State": "Finished",
  "UserData": "{\"user\":\"data\"}",
  "SmartJobInfo": {
    "Title": "測試標題",
    "Description": "測試描述",
    "UserId": "1974526429******",
    "InputConfig": {
      "InputFile": "oss://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 或 ******11-DB8D-4A9A-875B-275798******"
    },
    "OutputConfig": {
      "Bucket": "test-bucket",
      "Object": "test-object"
    },
    "CreateTime": "2020-12-26T04:11:10Z",
    "ModifiedTime": "2020-12-26T04:11:10Z",
    "JobType": "ASR"
  },
  "ErrorCode": "",
  "ErrorMessage": ""
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情