All Products
Search
Document Center

Intelligent Media Services:GetSmartHandleJob

Last Updated:Mar 21, 2026

Mengambil informasi dan hasil eksekusi Clipping Task berdasarkan ID Tugas tersebut. Hanya tugas yang dikirimkan dalam satu tahun terakhir yang dapat diquery.

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 pekerjaan.

****20b48fb04483915d4f2cd8ac****

Elemen respons

Element

Type

Description

Example

object

Body dari respons.

RequestId

string

ID permintaan.

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

JobId

string

ID pekerjaan.

****20b48fb04483915d4f2cd8ac****

Output

string

Output pekerjaan.

{}

JobResult

object

Hasil pekerjaan.

MediaId

string

ID aset media.

****20b48fb04483915d4f2cd8ac****

AiResult

string

Hasil analisis AI.

拆条或智能标签信息

Usage

string

Token usage. Parameter ini hanya dikembalikan untuk pekerjaan ekspansi kata kunci.

{"total_tokens":100}

MediaUrl

string

State

string

Status pekerjaan.

Valid values:

  • Finished :

    Pekerjaan berhasil.

  • Failed :

    Pekerjaan gagal.

  • Executing :

    Pekerjaan sedang berjalan.

  • Created :

    Pekerjaan telah dibuat dan menunggu penjadwalan.

Finished

UserData

string

Data pengguna kustom.

{"user":"data"}

SmartJobInfo

object

Informasi mengenai smart job.

Title

string

Judul pekerjaan.

测试标题

Description

string

Deskripsi pekerjaan.

测试描述

UserId

string

ID pengguna.

1974526429******

InputConfig

object

Konfigurasi input.

InputFile

string

URL Object Storage Service (OSS) dari file input, atau ID aset media di media library.

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

OutputConfig

object

Konfigurasi output.

Bucket

string

Bucket OSS tujuan.

test-bucket

Object

string

Jalur objek OSS tujuan.

test-object

CreateTime

string

Waktu saat pekerjaan dibuat. Waktu dalam UTC dan diformat berdasarkan standar ISO 8601.

2020-12-26T04:11:10Z

ModifiedTime

string

Waktu saat pekerjaan terakhir dimodifikasi. Waktu dalam UTC dan diformat berdasarkan standar ISO 8601.

2020-12-26T04:11:10Z

JobType

string

Jenis pekerjaan.

ASR

ErrorCode

string

Kode kesalahan yang dikembalikan jika pekerjaan gagal.

ErrorMessage

string

Pesan kesalahan yang dikembalikan jika pekerjaan gagal.

Format Job Result bergantung pada jenis Smart Job. Contoh berikut menunjukkan format respons untuk masing-masing jenis.

Subtitel 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\":\"Speaking of which,\",\"from\":0.0,\"to\":0.846},{\"content\":\"they are incredibly popular right now.\",\"from\":0.846,\"to\":3.386},{\"content\":\"Tickets are often expensive,\",\"from\":3.386,\"to\":4.402},{\"content\":\"but they sell out instantly.\",\"from\":4.402,\"to\":6.265},{\"content\":\"They have also appeared on various comedy shows to critique new performers.\",\"from\":6.265,\"to\":10.33}]"
  }
}

Text-to-speech

{
  "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": "Speaking of which, they are incredibly popular right now. Tickets are often expensive but sell out instantly. They have also appeared on various comedy shows to critique new performers."
    },
    "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\":\"Speaking of which,\",\"from\":0.0,\"to\":0.846},{\"content\":\"they are incredibly popular right now.\",\"from\":0.846,\"to\":3.386},{\"content\":\"Tickets are often expensive,\",\"from\":3.386,\"to\":4.402},{\"content\":\"but they sell out instantly.\",\"from\":4.402,\"to\":6.265},{\"content\":\"They have also appeared on various comedy shows to critique new performers.\",\"from\":6.265,\"to\":10.33}]"
  }
}

Generasi teks

{
	"RequestId":"******AC-5A01-1116-87A4-BF86F2******",
	"UserData":"{\"NotifyAddress\":\"https://****\"}",
	"JobResult":{
		"AiResult":"[\"Our new shop's cakes are made with pure dairy cream, offering a rich, silky-smooth texture. Every bite is a sweet surprise, letting your taste buds dance with freshness and purity!\",\"Explore a new world of desserts. Our new shop's cakes feature premium dairy cream, are lightly sweetened, not heavy, and have rich layers. Each cake tells a unique story of craftsmanship and sweetness, waiting for you to savor.\",\"For those who appreciate the finer things in life, our newly opened cake shop carefully selects dairy cream and rejects artificial additives. Enjoy the pure, milky aroma and a light, delicate texture. Every bite is a unique celebration of the good life.\"]",
    "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\\\":\\\"new shop's cake, dairy cream\\\",\\\"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": ""
  },
  "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": ""
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.