All Products
Search
Document Center

Intelligent Media Services:GetSmartHandleJob

Last Updated:Jun 11, 2026

Memperoleh hasil tugas cerdas. Anda dapat mengambil informasi dan hasil eksekusi tugas cerdas berdasarkan ID tugas. API ini hanya mendukung kueri data tugas pengeditan cerdas dari satu tahun terakhir.

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:GetSmartHandleJob

get

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

JobId

string

No

ID tugas.

****20b48fb04483915d4f2cd8ac****

Elemen respons

Element

Type

Description

Example

object

Skema Respons

RequestId

string

ID permintaan.

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

JobId

string

ID tugas.

****20b48fb04483915d4f2cd8ac****

Output

string

Hasil tugas.

{}

JobResult

object

Hasil tugas.

MediaId

string

ID media.

****20b48fb04483915d4f2cd8ac****

AiResult

string

Hasil analisis cerdas.

拆条或智能标签信息

Usage

string

Penggunaan token. Hanya dikembalikan untuk tugas perluasan kata kunci.

{"total_tokens":100}

MediaUrl

string

URL keluaran file media yang dihasilkan oleh tugas cerdas.

http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4

State

string

Status tugas.

Valid values:

  • Finished :

    Eksekusi berhasil

  • Failed :

    Eksekusi gagal

  • Executing :

    Sedang dieksekusi

  • Created :

    Tugas berhasil dikirim

Finished

UserData

string

Data yang ditentukan pengguna.

{"user":"data"}

SmartJobInfo

object

Informasi tugas cerdas.

Title

string

Judul tugas.

测试标题

Description

string

Deskripsi tugas.

测试描述

UserId

string

ID pengguna.

1974526429******

InputConfig

object

Parameter masukan.

InputFile

string

The Object Storage Service (OSS) URL of the input file, or the ID of the media asset in the media library.

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

OutputConfig

object

Konfigurasi keluaran.

Bucket

string

The destination OSS bucket.

test-bucket

Object

string

The path of the destination OSS object.

test-object

CreateTime

string

Waktu pembuatan.

2020-12-26T04:11:10Z

ModifiedTime

string

Waktu modifikasi.

2020-12-26T04:11:10Z

JobType

string

Jenis tugas.

ASR

ErrorCode

string

Kode kesalahan yang dikembalikan ketika tugas gagal. Parameter ini tidak dikembalikan jika tugas berhasil.

SpeechTranslationNoValidVocal

ErrorMessage

string

Pesan kesalahan yang dikembalikan ketika tugas gagal. Parameter ini tidak dikembalikan jika tugas berhasil.

The speech translation job failed due to lack of valid vocal voice data.

Format konten yang dikembalikan berbeda menurut jenis tugas cerdas. Contoh berikut menggambarkan hasil eksekusi untuk setiap jenis tugas cerdas.

Tugas Subtitle Cerdas 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}]"
  }
}

Tugas Suara Cerdas

{
  "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}]"
  }
}

Tugas Perluasan Kata Kunci

{
	"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}\"}"
	}
}

Contoh

Respons sukses

JSONformat

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "JobId": "****20b48fb04483915d4f2cd8ac****",
  "Output": "{}",
  "JobResult": {
    "MediaId": "****20b48fb04483915d4f2cd8ac****",
    "AiResult": "拆条或智能标签信息",
    "Usage": "{\"total_tokens\":100}",
    "MediaUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4"
  },
  "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": "SpeechTranslationNoValidVocal",
  "ErrorMessage": "The speech translation job failed due to lack of valid vocal voice data."
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.