DNA タスクの結果を照会します。この操作では、すべてのタイプの DNA タスクの結果を照会できます。
操作説明
DNA タスクを送信した後、DNA サービスが DNA 比較を実行します。この操作を呼び出してタスクの結果を照会できます。
テキスト DNA タスクの照会は、中国 (上海) リージョンでのみサポートされています。
この操作では、過去 6 か月以内の DNA タスク情報のみを照会できます。
QPS 制限
この操作のシングルユーザー QPS 制限は、1 秒あたり 100 回です。制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。この操作は適切に呼び出してください。詳細については、「QPS 制限」を参照してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
mts:QueryFpShotJobList |
get |
*すべてのリソース。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| JobIds |
string |
任意 |
照会する DNA タスクの ID のリスト。一度に最大 10 個の ID を指定でき、カンマ (,) で区切ります。 |
88c6ca184c0e47098a5b665e2a12**** |
| NextPageToken |
string |
任意 |
ページネーショントークン。最初のリクエストではこのパラメーターを指定する必要はありません。サービスからこのトークンが返されるので、2 回目のリクエストで渡せます。 |
16f01ad6175e4230ac42bb5182cd**** |
| MaximumPageSize |
integer |
任意 |
1 ページあたり返される結果の最大値。
|
10 |
| State |
string |
任意 |
照会するタスクのステータス。有効な値:
|
All |
| StartOfJobCreatedTimeRange |
string |
任意 |
タスクの最も早い作成時間。
|
2021-12-22T03:48:05Z |
| EndOfJobCreatedTimeRange |
string |
任意 |
タスクの最も遅い作成時間。
|
2022-02-14T02:16:07Z |
| PipelineId |
string |
任意 |
MPS キューの ID。ID は、ApsaraVideo Media Processing コンソール > [グローバル設定項目] > [パイプラインとコールバック] から取得できます。 |
b11c171cced04565b1f38f1ecc39**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答パラメーター。 |
||
| RequestId |
string |
リクエスト ID。 |
25818875-5F78-4A13-BEF6-D7393642CA58 |
| NextPageToken |
string |
次のページのページネーショントークン。この値を記録し、次のリクエストで渡します。 |
b11c171cced04565b1f38f1ecc39**** |
| FpShotJobList |
object |
||
| FpShotJob |
array<object> |
DNA タスク情報。 |
|
|
array<object> |
DNA タスクの詳細。 |
||
| FpShotResult |
object |
DNA タスクのクエリ結果。 |
|
| 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> |
テキスト DNA のクエリ結果。 |
|
|
array<object> |
テキスト DNA のクエリ結果の詳細。 |
||
| PrimaryKey |
string |
テキストの一意のプライマリキー。 |
3e34ac649945b53a1b0f863ce030**** |
| Similarity |
string |
テキストの類似度。 |
1.0 |
| TextFpShotSlices |
object |
||
| TextFpShotSlice |
array<object> |
重複テキスト。 |
|
|
array<object> |
重複テキストの詳細。 |
||
| Similarity |
string |
入力テキストと、テキスト指紋ライブラリ内で類似した指紋を持つテキストスニペットとの類似度。 |
1.0 |
| InputText |
string |
テキスト指紋分析の入力テキスト。 |
It is snowing today. |
| DuplicationText |
string |
テキスト指紋ライブラリ内で、入力テキストと類似した指紋を持つテキストスニペット。 |
It is snowing today. |
| InputFragment |
object |
入力テキスト内の類似したテキストスニペットの開始時点と長さ。 |
|
| Start |
string |
入力テキスト内の類似したテキストスニペットの開始時刻。 |
0 |
| Duration |
string |
入力テキスト内の類似したテキストスニペットの長さ。 |
3 |
| CreationTime |
string |
作成時刻。 |
2017-01-10T12:00:00Z |
| FinishTime |
string |
完了時刻。 |
0 |
| State |
string |
タスクの状態。有効な値:
|
Success |
| Message |
string |
分析が失敗した場合に返されるエラーメッセージ。タスクが成功した場合、このパラメーターは返されません。 |
パラメーター "Id" は有効ではありません。UUID は次の条件を満たす必要があります: 1) 文字 [a-f] および数字 [0-9] で構成されている、2) 32 文字である。 |
| FpShotConfig |
object |
構成。 |
|
| PrimaryKey |
string |
動画の一意のプライマリキー。一意性はユーザーによって保証されます。 |
3ca84a39a9024f19853b21be9cf9**** |
| SaveType |
string |
保存タイプ。有効な値:
|
save |
| FpDBId |
string |
DNA ライブラリ ID。 |
2288c6ca184c0e47098a5b665e2a12**** |
| FileId |
string |
ファイル ID。 |
ebb51ee30f0b49aba959823fa991**** |
| UserData |
string |
カスタムデータ。 |
testid-001 |
| Duration |
integer |
入力ファイルの持続時間 (秒単位)。 |
5 |
| Code |
string |
分析が失敗した場合に返されるエラーコード。 |
無効なパラメーター。UUID フォーマットが有効ではありません。 |
| InputFile |
object |
ジョブ入力。 |
|
| Object |
string |
ジョブ入力の 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": "It is snowing today.",
"DuplicationText": "It is snowing today.",
"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****"
]
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。