すべての種類の DNA ジョブ の結果を取得します。
操作説明
DNA ジョブを送信すると、DNA サービスが比較を実行します。この API をコールして、ジョブの結果を照会できます。
テキスト DNA ジョブは、China (Shanghai) リージョンでのみ照会できます。
この API は、過去 6 か月以内に作成された DNA ジョブを照会します。
QPS 制限
この API の単一ユーザーに対する QPS 制限は、1 秒あたり 100 クエリです。この制限を超える API コールはスロットリングされるため、ビジネスに影響を与える可能性があります。適切に呼び出しを計画してください。詳細については、「QPS 制限」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
mts:QueryFpShotJobList |
get |
* すべてのリソース
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| JobIds |
string |
任意 |
照会する DNA ジョブの ID。複数の ID は、カンマ (,) で区切ります。一度に最大 10 個のジョブを指定できます。 |
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 |
任意 |
パイプライン ID。 [メディア処理コンソール] の [グローバル設定] > [パイプラインとコールバック] から ID を取得できます。 |
b11c171cced04565b1f38f1ecc39**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーターです。 |
||
| RequestId |
string |
リクエスト ID です。 |
25818875-5F78-4A13-BEF6-D7393642CA58 |
| NextPageToken |
string |
次ページの結果を取得するために必要なトークンです。次のリクエストでこのパラメーターの値を使用できます。 |
b11c171cced04565b1f38f1ecc39 |
| FpShotJobList |
object |
DNA ジョブのオブジェクトです。 |
|
| FpShotJob |
array<object> |
DNA ジョブの配列です。 |
|
|
array<object> |
DNA ジョブの詳細です。 |
||
| FpShotResult |
object |
DNA ジョブのクエリ結果です。 |
|
| AudioFpShots |
object |
オーディオ DNA のクエリ結果です。 |
|
| FpShot |
array<object> |
オーディオ DNA のクエリ結果です。 |
|
|
array<object> |
オーディオ DNA の詳細なクエリ結果です。 |
||
| PrimaryKey |
string |
プライマリキーです。 |
498ac941373341599c4777c8d884 |
| FpShotSlices |
object |
類似したオーディオセグメントです。 |
|
| FpShotSlice |
array<object> |
類似したオーディオセグメントです。 |
|
|
array<object> |
類似したオーディオセグメントの詳細です。 |
||
| Duplication |
object |
DNA ライブラリ内のオーディオセグメントの開始時刻とデュレーションです。 |
|
| Start |
string |
開始時刻です。 |
0 |
| Duration |
string |
デュレーションです。 |
3 |
| Similarity |
string |
オーディオセグメントの類似度です。 |
0 |
| Input |
object |
入力オーディオセグメントの開始時刻とデュレーションです。 |
|
| Start |
string |
開始時刻です。 |
0 |
| Duration |
string |
デュレーションです。 |
5 |
| Similarity |
string |
オーディオ全体の類似度です。 |
0 |
| FpShots |
object |
ビデオ DNA のクエリ結果です。 |
|
| FpShot |
array<object> |
ビデオ DNA のクエリ結果です。 |
|
|
array<object> |
ビデオ DNA の詳細なクエリ結果です。 |
||
| PrimaryKey |
string |
ビデオのプライマリキーです。 |
498ac941373341599c4777c8d884 |
| FpShotSlices |
object |
類似したビデオセグメントです。 |
|
| FpShotSlice |
array<object> |
類似したビデオセグメントです。 |
|
|
array<object> |
類似したビデオセグメントの詳細です。 |
||
| Duplication |
object |
DNA ライブラリ内のビデオセグメントの開始時刻とデュレーションです。 |
|
| Start |
string |
開始時刻です。 |
1260 |
| Duration |
string |
デュレーションです。 |
48 |
| Similarity |
string |
ビデオセグメントの類似度です。 |
0 |
| Input |
object |
入力ビデオセグメントの開始時刻とデュレーションです。 |
|
| Start |
string |
開始時刻です。 |
46 |
| Duration |
string |
デュレーションです。 |
48 |
| Similarity |
string |
ビデオ全体の類似度です。 説明
全体の類似度は、個々のセグメントの類似度の平均値です。DNA ライブラリで複数の類似セグメントが見つかった場合、複数のヒットが返されます。 |
0.8914769887924194 |
| TextFpShots |
object |
テキスト DNA のクエリ結果です。 |
|
| 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 |
DNA ライブラリ内のセグメントと一致した、入力からのテキストセグメントです。 |
今日は雪が降っています |
| DuplicationText |
string |
DNA ライブラリ内の一致したテキストセグメントです。 |
今日は雪が降っています |
| 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 |
DNA ライブラリの ID です。 |
2288c6ca184c0e47098a5b665e2a12 |
| FileId |
string |
ファイル ID です。 |
ebb51ee30f0b49aba959823fa991 |
| UserData |
string |
カスタムデータです。 |
testid-001 |
| Duration |
integer |
入力ファイルのデュレーションです。単位は秒です。 |
5 |
| Code |
string |
分析が失敗した場合に返されるエラーコードです。 |
InvalidParameter.UUIDFormatInvalid |
| InputFile |
object |
ジョブの入力です。 |
|
| Object |
string |
ジョブの入力を含む OSS オブジェクトです。 |
test.mp4 |
| Location |
string |
ジョブの入力を含む OSS ロケーションです。 |
oss-cn-beiing |
| Bucket |
string |
ジョブの入力を含む OSS バケットです。 |
oss-test |
| PipelineId |
string |
パイプライン ID です。 |
88c6ca184c0e47098a5b665e2a12 |
| Id |
string |
ジョブ ID です。 |
88c6ca184c0e47098a5b665e2a12 |
| Input |
string |
ジョブの入力です。 |
{"Bucket":"oss-test","Location":"oss-cn-beiing","Object":"test.mp4"} |
| NonExistIds |
object |
存在しない ID です。 |
|
| 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****"
]
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。