Tous les produits
Search
Centre de documentation

:SearchMedia

Dernière mise à jour :Oct 09, 2026

Consulte les informations sur les ressources multimédias qui correspondent aux conditions spécifiées en fonction des paramètres fournis.

Description de l'opération

Pour toute question ou consultation concernant la fonctionnalité de recherche intelligente de ressources multimédias d'Alibaba Cloud Intelligent Media Services, recherchez l'identifiant de groupe DingTalk 30415005038 pour rejoindre le groupe de questions-réponses clients pour la recherche multimodale d'Intelligent Media Services et nous contacter.

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

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ice:SearchMedia

get

*Toutes les ressources.

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

Match

string

Non

Les conditions de filtrage.

title = 'China' and utcCreate = ['1693367158561','1693367158562']

SortBy

string

Non

Les champs de tri et l'ordre de tri. Séparez les valeurs multiples par des virgules (,).

utcCreate:Desc

PageNo

integer

Non

Le numéro de page. Valeur par défaut : 1.

1

PageSize

integer

Non

Le nombre d'entrées à renvoyer par page. Valeur par défaut : 10. Valeur maximale : 50.

20

EntityId

string

Non

L'identifiant de l'entité.

2d3bf1e35a1e42b5ab338d701efa****

ScrollToken

string

Non

Le jeton de pagination, qui est une chaîne de 32 caractères. Vous n'avez pas besoin de spécifier ce paramètre lorsque vous lancez une requête de recherche pour la première fois. Si la requête de recherche renvoie des données, le serveur renvoie la valeur de ce paramètre pour enregistrer la position des données de recherche actuelles. Enregistrez la valeur renvoyée et spécifiez ce paramètre dans les recherches ultérieures en fonction des exigences ou suggestions suivantes : ce paramètre est requis lorsque vous devez parcourir toutes les données correspondant aux conditions de recherche. Si la valeur du paramètre PageNo dépasse 200, spécifiez ce paramètre pour optimiser les performances de recherche. Vous ne pouvez paginer que vers l'avant, et la distance de pagination maximale est de 1 000 ressources multimédias.

F8C4F642184DBDA5D93907A70AAE****

SearchLibName

string

Non

La bibliothèque de recherche.

test-1

CustomFilters

string

Non

Les filtres personnalisés. La valeur est une chaîne JSON. Les champs pris en charge incluent le champ entier intField1 et les champs de type chaîne strField1 et strField2. Vous pouvez sélectionner au maximum un type de correspondance pour un même champ. Les filtres pour différents champs sont combinés à l'aide de l'opérateur logique ET.

  • Correspondance exacte, par exemple {"intField1":12,"strField1":"abc"}

  • Correspondance multi-valeurs, par exemple {"intField1":[12,13],"strField1":["abc","cd"]}

  • Correspondance de plage, par exemple {"intField1":{"gte":12,"lte":13}}

{"intField1":{"gte":12,"lte":13},"strField2":["cd","de"],"strField1":"abc"}

Éléments de réponse

Élément

Type

Description

Exemple

object

Le schéma de la réponse.

RequestId

string

L'identifiant de la requête.

6F61C357-ACC0-57FB-876E-D5879533****

Success

string

Indique si la requête a réussi.

True

Code

string

Le code de retour.

200

MediaInfoList

array<object>

Les ressources multimédias éligibles.

array<object>

La liste des informations sur les ressources multimédias.

MediaId

string

L'identifiant de la ressource multimédia.

3b187b3620c8490886cfc2a9578c****

MediaBasicInfo

object

Les informations de base de la ressource multimédia.

MediaId

string

L'identifiant de la ressource multimédia.

132bd600fc3c71ec99476732a78f****

InputURL

string

L'URL de la ressource multimédia à enregistrer dans le système correspondant.

oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf8498165024814****

MediaType

string

Le type de média de la ressource multimédia.

video

BusinessType

string

Le type d'activité de la ressource multimédia.

opening

Source

string

La source.

oss

Title

string

Le titre.

Intelligent landscape-to-portrait

Description

string

La description du contenu.

Transcoded this video

Category

string

La catégorie.

image

MediaTags

string

Les balises.

tags,tags2

CoverURL

string

L'URL de la couverture.

https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/e694372e-4f5b-4821-ae09-efd064f2****_large_cover_url.jpg

UserData

string

Les données utilisateur.

userData

Snapshots

string

Les instantanés.

[{"bucket":"example-bucket","count":"3","iceJobId":"******f48f0e4154976b2b8c45******","location":"oss-cn-beijing","snapshotRegular":"example.jpg","templateId":"******e6a6440b29eb60bd7c******"}]

Status

string

L'état de la ressource.

Normal

TranscodeStatus

string

L'état du transcodage.

Init

CreateTime

string

L'heure de création de la ressource multimédia. L'heure suit la norme ISO 8601 et est affichée en UTC (se terminant par Z).

2020-12-01T19:48Z

ModifiedTime

string

L'heure de modification de la ressource multimédia. L'heure suit la norme ISO 8601 et est affichée en UTC (se terminant par Z).

2020-12-01T19:48Z

DeletedTime

string

L'heure de suppression de la ressource multimédia. L'heure suit la norme ISO 8601 et est affichée en UTC (se terminant par Z).

2020-12-01T19:48Z

SpriteImages

string

Les images sprite.

[{"bucket":"example-bucket","count":"32","iceJobId":"******83ec44d58b2069def2e******","location":"oss-cn-shanghai","snapshotRegular":"example/example-{Count}.jpg","spriteRegular":"example/example-{TileCount}.jpg","templateId":"******e438b14ff39293eaec25******","tileCount":"1"}]

CateId

integer

L'identifiant de la catégorie.

44

Biz

string

L'activité à laquelle la ressource multimédia appartient.

IMS

UploadSource

string

La source de téléversement.

general

CateName

string

Le nom de la catégorie.

Subcategory 1

ReferenceId

string

L'identifiant personnalisé. Il doit comporter entre 6 et 64 caractères et ne peut contenir que des lettres minuscules, des lettres majuscules, des chiffres, des traits d'union et des traits de soulignement. L'identifiant doit être unique par utilisateur.

123-123

Namespace

string

L'espace de noms.

name-1

VisionDescription

string

La description visuelle.

Soccer goal

StreamStatus

string

L'état du flux.

Active

FileInfoList

array<object>

Les informations sur les fichiers.

array<object>

La liste des informations sur les fichiers.

FileBasicInfo

object

Les informations de base du fichier, y compris la durée et la taille.

FileName

string

Le nom du fichier.

164265080291300080527050.wav

FileStatus

string

L'état du fichier.

Normal

FileType

string

Le type de fichier.

source_file

FileSize

string

La taille du fichier en octets.

324784

FileUrl

string

L'URL OSS du fichier.

https://outin-d3f4681ddfd911ec99a600163e1403e7.oss-cn-shanghai.aliyuncs.com/sv/23d5cdd1-18180984899/23d5cdd1-1818098****.mp4

Region

string

La région de stockage du fichier.

cn-beijing

FormatName

string

Le format de conteneur.

mov,mp4,m4a,3gp,3g2,mj2

Duration

string

La durée.

60.00000

Bitrate

string

Le débit binaire.

1912.13

Width

string

La largeur.

1920

Height

string

La hauteur.

480

CreateTime

string

L'heure de création. L'heure est au format ISO 8601 et utilise le temps UTC (se terminant par Z).

2022-05-30T02:02:17Z

ModifiedTime

string

L'heure de la dernière modification. L'heure est au format ISO 8601 et utilise le temps UTC (se terminant par Z).

2021-12-10T12:19Z

ImagesInput

string

Les informations de l'ensemble d'images.

{}

AiData

object

Les informations détaillées de l'IA.

AiLabelInfo

array<object>

La liste des informations sur les étiquettes IA.

array<object>

Les informations sur l'étiquette IA.

FaceId

string

L'identifiant du visage.

5FE19530C7A422197535FE74F5DB****

LabelType

string

Le type d'étiquette.

Object

Source

string

La source.

vision

Category

string

La catégorie.

Vehicle

LabelName

string

Le nom de l'entité.

Car

LabelId

string

L'identifiant de l'entité.

10310250338

Occurrences

array<object>

La liste des segments.

array<object>

Le segment.

Score

number

Le score.

0.75287705

Image

string

L'encodage Base64 de l'image de visage optimale.

99C64F6287

TableBatchSeqId

string

L'identifiant de séquence de la table vectorielle.

85010D1

clipId

string

L'identifiant du clip.

5FE19530C7A422197535FE74F5DB****

From

number

L'heure de début du segment.

1.4

To

number

L'heure de fin du segment.

2.5

FinegrainName

string

Le nom à granularité fine de l'entité.

Car

FinegrainId

string

L'identifiant à granularité fine de l'entité.

10310250338

Content

string

Le contenu textuel.

Pipi

Tracks

array<object>

La séquence de pistes.

object

La piste.

Size

number

L'aire de la boîte englobante du visage.

50.2

Position

string

Les coordonnées de position de la boîte englobante.

468.0;67.0;615.0;267.0

Timestamp

number

L'horodatage de la piste.

1.4

AsrInfo

array<object>

La liste des informations de parole.

object

Les informations de parole.

From

number

L'heure de début du segment.

1.4

To

number

L'heure de fin du segment.

2.5

ClipId

string

L'identifiant du clip.

5FE19530C7A422197535FE74F5DB****

Content

string

Le contenu textuel.

I am Pipi

Timestamp

number

L'horodatage du segment.

1.4

OcrInfo

array<object>

La liste des informations de sous-titres.

object

Les informations de sous-titres.

From

number

L'heure de début du segment.

1.4

To

number

L'heure de fin du segment.

2.5

ClipId

string

L'identifiant du clip.

5FE19530C7A422197535FE74F5DB****

Content

string

Le contenu textuel.

I am Pipi

Timestamp

number

L'horodatage du segment.

1.4

AiRoughData

object

Les données de résumé IA.

SaveType

string

Le type de sauvegarde.

TEXT

Status

string

L'état des données.

SaveSuccess

AiJobId

string

L'identifiant de la tâche IA.

cd35b0b0025f71edbfcb472190a9****

Result

string

Le résultat de l'IA.

http://xxxx.json

AiCategory

string

La catégorie IA.

Video AI category

IndexStatusList

array<object>

La liste des états d'index.

object

L'état de l'index.

IndexType

string

Le type d'index. Valeurs valides :

  • mm : Grand modèle.

  • face : Visage.

  • aiLabel : Étiquette IA.

mm

IndexStatus

string

L'état de l'index. Valeurs valides :

  • Running : En cours d'exécution.

  • Fail : Échoué.

  • Success : Réussi.

Success

CustomFields

string

Les paramètres de filtre personnalisés.

{\"intField1\":12,\"strField1\":\"abc\"}

ScrollToken

string

Le jeton de pagination.

F8C4F642184DBDA5D93907A70AAE****

Total

integer

Le nombre total de ressources multimédias qui correspondent aux conditions.

163

Exemples

JSON format

{
  "RequestId": "6F61C357-ACC0-57FB-876E-D5879533****",
  "Success": "True",
  "Code": "200",
  "MediaInfoList": [
    {
      "MediaId": "3b187b3620c8490886cfc2a9578c****",
      "MediaBasicInfo": {
        "MediaId": "132bd600fc3c71ec99476732a78f****",
        "InputURL": "oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf8498165024814****",
        "MediaType": "video",
        "BusinessType": "opening",
        "Source": "oss",
        "Title": "Conversion intelligente du format paysage au format portrait",
        "Description": "Vidéo transcodée",
        "Category": "image",
        "MediaTags": "tags,tags2",
        "CoverURL": "https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/e694372e-4f5b-4821-ae09-efd064f2****_large_cover_url.jpg",
        "UserData": "userData",
        "Snapshots": "[{\"bucket\":\"example-bucket\",\"count\":\"3\",\"iceJobId\":\"******f48f0e4154976b2b8c45******\",\"location\":\"oss-cn-beijing\",\"snapshotRegular\":\"example.jpg\",\"templateId\":\"******e6a6440b29eb60bd7c******\"}]",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-01T19:48Z",
        "ModifiedTime": "2020-12-01T19:48Z\n",
        "DeletedTime": "2020-12-01T19:48Z\n",
        "SpriteImages": "[{\"bucket\":\"example-bucket\",\"count\":\"32\",\"iceJobId\":\"******83ec44d58b2069def2e******\",\"location\":\"oss-cn-shanghai\",\"snapshotRegular\":\"example/example-{Count}.jpg\",\"spriteRegular\":\"example/example-{TileCount}.jpg\",\"templateId\":\"******e438b14ff39293eaec25******\",\"tileCount\":\"1\"}]",
        "CateId": 44,
        "Biz": "IMS",
        "UploadSource": "general",
        "CateName": "Sous-catégorie 1",
        "ReferenceId": "123-123",
        "Namespace": "name-1",
        "VisionDescription": "But de football",
        "StreamStatus": "Active"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "164265080291300080527050.wav",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "324784",
            "FileUrl": "https://outin-d3f4681ddfd911ec99a600163e1403e7.oss-cn-shanghai.aliyuncs.com/sv/23d5cdd1-18180984899/23d5cdd1-1818098****.mp4",
            "Region": "cn-beijing",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "60.00000\n",
            "Bitrate": "1912.13\n",
            "Width": "1920",
            "Height": "480",
            "CreateTime": "2022-05-30T02:02:17Z",
            "ModifiedTime": "2021-12-10T12:19Z",
            "ImagesInput": "{}"
          }
        }
      ],
      "AiData": {
        "AiLabelInfo": [
          {
            "FaceId": "5FE19530C7A422197535FE74F5DB****",
            "LabelType": "Object",
            "Source": "vision",
            "Category": "Vehicle",
            "LabelName": "Car",
            "LabelId": "10310250338",
            "Occurrences": [
              {
                "Score": 0.75287705,
                "Image": "99C64F6287",
                "TableBatchSeqId": "85010D1",
                "clipId": "5FE19530C7A422197535FE74F5DB****",
                "From": 1.4,
                "To": 2.5,
                "FinegrainName": "Car",
                "FinegrainId": "10310250338",
                "Content": "Pipi",
                "Tracks": [
                  {
                    "Size": 50.2,
                    "Position": "468.0;67.0;615.0;267.0",
                    "Timestamp": 1.4
                  }
                ]
              }
            ]
          }
        ],
        "AsrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****",
            "Content": "Je suis Pipi",
            "Timestamp": 1.4
          }
        ],
        "OcrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****",
            "Content": "Je suis Pipi",
            "Timestamp": 1.4
          }
        ]
      },
      "AiRoughData": {
        "SaveType": "TEXT",
        "Status": "SaveSuccess",
        "AiJobId": "cd35b0b0025f71edbfcb472190a9****",
        "Result": "http://xxxx.json",
        "AiCategory": "Classification IA vidéo"
      },
      "IndexStatusList": [
        {
          "IndexType": "mm",
          "IndexStatus": "Success"
        }
      ],
      "CustomFields": "{\"intField1\":12,\"strField1\":\"abc\"}"
    }
  ],
  "ScrollToken": "F8C4F642184DBDA5D93907A70AAE****",
  "Total": 163
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.