メディア指紋分析ジョブをクエリします。 この操作を呼び出して、ビデオ指紋分析ジョブとテキスト指紋分析ジョブをクエリできます。
操作説明
メディア指紋分析ジョブが送信されると、メディア指紋サービスはジョブ入力の指紋をメディア指紋ライブラリ内のメディアファイルの指紋と比較します。 この操作を呼び出して、ジョブの結果をクエリできます。
テキスト指紋分析ジョブの結果は、中国 (上海) リージョンでのみクエリできます。
QPS 制限
アカウントごとに、毎秒最大 100 回この API 操作を呼び出すことができます。 この制限を超えたリクエストは破棄され、サービスが中断されます。 この操作を呼び出す際は、この制限に注意することを推奨します。 詳細については、「QPS 制限」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
mts:QueryFpShotJobList |
get |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| JobIds |
string |
任意 |
クエリするメディア指紋分析ジョブの ID。 ジョブ ID を表示するには、ApsaraVideo Media Processing (MPS) コンソールにログインし、左側のナビゲーションウィンドウで [タスク] をクリックし、[タスク] ページで [ビデオ DNA] タブをクリックします。 一度に最大 10 件のメディア指紋分析ジョブをクエリできます。 複数のジョブ ID はコンマ (,) で区切ります。 |
88c6ca184c0e47098a5b665e2a12**** |
| NextPageToken |
string |
任意 |
クエリ結果の次のページを取得するために使用されるトークン。 最初のリクエストでは、このパラメーターを指定する必要はありません。 最初のリクエストのレスポンスにこのパラメーターが含まれているので、次のリクエストに追加します。 |
16f01ad6175e4230ac42bb5182cd**** |
| MaximumPageSize |
integer |
任意 |
各ページで返すエントリの最大数。
|
10 |
| State |
string |
任意 |
クエリするジョブのステータス。 有効な値：
|
All |
| StartOfJobCreatedTimeRange |
string |
任意 |
クエリ対象のジョブが作成された期間の開始時刻。
|
2021-12-22T03:48:05Z |
| EndOfJobCreatedTimeRange |
string |
任意 |
クエリ対象のジョブが作成された期間の終了時刻。
|
2022-02-14T02:16:07Z |
| PipelineId |
string |
任意 |
MPS キューの ID。 MPS キューの ID を表示するには、MPS コンソールにログインし、左側のナビゲーションウィンドウで [グローバル設定] > [パイプライン] を選択します。 |
b11c171cced04565b1f38f1ecc39**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーター。 |
||
| RequestId |
string |
リクエストの ID。 |
25818875-5F78-4A13-BEF6-D7393642CA58 |
| NextPageToken |
string |
クエリ結果の次のページを取得するために使用されるトークン。 値は 32 ビットの UUID です。 返されたクエリ結果が 1 ページに表示できない場合、このパラメーターが返されます。 このパラメーターの値は、クエリごとに更新されます。 |
b11c171cced04565b1f38f1ecc39**** |
| FpShotJobList |
object |
||
| FpShotJob |
array<object> |
メディア指紋分析ジョブに関する情報。 |
|
|
array<object> |
メディア指紋分析ジョブの詳細。 |
||
| FpShotResult |
object |
メディア指紋分析ジョブの結果。 |
|
| AudioFpShots |
object |
||
| FpShot |
array<object> |
音声指紋分析結果。 |
|
|
array<object> |
音声指紋分析結果の詳細。 |
||
| PrimaryKey |
string |
入力音声の一意のプライマリキー。 |
498ac941373341599c4777c8d884**** |
| FpShotSlices |
object |
||
| FpShotSlice |
array<object> |
音声指紋ライブラリ内で、入力音声と類似した指紋を持つ音声ファイル。 |
|
|
array<object> |
音声指紋ライブラリ内で、入力音声と類似した指紋を持つ音声ファイルの詳細。 |
||
| Duplication |
object |
音声指紋ライブラリ内で、入力音声と類似した指紋を持つ音声ファイル内の、類似したオーディオクリップの開始時点と長さ。 |
|
| Start |
string |
音声指紋ライブラリ内で、入力音声と類似した指紋を持つ音声ファイル内の、類似したオーディオクリップの開始時点。 |
0 |
| Duration |
string |
音声指紋ライブラリ内で、入力音声と類似した指紋を持つ音声ファイル内の、類似したオーディオクリップの長さ。 |
3 |
| Similarity |
string |
入力音声と、音声指紋ライブラリ内で類似した指紋を持つ音声ファイルとの類似度。 |
0 |
| Input |
object |
入力音声内の類似したオーディオクリップの開始時点と長さ。 |
|
| Start |
string |
入力音声内の類似したオーディオクリップの開始時点。 |
0 |
| Duration |
string |
入力音声内の類似したオーディオクリップの長さ。 |
5 |
| Similarity |
string |
入力音声と、音声指紋ライブラリ内で類似した指紋を持つ音声ファイルとの全体的な類似度。 |
0 |
| FpShots |
object |
||
| FpShot |
array<object> |
ビデオ指紋分析結果。 |
|
|
array<object> |
ビデオ指紋分析結果の詳細。 |
||
| PrimaryKey |
string |
入力ビデオの一意のプライマリキー。 |
498ac941373341599c4777c8d884**** |
| FpShotSlices |
object |
||
| FpShotSlice |
array<object> |
ビデオ指紋ライブラリ内で、入力ビデオと類似した指紋を持つビデオファイル。 |
|
|
array<object> |
ビデオ指紋ライブラリ内で、入力ビデオと類似した指紋を持つビデオファイルの詳細。 |
||
| Duplication |
object |
ビデオ指紋ライブラリ内で、入力ビデオと類似した指紋を持つビデオファイル内の、類似したビデオクリップの開始時点と長さ。 |
|
| Start |
string |
ビデオ指紋ライブラリ内で、入力ビデオと類似した指紋を持つビデオファイル内の、類似したビデオクリップの開始時点。 |
1260 |
| Duration |
string |
ビデオ指紋ライブラリ内で、入力ビデオと類似した指紋を持つビデオファイル内の、類似したビデオクリップの長さ。 |
48 |
| Similarity |
string |
入力ビデオクリップと、ビデオ指紋ライブラリ内で類似した指紋を持つビデオファイルとの類似度。 |
0 |
| Input |
object |
入力ビデオ内の類似したビデオクリップの開始時刻と長さ。 |
|
| Start |
string |
入力ビデオ内の類似したビデオクリップの開始時点。 |
46 |
| Duration |
string |
入力ビデオ内の類似したビデオクリップの長さ。 |
48 |
| Similarity |
string |
入力ビデオと、ビデオ指紋ライブラリ内で類似した指紋を持つビデオファイルとの全体的な類似度。 説明
全体的な類似度は、入力ビデオクリップと、類似した指紋を持つビデオのクリップとの類似度の平均値です。 ビデオ指紋ライブラリに入力ビデオと類似した指紋を持つビデオファイルが複数存在する場合、入力ビデオと複数の類似したビデオクリップとの類似度が返されます。 |
0.8914769887924194 |
| TextFpShots |
object |
||
| TextFpShot |
array<object> |
テキスト指紋分析結果。 |
|
|
array<object> |
テキスト指紋分析結果の詳細。 |
||
| PrimaryKey |
string |
入力テキストの一意のプライマリキー。 |
3e34ac649945b53a1b0f863ce030**** |
| Similarity |
string |
入力テキストと、テキスト指紋ライブラリ内で類似した指紋を持つテキストスニペットとの類似度。 |
1.0 |
| TextFpShotSlices |
object |
||
| TextFpShotSlice |
array<object> |
テキスト指紋ライブラリ内で、入力テキストと類似した指紋を持つテキストスニペット。 |
|
|
array<object> |
テキスト指紋ライブラリ内で、入力テキストと類似した指紋を持つテキストスニペットの詳細。 |
||
| Similarity |
string |
入力テキストと、テキスト指紋ライブラリ内で類似した指紋を持つテキストスニペットとの類似度。 |
1.0 |
| InputText |
string |
テキスト指紋分析の入力テキスト。 |
今天下雪了 |
| DuplicationText |
string |
テキスト指紋ライブラリ内で、入力テキストと類似した指紋を持つテキストスニペット。 |
今天下雪了 |
| InputFragment |
object |
入力テキスト内の類似したテキストスニペットの開始時点と長さ。 |
|
| Start |
string |
入力テキスト内の類似したテキストスニペットの開始時刻。 |
0 |
| Duration |
string |
入力テキスト内の類似したテキストスニペットの長さ。 |
3 |
| CreationTime |
string |
ジョブが作成された時間。 |
2017-01-10T12:00:00Z |
| FinishTime |
string |
ジョブが完了した時間。 |
0 |
| State |
string |
ジョブのステータス。 有効な値：
|
Success |
| Message |
string |
ジョブが失敗した場合に返されるエラーメッセージ。 ジョブが成功した場合、このパラメーターは返されません。 |
The parameter \"Id\" is invalid.A uuid must:1)be comprised of chracters[a-f],numbers[0-9];2)be 32 characters long |
| FpShotConfig |
object |
ジョブの設定。 |
|
| PrimaryKey |
string |
ビデオの一意のプライマリキー。 |
3ca84a39a9024f19853b21be9cf9**** |
| SaveType |
string |
ストレージタイプ。 有効な値：
|
save |
| FpDBId |
string |
メディア指紋ライブラリの ID。 |
2288c6ca184c0e47098a5b665e2a12**** |
| FileId |
string |
アップロードされたファイルの ID。 |
ebb51ee30f0b49aba959823fa991**** |
| UserData |
string |
カスタムデータ。 |
testid-001 |
| Duration |
integer |
入力ファイルの長さ。 単位：秒。 |
5 |
| Code |
string |
ジョブが失敗した場合に返されるエラーコード。 |
InvalidParameter.UUIDFormatInvalid |
| InputFile |
object |
ジョブ入力に関する情報。 |
|
| Object |
string |
ジョブ入力として使用される Object Storage Service (OSS) オブジェクト。 |
test.mp4 |
| Location |
string |
ジョブ入力が存在する OSS リージョン。 |
oss-cn-beiing |
| Bucket |
string |
ジョブ入力が存在する OSS バケット。 |
oss-test |
| PipelineId |
string |
分析ジョブが送信される MPS キューの ID。 |
88c6ca184c0e47098a5b665e2a12**** |
| Id |
string |
ジョブの ID。 |
88c6ca184c0e47098a5b665e2a12**** |
| Input |
string |
ジョブ入力に関する情報。 |
{"Bucket":"oss-test","Location":"oss-cn-beiing","Object":"test.mp4"} |
| NonExistIds |
object |
||
| String |
array |
存在しないジョブの ID。 |
|
|
string |
存在しないジョブの ID。 指定されたすべてのジョブが見つかった場合、このパラメーターは返されません。 |
ae687c02fe944327ba9631e50da23128**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
"NextPageToken": "b11c171cced04565b1f38f1ecc39****",
"FpShotJobList": {
"FpShotJob": [
{
"FpShotResult": {
"AudioFpShots": {
"FpShot": [
{
"PrimaryKey": "498ac941373341599c4777c8d884****",
"FpShotSlices": {
"FpShotSlice": [
{
"Duplication": {
"Start": "0",
"Duration": "3"
},
"Similarity": "0",
"Input": {
"Start": "0",
"Duration": "5"
}
}
]
},
"Similarity": "0"
}
]
},
"FpShots": {
"FpShot": [
{
"PrimaryKey": "498ac941373341599c4777c8d884****",
"FpShotSlices": {
"FpShotSlice": [
{
"Duplication": {
"Start": "1260",
"Duration": "48"
},
"Similarity": "0",
"Input": {
"Start": "46",
"Duration": "48"
}
}
]
},
"Similarity": "0.8914769887924194"
}
]
},
"TextFpShots": {
"TextFpShot": [
{
"PrimaryKey": "3e34ac649945b53a1b0f863ce030****",
"Similarity": "1.0",
"TextFpShotSlices": {
"TextFpShotSlice": [
{
"Similarity": "1.0",
"InputText": "今天下雪了",
"DuplicationText": "今天下雪了",
"InputFragment": {
"Start": "0",
"Duration": "3"
}
}
]
}
}
]
}
},
"CreationTime": "2017-01-10T12:00:00Z",
"FinishTime": "0",
"State": "Success",
"Message": "The parameter \\\"Id\\\" is invalid.A uuid must:1)be comprised of chracters[a-f],numbers[0-9];2)be 32 characters long",
"FpShotConfig": {
"PrimaryKey": "3ca84a39a9024f19853b21be9cf9****",
"SaveType": "save",
"FpDBId": "2288c6ca184c0e47098a5b665e2a12****"
},
"FileId": "ebb51ee30f0b49aba959823fa991****",
"UserData": "testid-001",
"Duration": 5,
"Code": "InvalidParameter.UUIDFormatInvalid",
"InputFile": {
"Object": "test.mp4",
"Location": "oss-cn-beiing",
"Bucket": "oss-test"
},
"PipelineId": "88c6ca184c0e47098a5b665e2a12****",
"Id": "88c6ca184c0e47098a5b665e2a12****",
"Input": "{\"Bucket\":\"oss-test\",\"Location\":\"oss-cn-beiing\",\"Object\":\"test.mp4\"}"
}
]
},
"NonExistIds": {
"String": [
"ae687c02fe944327ba9631e50da23128****"
]
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。