Effectue des recherches sémantiques sur les métadonnées d'un jeu de données en utilisant une saisie en langage naturel.
Description de l'opération
Précautions
-
Avant d'appeler cette opération, assurez-vous de bien comprendre les méthodes de facturation et la tarification d'Intelligent Media Management. Chaque requête adressée à cette opération entraîne des frais de compréhension sémantique et des frais de requête.
-
Avant d'appeler cette opération, assurez-vous d'avoir indexé des fichiers dans un jeu de données via une liaison (CreateBinding) ou une indexation active (IndexFileMeta ou BatchIndexFileMeta).
-
Les résultats renvoyés sont fournis à titre indicatif uniquement. Selon la configuration du modèle de workflow, les catégories et le contenu des métadonnées de fichier récupérées peuvent différer des exemples. Si vous avez des questions, rejoignez le groupe DingTalk pour nous faire part de vos commentaires. Pour obtenir l'identifiant du groupe DingTalk, consultez la section Nous contacter.
Limites
-
Un maximum de 100 enregistrements de fichiers sont renvoyés pour chaque requête.
-
Les requêtes paginées ne sont pas prises en charge.
-
La compréhension du langage naturel n'est pas garantie d'être parfaitement exacte.
-
Cette fonctionnalité n'est pas prise en charge dans les régions États-Unis (Silicon Valley) et États-Unis (Virginie).
Utilisation
Utilisez des mots-clés en langage naturel pour rechercher des fichiers dans un jeu de données. Actuellement, les informations clés prises en charge incluent les étiquettes (Labels.LabelName), l'heure (ProduceTime) et les emplacements (Address.AddressLine). Par exemple, si vous utilisez paysages à Hangzhou en 2023 comme condition de requête, celle-ci est intelligemment divisée en les trois conditions suivantes pour trouver les fichiers qui répondent à toutes ces conditions :
-
ProduceTime : Du 1er janvier 2023 à 00:00:00 au 31 décembre 2023 à 23:59:59.
-
Address.AddressLine : Contient le mot-clé Hangzhou.
-
Labels.LabelName : Contient l'étiquette paysages.
En combinaison avec la configuration du modèle de workflow, lorsque le modèle inclut l'opérateur ImageEmbeddingExtraction, la requête de recherche fournit une recherche d'images basée sur le contenu. Cela signifie que le contenu Query que vous saisissez est également compris comme le contenu présent dans l'image, permettant ainsi une récupération intelligente des images.
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
|
imm:SemanticQuery |
list |
*Jeu de données.
|
Aucune | Aucune |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| NextToken |
string |
Non |
Ce paramètre n'est plus fourni. |
Reserved. Not supported yet. |
| MaxResults |
integer |
Non |
Le nombre maximal d'enregistrements de données à renvoyer dans cette requête. Plage de valeurs : (0,100]. |
20 |
| ProjectName |
string |
Oui |
Le nom du projet. |
test-project |
| DatasetName |
string |
Oui |
Le nom du jeu de données. |
test-dataset |
| Query |
string |
Non |
Important Ce paramètre ou le paramètre SourceURI doit être spécifié. |
Scenery of Hangzhou in April 2021 |
| WithFields |
array |
Non |
Spécifie les champs spécifiques à renvoyer au lieu de tous les champs de métadonnées existants. Cela permet de réduire la taille de la structure renvoyée. Si ce paramètre est laissé vide, tous les champs sont renvoyés. |
|
|
string |
Non |
Spécifie les champs spécifiques à renvoyer au lieu de tous les champs de métadonnées existants. Cela permet de réduire la taille de la structure renvoyée. Si ce paramètre est laissé vide, tous les champs sont renvoyés. |
["URI", "Filename"] |
|
| MediaTypes |
array |
Non |
Les types de médias à rechercher. Si ce paramètre est laissé vide, la valeur par défaut est : |
|
|
string |
Non |
Valeurs valides : image |
["image"] |
|
| SourceURI |
string |
Non |
Important Ce paramètre ou le paramètre Query doit être spécifié. Ce paramètre n'est actuellement valide que lorsque le type de recherche est spécifié comme image et que le jeu de données est configuré avec un modèle de workflow pour la recherche d'image à image. Le format de l'adresse OSS est oss://${Bucket}/${Object}, où ${Bucket} est le nom du compartiment OSS qui réside dans la même région que le projet actuel, et ${Object} est le chemin complet du fichier, y compris l'extension du nom de fichier. Si vous devez configurer le modèle de workflow correspondant, contactez-nous. |
oss://test-bucket/test-object |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
Schéma de la réponse. |
||
| Files |
array |
La liste des fichiers. |
|
| File |
Les informations sur le fichier. |
||
| RequestId |
string |
L'identifiant de la requête. |
2C5C1E0F-D8B8-4DA0-8127-EC32C771**** |
Exemples
JSON format
{
"Files": [
{
"OwnerId": "102321002467****",
"ProjectName": "test-project",
"DatasetName": "test-dataset",
"ObjectType": "file",
"ObjectId": "75d5de2c50754e3dadd5c35dbca5f9949369e37eb342a73821f690c94c36c7f7",
"UpdateTime": "2021-06-29T14:50:13.011643661+08:00",
"CreateTime": "2021-06-29T14:50:13.011643661+08:00",
"URI": "oss://test-bucket/test-object.jpg",
"OSSURI": "oss://examplebucket/sampleobject.jpg",
"Filename": "sampleobject.jpg",
"MediaType": "image",
"ContentType": "image/jpeg",
"Size": 1000,
"FileHash": "1d9c280a7c4f67f7ef873e28449dbe17",
"FileModifiedTime": "2021-06-29T14:50:13.011643661+08:00",
"FileCreateTime": "2021-06-29T14:50:13.011643661+08:00",
"FileAccessTime": "2021-06-29T14:50:13.011643661+08:00",
"ProduceTime": "2021-06-29T14:50:13.011643661+08:00",
"LatLong": "30.134390,120.074997",
"Timezone": "\"\"",
"Addresses": [
{
"Language": "zh-Hans",
"AddressLine": "N° 969, Wenyi West Road, district de Yuhang, Hangzhou, Zhejiang, Chine",
"Country": "Chine",
"Province": "Zhejiang",
"City": "Hangzhou",
"District": "District de Yuhang",
"Township": "Wenyi West Road"
}
],
"TravelClusterId": "-",
"Orientation": 0,
"Figures": [
{
"FigureId": "868a9e74-cde5-4c7a-9013-28bb984****",
"FigureConfidence": 1,
"FigureClusterId": "Cluster-dbe72fec-b84c-4ab6-885b-3678e64****",
"FigureClusterConfidence": 1,
"FigureType": "face",
"Age": 29,
"AgeSD": 5,
"Gender": "female",
"GenderConfidence": 1,
"Emotion": "happiness",
"EmotionConfidence": 0.70784568786621,
"FaceQuality": 0.960875928401947,
"Boundary": {
"Width": 200,
"Height": 300,
"Left": 10,
"Top": 30,
"Polygon": [
{
"X": 10,
"Y": 10
}
]
},
"Mouth": "close",
"MouthConfidence": 1,
"Beard": "none",
"BeardConfidence": 1,
"Hat": "none",
"HatConfidence": 1,
"Mask": "none",
"MaskConfidence": 1,
"Glasses": "none",
"GlassesConfidence": 0.8,
"Sharpness": 0.7,
"Attractive": 0.96,
"HeadPose": {
"Pitch": 18.385589599609375,
"Roll": 4.204030513763428,
"Yaw": 2.4945924282073975
}
}
],
"FigureCount": 10,
"Labels": [
{
"Language": "zh-Hans",
"LabelName": "椅子",
"LabelLevel": 2,
"LabelConfidence": 0.95,
"ParentLabelName": "家具",
"CentricScore": 0.877,
"LabelAlias": "座椅",
"Clips": [
{
"TimeRange": [
100
]
}
]
}
],
"Title": "test",
"ImageWidth": 270,
"ImageHeight": 500,
"EXIF": "{\"Compression\":{\"value\":\"6\"},\"DateTime\":{\"value\":\"2020:08:19 17:11:11\"}}",
"ImageScore": {
"OverallQualityScore": 0.736
},
"CroppingSuggestions": [
{
"AspectRatio": "2:3",
"Confidence": 0.742,
"Boundary": {
"Width": 200,
"Height": 300,
"Left": 10,
"Top": 30,
"Polygon": [
{
"X": 10,
"Y": 10
}
]
}
}
],
"OCRContents": [
{
"Language": "zh-hans",
"Contents": "Bienvenue dans Intelligent Media Management",
"Confidence": 0.8254936695098877,
"Boundary": {
"Width": 200,
"Height": 300,
"Left": 10,
"Top": 30,
"Polygon": [
{
"X": 10,
"Y": 10
}
]
}
}
],
"VideoWidth": 1080,
"VideoHeight": 1920,
"VideoStreams": [
{
"Index": 0,
"Language": "en",
"CodecName": "h264",
"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"Profile": "High",
"CodecTimeBase": "1373627/83160000",
"CodecTagString": "avc1",
"CodecTag": "0x31637661",
"Width": 1280,
"Height": 720,
"HasBFrames": 2,
"SampleAspectRatio": "1:1",
"DisplayAspectRatio": "16:9",
"PixelFormat": "yuv420p",
"Level": 40,
"FrameRate": "25/1",
"AverageFrameRate": "25/1",
"TimeBase": "1/12800",
"StartTime": 0,
"Duration": 22.88,
"Bitrate": 5407765,
"FrameCount": 572,
"Rotate": "90",
"BitDepth": 8,
"ColorSpace": "bt709",
"ColorRange": "tv",
"ColorTransfer": "bt709",
"ColorPrimaries": "bt709"
}
],
"Subtitles": [
{
"Index": 2,
"Language": "en",
"CodecName": "mov_text",
"CodecLongName": "MOV text",
"CodecTagString": "tx3g",
"CodecTag": "0x67337874",
"StartTime": 0,
"Duration": 71.378,
"Bitrate": 74,
"Content": "Bienvenue",
"Width": 600,
"Height": 30
}
],
"AudioStreams": [
{
"Index": 1,
"Language": "en",
"CodecName": "aac",
"CodecLongName": "AAC (Advanced Audio Coding)",
"CodecTimeBase": "1/44100",
"CodecTagString": "mp4a",
"CodecTag": "0x6134706d",
"TimeBase": "1/48000",
"StartTime": 0.0235,
"Duration": 3.690667,
"Bitrate": 320087,
"FrameCount": 173,
"Lyric": "test",
"SampleFormat": "fltp",
"SampleRate": 48000,
"Channels": 2,
"ChannelLayout": "stéréo"
}
],
"Artist": "Jane",
"AlbumArtist": "Jane",
"AudioCovers": [
{
"ImageWidth": 500,
"ImageHeight": 820,
"EXIF": "{\"FileSize\":{\"value\":\"29304\"},\"Format\":{\"value\":\"jpg\"}}",
"ImageScore": {
"OverallQualityScore": 0.736
},
"CroppingSuggestions": [
{
"AspectRatio": "2:3",
"Confidence": 0.742
}
],
"OCRContents": [
{
"Language": "zh-hans",
"Contents": "Bienvenue dans Intelligent Media Management",
"Confidence": 0.8254936695098877
}
]
}
],
"Composer": "Jane",
"Performer": "Jane",
"Language": "eng",
"Album": "FirstAlbum",
"PageCount": 5,
"ETag": "\"1D9C280A7C4F67F7EF873E28449****\"",
"CacheControl": "no-cache",
"ContentDisposition": "attachment; filename =test.jpg",
"ContentEncoding": "UTF-8",
"ContentLanguage": "zh-CN",
"AccessControlAllowOrigin": "https://aliyundoc.com",
"AccessControlRequestMethod": "PUT",
"ServerSideEncryptionCustomerAlgorithm": "SM4",
"ServerSideEncryption": "AES256",
"ServerSideDataEncryption": "SM4",
"ServerSideEncryptionKeyId": "9468da86-3509-4f8d-a61e-6eab1eac****",
"OSSStorageClass": "Standard",
"OSSCRC64": "559890638950338001",
"ObjectACL": "default",
"ContentMd5": "HZwoCnxPZ/fvhz4oRJ2+Fw==",
"OSSUserMeta": {
"key": "val"
},
"OSSTaggingCount": 2,
"OSSTagging": {
"key": "val"
},
"OSSExpiration": "2120-01-01T12:00:00.000Z",
"OSSVersionId": "CAEQNhiBgMDJgZCA0BYiIDc4MGZjZGI2OTBjOTRmNTE5NmU5NmFhZjhjYmY0****",
"OSSDeleteMarker": "CAEQMhiBgIDXiaaB0BYiIGQzYmRkZGUxMTM1ZDRjOTZhNjk4YjRjMTAyZjhl****",
"OSSObjectType": "Normal",
"CustomId": "\t\nmember-image-id-0001",
"CustomLabels": {
"test": "test",
"test2": 1
},
"StreamCount": 1,
"ProgramCount": 1,
"FormatName": "mov",
"FormatLongName": "QuickTime / MOV",
"StartTime": 0,
"Bitrate": 13091201,
"Duration": 15.263,
"SemanticTypes": [
"content"
],
"Elements": [
{
"ElementContents": [
{
"Type": "text",
"Content": "Fragment de texte",
"URL": "http://aliyun.com",
"TimeRange": [
500
]
}
],
"ObjectId": "id1",
"ElementType": "title - titre ; image - image ; table - tableau ; narrative-text - texte narratif",
"SemanticSimilarity": 0.8,
"ElementRelations": [
{
"Type": "child, parent",
"ObjectId": "id1"
}
]
}
],
"SceneElements": [
{
"TimeRange": [
100
],
"FrameTimes": [
30
],
"VideoStreamIndex": 0,
"Labels": [
{
"Language": "zh-Hans",
"LabelName": "椅子",
"LabelLevel": 2,
"LabelConfidence": 0.95,
"ParentLabelName": "家具",
"CentricScore": 0.877,
"LabelAlias": "座椅",
"Clips": [
{
"TimeRange": [
100
]
}
]
}
]
}
],
"OCRTexts": "阿里云IMM",
"Reason": "[InternalError] The request has been failed due to some unknown error. status: 500, requestId: CC5ACFBD-BB7A-496D-A9D6-****",
"ObjectStatus": "Indexed",
"Insights": {
"Video": {
"Description": "None",
"Caption": "La vidéo montre deux scènes différentes : l'une avec une assiette blanche immobile, un flacon noir et un verre transparent, et l'autre avec une main tenant un flacon de shampoing portant la mention \"YEZOLU\" se déplaçant lentement vers le haut dans une salle de bain"
},
"Image": {
"Caption": "Aucun",
"Description": "L'image représente une personne vêtue d'une veste de costume sombre et d'une chemise blanche. L'arrière-plan est un dégradé allant du bleu clair au gris"
}
}
}
],
"RequestId": "2C5C1E0F-D8B8-4DA0-8127-EC32C771****"
}Codes d'erreur
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.