タスク ID を指定して、スマートタスクの情報と実行結果を取得します。この API は、過去 1 年間の編集タスクのみをクエリできます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ice:GetSmartHandleJob |
get |
* すべてのリソース
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| JobId |
文字列 |
任意 |
ジョブ ID。 |
**20b48fb04483915d4f2cd8ac** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスのスキーマ。 |
||
| RequestId |
文字列 |
リクエスト ID。 |
******11-DB8D-4A9A-875B-275798****** |
| JobId |
文字列 |
ジョブ ID。 |
****20b48fb04483915d4f2cd8ac**** |
| Output |
文字列 |
ジョブの出力。 |
{} |
| JobResult |
object |
ジョブ結果。 |
|
| MediaId |
文字列 |
メディア ID。 |
****20b48fb04483915d4f2cd8ac**** |
| AiResult |
文字列 |
AI 結果。 |
動画分割やスマートタグの情報 |
| Usage |
文字列 |
トークン使用量。 このパラメーターは、キーワード拡張ジョブの場合にのみ返されます。 |
{"total_tokens":100} |
| MediaUrl |
文字列 |
スマートジョブによって生成された出力メディアファイルの URL。 |
http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 |
| State |
文字列 |
ジョブの状態。 列挙値:
|
Finished |
| UserData |
文字列 |
ユーザーデータ。 |
{"user":"data"} |
| SmartJobInfo |
object |
スマートジョブ情報。 |
|
| Title |
文字列 |
ジョブのタイトル。 |
Test title |
| Description |
文字列 |
ジョブの説明。 |
Test description |
| UserId |
文字列 |
ユーザー ID。 |
1974526429****** |
| InputConfig |
object |
入力構成。 |
|
| InputFile |
文字列 |
入力ファイルの Object Storage Service (OSS) URL またはメディア ID。 |
oss://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 or ******11-DB8D-4A9A-875B-275798****** |
| OutputConfig |
object |
出力構成。 |
|
| Bucket |
文字列 |
OSS バケット。 |
test-bucket |
| Object |
文字列 |
OSS オブジェクト。 |
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. |
結果のフォーマットは、スマートジョブのタイプによって異なります。以下に、さまざまなスマートジョブのレスポンスボディの例を示します。
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}]"
}
}
音声合成
{
"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******"
}
}
テキスト生成
{
"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}\"}"
}
}
例
成功レスポンス
JSONJSON
{
"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 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": "有効な音声データが不足しているため、音声翻訳ジョブは失敗しました。"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。