GetAIVideoTagResult - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

Obtém os resultados de marcação inteligente para um vídeo.

Descrição da operação

Atualmente, esta operação é suportada nas seguintes regiões: China (Pequim) e China (Xangai).
Obtém os resultados de marcação inteligente por ID do vídeo.

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

vod:GetAIVideoTagResult

get

*全部资源

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
MediaId	string	Sim	O ID do recurso de mídia, que corresponde ao ID do vídeo. Você pode obter o ID do vídeo usando os seguintes métodos: Para vídeos enviados por meio do console, faça login no console do ApsaraVideo VOD e escolha Arquivos de mídia > Áudio/Vídeo para visualizar o ID do vídeo. Ao chamar a operação CreateUploadVideo para obter a URL e a credencial de upload, o ID do vídeo é o valor do parâmetro VideoId na resposta. Após o upload do vídeo, chame a operação SearchMedia para consultar o ID do vídeo. O ID do vídeo é o valor do parâmetro VideoId na resposta.	595d020bad37421f37433451720****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros da resposta.
RequestId	string	O ID da solicitação.	8829B4DB-AFD9-4FF6-12965DBFFA14****
VideoTagResult	object	Os dados do resultado.
Category	array<object>	A coleção de categorias de vídeo.
	object	Os detalhes da categoria de vídeo.
Tag	string	A string da tag.	Beauty
Person	array<object>	A coleção de tags de pessoa.
	object	Os detalhes da tag de pessoa.
FaceUrl	string	A URL da imagem do rosto. Nota Este parâmetro é retornado apenas quando uma tag de pessoa é usada.	http://example.com/aivideotag/8829B4DB-AFD9-4F***F6-12965DBFFA14/Index_**.jpg
Tag	string	A string da tag.	Xiao Wang
Times	array	Os pontos no tempo em que as tags são exibidas. Unidade: milissegundos.
	string	O ponto no tempo em que a tag de pessoa é exibida. Unidade: milissegundos.	["10760"]
Time	array<object>	A coleção de tags de tempo.
	object	Os detalhes da tag de tempo.
Tag	string	A string da tag.	Millisecond
Times	array	Os pontos no tempo em que as tags são exibidas. Unidade: milissegundos.
	string	O ponto no tempo em que a tag de tempo é exibida. Unidade: milissegundos.	["3260","4000","5000","8410","12000","13000","14000"]
Location	array<object>	A coleção de tags de localização.
	object	Os detalhes da tag de localização.
Tag	string	A string da tag.	Asia
Times	array	Os pontos no tempo em que as tags são exibidas. Unidade: milissegundos.
	string	O ponto no tempo em que a tag de localização é exibida. Unidade: milissegundos.	["8410"]
Keyword	array<object>	A coleção de tags de palavra-chave.
	object	Os detalhes da tag de palavra-chave.
Tag	string	A string da tag.	Cushion
Times	array	Os pontos no tempo em que as tags são exibidas. Unidade: milissegundos.
	string	O ponto no tempo em que a tag de palavra-chave é exibida. Unidade: milissegundos.	["3260","4000","5000","8410","12000","13000","14000"]

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "8829B4DB-AFD9-4FF6-12965DBFFA14****",
  "VideoTagResult": {
    "Category": [
      {
        "Tag": "Beauty"
      }
    ],
    "Person": [
      {
        "FaceUrl": "http://example.com/aivideotag/8829B4DB-AFD9-4F*****F6-12965DBFFA14/Index_****.jpg",
        "Tag": "Xiao Wang",
        "Times": [
          "[\"10760\"]"
        ]
      }
    ],
    "Time": [
      {
        "Tag": "Millisecond",
        "Times": [
          "[\"3260\",\"4000\",\"5000\",\"8410\",\"12000\",\"13000\",\"14000\"]"
        ]
      }
    ],
    "Location": [
      {
        "Tag": "Asia",
        "Times": [
          "[\"8410\"]"
        ]
      }
    ],
    "Keyword": [
      {
        "Tag": "Cushion",
        "Times": [
          "[\"3260\",\"4000\",\"5000\",\"8410\",\"12000\",\"13000\",\"14000\"]"
        ]
      }
    ]
  }
}

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.