SearchMedia - Intelligent Media Services: Central de Documentação do Alibaba Cloud

Retorna informações de ativos de mídia que correspondem às condições de filtro especificadas.

Descrição da operação

Para usar o recurso de pesquisa multimodal do Alibaba Cloud Intelligent Media Services ou para consultar sobre questões relacionadas, pesquise pelo grupo do DingTalk (30415005038) e entre no grupo de suporte ao cliente de pesquisa multimodal do Intelligent Media Services para entrar em contato conosco.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ice:SearchMedia

get

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Match	string	Não	A condição de filtro.	Title = 'China' and utcCreate = ['1693367158561','1693367158562']
SortBy	string	Não	Os campos de ordenação e as ordens de classificação, separados por vírgulas (,).	utcCreate:Desc
PageNo	integer	Não	O número da página atual. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página. Valor padrão: 10. Valor máximo: 50.	20
EntityId	string	Não	O ID da entidade.	2d3bf1e35a1e42b5ab338d701efa****
ScrollToken	string	Não	O token de paginação. Este é um campo de 32 caracteres. Você não precisa definir este parâmetro na primeira solicitação de pesquisa. Quando a solicitação de pesquisa corresponde a dados, o servidor retorna este valor de parâmetro para registrar a posição atual dos dados de pesquisa. Registre o valor do parâmetro retornado e defina este parâmetro na próxima solicitação de pesquisa de acordo com os seguintes requisitos ou sugestões: este parâmetro deve ser definido quando você precisar percorrer todos os dados que correspondem às condições de pesquisa. Quando o valor do parâmetro PageNo exceder 200, defina este parâmetro para otimizar o desempenho da pesquisa. Você só pode paginar para frente, e a distância máxima de paginação é de 1000 ativos de mídia.	F8C4F642184DBDA5D93907A70AAE****
SearchLibName	string	Não	A biblioteca de pesquisa.	test-1
CustomFilters	string	Não	O filtro personalizado. Esta é uma string JSON. Os campos suportados incluem o campo inteiro intField1 e os campos de string strField1 e strField2. Cada campo suporta apenas um tipo de correspondência. Filtros em campos diferentes são combinados com uma relação AND.	{"intField1":{"gte":12,"lte":13},"strField2":["cd","de"],"strField1":"abc"}

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	6F61C357-ACC0-57FB-876E-D5879533****
Success	string	Indica se a solicitação foi bem-sucedida.	True
Code	string	O código de retorno.	200
MediaInfoList	array<object>	A coleção de ativos de mídia que atendem aos critérios especificados.
	array<object>	A lista de informações de ativos de mídia.
MediaId	string	O ID do ativo de mídia.	3b187b3620c8490886cfc2a9578c****
MediaBasicInfo	object	As informações básicas do ativo de mídia.
MediaId	string	O ID do ativo de mídia.	132bd600fc3c71ec99476732a78f****
InputURL	string	A URL de origem do ativo de mídia.	oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf8498165024814****
MediaType	string	O tipo do ativo de mídia.	video
BusinessType	string	O tipo de negócio do ativo de mídia.	opening
Source	string	A origem do ativo de mídia.	oss
Title	string	O título do ativo de mídia.	Smart landscape-to-portrait conversion
Description	string	A descrição do ativo de mídia.	对这个视频进行转码处理了
Category	string	A categoria do ativo de mídia.	image
MediaTags	string	As tags atribuídas ao ativo de mídia. Várias tags são separadas por vírgulas.	tags,tags2
CoverURL	string	A URL da imagem de capa.	https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/e694372e-4f5b-4821-ae09-efd064f2****_large_cover_url.jpg
UserData	string	Os dados personalizados do usuário.	userData
Snapshots	string	Informações de snapshot no formato JSON.	[{"bucket":"example-bucket","count":"3","iceJobId":"****f48f0e4154976b2b8c45**","location":"oss-cn-beijing","snapshotRegular":"example.jpg","templateId":"**e6a6440b29eb60bd7c****"}]
Status	string	O status do ativo de mídia.	Normal
TranscodeStatus	string	O status de transcodificação do ativo de mídia.	Init
CreateTime	string	A hora em que o ativo de mídia foi criado.	2020-12-01T19:48Z
ModifiedTime	string	A hora em que o ativo de mídia foi modificado pela última vez.	2020-12-01T19:48Z
DeletedTime	string	A hora em que o ativo de mídia foi excluído.	2020-12-01T19:48Z
SpriteImages	string	Informações de imagem sprite no formato JSON.	[{"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	O ID da categoria.	44
Biz	string	O negócio ao qual o ativo de mídia pertence.	IMS
UploadSource	string	A origem do upload.	general
CateName	string	O nome da categoria.	Subcategory 1
ReferenceId	string	Um ID personalizado e exclusivo para o usuário. Deve ter de 6 a 64 caracteres e pode conter letras, dígitos, hifens (-) e sublinhados (_).	123-123
Namespace	string	O namespace.	name-1
VisionDescription	string	Uma descrição do conteúdo de mídia gerada por visão computacional.	足球进球
StreamStatus	string	O status do stream.	Active
FileInfoList	array<object>	FileInfos.
	array<object>	A lista de informações de arquivos.
FileBasicInfo	object	Informações básicas sobre o arquivo, como sua duração e tamanho.
FileName	string	O nome do arquivo.	164265080291300080527050.wav
FileStatus	string	O status do arquivo.	Normal
FileType	string	O tipo do arquivo.	source_file
FileSize	string	O tamanho do arquivo em bytes.	324784
FileUrl	string	A URL do Object Storage Service (OSS) do arquivo.	https://outin-d3f4681ddfd911ec99a600163e1403e7.oss-cn-shanghai.aliyuncs.com/sv/23d5cdd1-18180984899/23d5cdd1-1818098****.mp4
Region	string	A região onde o arquivo está armazenado.	cn-beijing
FormatName	string	O formato de contêiner do arquivo.	mov,mp4,m4a,3gp,3g2,mj2
Duration	string	A duração do arquivo.	60.00000
Bitrate	string	A taxa de bits do arquivo.	1912.13
Width	string	A largura do vídeo em pixels.	1920
Height	string	A altura do vídeo em pixels.	480
CreateTime	string	A hora em que o arquivo foi criado.	2022-05-30T02:02:17Z
ModifiedTime	string	A hora em que o arquivo foi modificado pela última vez.	2021-12-10T12:19Z
ImagesInput	string	Informações sobre o conjunto de imagens.	{}
AiData	object	Os detalhes da IA.
AiLabelInfo	array<object>	Uma lista de informações de rótulos de IA.
	array<object>	Um objeto de rótulo de IA.
FaceId	string	O ID do rosto reconhecido.	5FE19530C7A422197535FE74F5DB****
LabelType	string	O tipo do rótulo.	Object
Source	string	A origem dos dados de IA.	vision
Category	string	A categoria do rótulo.	Vehicle
LabelName	string	O nome da entidade.	Car
LabelId	string	O ID da entidade.	10310250338
Occurrences	array<object>	Uma lista de clipes onde a entidade aparece.
	array<object>	Um objeto de clipe.
Score	number	A pontuação de confiança para o resultado do reconhecimento.	0.75287705
Image	string	A imagem ideal do rosto reconhecido, codificada em Base64.	99C64F6287
TableBatchSeqId	string	O ID de sequência da tabela de vetores.	85010D1
clipId	string	O ID do clipe.	5FE19530C7A422197535FE74F5DB****
From	number	A hora de início do clipe.	1.4
To	number	A hora de término do clipe.	2.5
FinegrainName	string	O nome de granularidade fina da entidade.	Car
FinegrainId	string	O ID de granularidade fina da entidade.	10310250338
Content	string	O conteúdo de texto.	Pipi
Tracks	array<object>	Uma sequência de trilhas que representam a entidade dentro do clipe.
	object	Um ponto de dados da trilha.
Size	number	O tamanho da caixa delimitadora.	50.2
Position	string	As coordenadas da caixa delimitadora.	468.0;67.0;615.0;267.0
Timestamp	number	O carimbo de data e hora do ponto de dados da trilha.	1.4
AsrInfo	array<object>	Uma lista de resultados de Reconhecimento Automático de Fala (ASR).
	object	Um objeto de resultado de ASR.
From	number	A hora de início do clipe.	1.4
To	number	A hora de término do clipe.	2.5
ClipId	string	O ID do clipe.	5FE19530C7A422197535FE74F5DB****
Content	string	O conteúdo de texto transcrito.	I am Pipi.
Timestamp	number	O carimbo de data e hora do clipe.	1.4
OcrInfo	array<object>	Uma lista de resultados de Reconhecimento Óptico de Caracteres (OCR).
	object	Um objeto de resultado de OCR.
From	number	A hora de início do clipe.	1.4
To	number	A hora de término do clipe.	2.5
ClipId	string	O ID do clipe.	5FE19530C7A422197535FE74F5DB****
Content	string	O conteúdo de texto reconhecido.	我是皮皮
Timestamp	number	O carimbo de data e hora do clipe.	1.4
AiRoughData	object	Os dados resumidos da IA.
SaveType	string	O tipo de salvamento dos dados de IA.	TEXT
Status	string	O status de salvamento dos dados de IA.	SaveSuccess
AiJobId	string	O ID do job de IA.	cd35b0b0025f71edbfcb472190a9****
Result	string	A URL do arquivo de resultado bruto de IA.	http://xxxx.json
AiCategory	string	A categoria de IA aplicada ao ativo de mídia.	视频AI分类
IndexStatusList	array<object>	A lista de status de índice.
	object	O status do índice.
IndexType	string	O tipo do índice. Valores válidos: `mm`: Modelo de linguagem grande (LLM). `face`: Rosto. `aiLabel`: Marcação inteligente.	mm
IndexStatus	string	O status do índice. Valores válidos: `Running`: O índice está sendo criado. `Fail`: A criação do índice falhou. `Success`: O índice foi criado.	Success
CustomFields	string	Os parâmetros de filtro personalizados.	{\"intField1\":12,\"strField1\":\"abc\"}
ScrollToken	string	O token de paginação.	F8C4F642184DBDA5D93907A70AAE****
Total	integer	O número total de ativos de mídia que atendem às condições especificadas.	163

Exemplos

Resposta de sucesso

JSON formato

{
  "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": "Smart landscape-to-portrait conversion",
        "Description": "对这个视频进行转码处理了",
        "Category": "image",
        "MediaTags": "tags,tags2\n",
        "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": "Subcategory 1",
        "ReferenceId": "123-123",
        "Namespace": "name-1",
        "VisionDescription": "足球进球",
        "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": "I am Pipi.",
            "Timestamp": 1.4
          }
        ],
        "OcrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****",
            "Content": "我是皮皮",
            "Timestamp": 1.4
          }
        ]
      },
      "AiRoughData": {
        "SaveType": "TEXT",
        "Status": "SaveSuccess",
        "AiJobId": "cd35b0b0025f71edbfcb472190a9****",
        "Result": "http://xxxx.json",
        "AiCategory": "视频AI分类"
      },
      "IndexStatusList": [
        {
          "IndexType": "mm",
          "IndexStatus": "Success"
        }
      ],
      "CustomFields": "{\\\"intField1\\\":12,\\\"strField1\\\":\\\"abc\\\"}"
    }
  ],
  "ScrollToken": "F8C4F642184DBDA5D93907A70AAE****",
  "Total": 163
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.