Tous les produits
Search
Centre de documentation

:GetSmartHandleJob

Dernière mise à jour :Aug 07, 2026

Obtient les informations et le résultat d'exécution d'une tâche intelligente à partir de son identifiant. Cette API prend uniquement en charge l'interrogation des tâches d'édition de l'année écoulée.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ice:GetSmartHandleJob

get

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

JobId

string

Non

L'identifiant de la tâche.

****20b48fb04483915d4f2cd8ac****

Éléments de réponse

Élément

Type

Description

Exemple

object

Le schéma de la réponse.

RequestId

string

L'identifiant de la requête.

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

JobId

string

L'identifiant de la tâche.

****20b48fb04483915d4f2cd8ac****

Output

string

La sortie de la tâche.

{}

JobResult

object

Le résultat de la tâche.

MediaId

string

L'identifiant du média.

****20b48fb04483915d4f2cd8ac****

AiResult

string

Le résultat de l'IA.

Informations de découpage ou de balisage intelligent

Usage

string

L'utilisation des jetons. Ce paramètre n'est renvoyé que pour les tâches d'expansion de mots-clés.

{"total_tokens":100}

MediaUrl

string

L'URL du fichier média de sortie généré par la tâche intelligente.

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

State

string

L'état de la tâche.

Valeurs valides :

  • Finished :

    La tâche est terminée.

  • Failed :

    La tâche a échoué.

  • Executing :

    La tâche est en cours d'exécution.

  • Created :

    La tâche est créée.

Finished

UserData

string

Les données utilisateur.

{"user":"data"}

SmartJobInfo

object

Les informations de la tâche intelligente.

Title

string

Le titre de la tâche.

Titre de test

Description

string

La description de la tâche.

Description de test

UserId

string

L'identifiant de l'utilisateur.

1974526429******

InputConfig

object

La configuration d'entrée.

InputFile

string

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

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

OutputConfig

object

La configuration de sortie.

Bucket

string

The OSS bucket.

test-bucket

Object

string

The OSS object.

test-object

CreateTime

string

L'heure de création.

2020-12-26T04:11:10Z

ModifiedTime

string

L'heure de modification.

2020-12-26T04:11:10Z

JobType

string

Le type de tâche.

ASR

ErrorCode

string

Le code d'erreur. Ce paramètre n'est renvoyé que si la tâche échoue.

SpeechTranslationNoValidVocal

ErrorMessage

string

Le message d'erreur. Ce paramètre n'est renvoyé que si la tâche échoue.

La tâche de traduction de la parole a échoué en raison d'un manque de données vocales valides

Le format du résultat varie en fonction du type de tâche intelligente. Les exemples suivants présentent les corps de réponse pour différentes tâches intelligentes.

Sous-titrage intelligent 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, he\",\"from\":0.0,\"to\":0.846},{\"content\":\"is now incredibly popular.\",\"from\":0.846,\"to\":3.386},{\"content\":\"Tickets are often very expensive,\",\"from\":3.386,\"to\":4.402},{\"content\":\"but they sell out instantly upon release.\",\"from\":4.402,\"to\":6.265},{\"content\":\"He also participates in various crosstalk variety shows to comment on new performers and has already...\",\"from\":6.265,\"to\":10.33}]"
  }
}

Synthèse vocale

{
  "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, he is now incredibly popular. Tickets are often very expensive, but they sell out instantly upon release. He also participates in various crosstalk variety shows to comment on new performers and has already..."
    },
    "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, he\",\"from\":0.0,\"to\":0.846},{\"content\":\"is now incredibly popular.\",\"from\":0.846,\"to\":3.386},{\"content\":\"Tickets are often very expensive,\",\"from\":3.386,\"to\":4.402},{\"content\":\"but they sell out instantly upon release.\",\"from\":4.402,\"to\":6.265},{\"content\":\"He also participates in various crosstalk variety shows to comment on new performers and has already...\",\"from\":6.265,\"to\":10.33}]"
  }
}

Génération de texte

{
	"RequestId":"******AC-5A01-1116-87A4-BF86F2******",
	"UserData":"{\"NotifyAddress\":\"https://****\"}",
	"JobResult":{
		"AiResult":"[\"Try the cakes from our new store, made with pure, real cream for a rich, silky-smooth texture. Every bite is a sweet surprise that lets your taste buds dance with freshness and purity!\",\"Explore a new world of desserts. Our new store's cakes feature premium real cream, offering a low-sugar, non-cloying flavor with rich layers. Each cake tells a sweet story of craftsmanship, waiting for you to discover.\",\"For those who appreciate the finer things in life: our new cake shop uses carefully selected real cream with no artificial additives. Enjoy the pure, fragrant aroma and a light, fluffy texture. Every bite is a 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 cake shop, real cream\\\",\\\"textLength\\\":100,\\\"targetCount\\\":3}\"}"
	}
}

Exemples

JSON format

{
  "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": "Test title",
    "Description": "Test description",
    "UserId": "1974526429******",
    "InputConfig": {
      "InputFile": "oss://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 or ******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."
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.