Todos os produtos
Search

Este produto

    Intelligent Media Services:SubmitSmarttagJob

    Central de documentação

    Intelligent Media Services:SubmitSmarttagJob

    Última atualização: Jun 29, 2026

    Envia um job de smart tagging.

    Descrição da operação

    Pré-requisitos

    Antes de enviar um job de smart tagging, você deve configurar os tipos de análise em um modelo. Para mais informações, consulte CreateCustomTemplate.

    Limitações

    • O recurso de smart tagging está disponível apenas nas regiões China (Pequim), China (Xangai) e China (Hangzhou).

    • A simultaneidade padrão para o pipeline de smart tagging é 2. Para solicitar um limite de simultaneidade maior, abra um ticket.

    • Os jobs de smart tagging e seus resultados são retidos por 180 dias, após os quais são excluídos automaticamente.

    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:SubmitSmarttagJob

    create

    *All Resource

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    Title

    string

    Não

    O título do vídeo pode conter caracteres chineses, letras do alfabeto inglês, dígitos e hifens (-). Não pode começar com um caractere especial e não deve exceder 256 bytes.

    example-title-****

    Content

    string

    Não

    A descrição do conteúdo do vídeo pode conter caracteres chineses, letras do alfabeto inglês, dígitos e hifens (-). Não pode começar com um caractere especial e não deve exceder 1 KB.

    example content ****

    ContentType

    string

    Não

    Obsoleto.

    ContentAddr

    string

    Não

    Obsoleto.

    Params

    string

    Não

    Parâmetros de solicitação adicionais, especificados como uma string JSON. Por exemplo: {"needAsrData":true, "needOcrData":false}.

    • needAsrData: Especifica se os resultados brutos do Reconhecimento Automático de Fala (ASR) devem ser incluídos na saída da análise. O padrão é false.

    • needOcrData: Especifica se os resultados brutos do Reconhecimento Óptico de Caracteres (OCR) devem ser incluídos na saída da análise. O padrão é false.

    • needMetaData: Especifica se os metadados devem ser incluídos na saída da análise. O padrão é false.

    • nlpParams: Um objeto JSON que especifica os parâmetros de entrada para o operador de Processamento de Linguagem Natural (NLP). Se deixado vazio, o operador não é usado. Para obter detalhes, consulte a tabela nlpParams abaixo.

    {"needAsrData":true, "needOcrData":false, "nlpParams":{"sourceLanguage":"cn"}}

    NotifyUrl

    string

    Não

    A URL de callback. Apenas URLs HTTP e HTTPS são suportadas.

    https://example.com/endpoint/aliyun/ai?id=76401125000***
    UserData

    string

    Não

    Dados personalizados a serem incluídos no callback. Se você usar o Message Service (MNS) para callbacks, esses dados serão incluídos na mensagem. O comprimento máximo é de 1 KB.

    {“a”:"test"}
    Input

    object

    Não

    O arquivo de entrada para o job.

    Type

    string

    Não

    O tipo do arquivo de mídia de entrada. Valores válidos:

    • OSS

    • Media

    • URL

    Media
    Media

    string

    Não

    • Se você definir o parâmetro Type como OSS, especifique a URL do OSS do arquivo de mídia. Exemplo: OSS://test-bucket/video/202208/test.mp4.

    • Se você definir o parâmetro Type como Media, especifique o ID da mídia. Exemplo: c5c62d8f0361337cab312dce8e77dc6d.

    • Se você definir o parâmetro Type como URL, especifique a URL HTTP ou HTTPS do arquivo de mídia. Exemplo: https://zc-test.oss-cn-shanghai.aliyuncs.com/test/unknowFace.mp4.

    c5c62d8f0361337cab312dce8e77dc6d
    TemplateId

    string

    Não

    O ID do modelo que especifica os algoritmos de análise a serem usados.

    39f8e0bc005e4f309379701645f4

    ScheduleConfig

    object

    Não

    As configurações de agendamento.

    PipelineId

    string

    Não

    O ID do pipeline. Os pipelines separam as cargas de trabalho de negócios e vinculam notificações de mensagens.

    Se você não especificar este parâmetro, o pipeline padrão será usado. O pipeline padrão tem uma simultaneidade de 2. Para aumentar a simultaneidade, abra um ticket.

    acdbfe4323bcfdae
    Priority

    string

    Não

    A prioridade do job. Este recurso ainda não foi implementado. Você pode deixar este parâmetro vazio ou especificar qualquer valor.

    4
    TemplateConfig

    string

    Não

    Parâmetros dinâmicos para o job, que substituem ou complementam temporariamente o modelo base especificado por TemplateId. O serviço mescla os parâmetros dinâmicos e do modelo para gerar a configuração final do job atual e a valida antes da execução.

    • Regras de mesclagem:

    1. Os valores na solicitação substituem os valores correspondentes no modelo.

    2. Os campos na solicitação que não existem no modelo são adicionados à configuração.

    • Campos dinâmicos suportados atualmente:

    1. FaceCategoryIds: Uma lista de IDs de biblioteca de rostos para reconhecimento, separados por vírgulas (,). Você pode incluir IDs de bibliotecas do sistema e personalizadas.

    • Nota: Esses parâmetros dinâmicos afetam apenas o job atual e não modificam o modelo em si.

    {"FaceCategoryIds":"custom_face_lib1"}

    nlpParams

    RecursoParâmetroTipoObrigatórioDescriçãoExemplo
    nlpParamsobjectSimContém todos os parâmetros relacionados ao processamento de NLP. Este parâmetro é obrigatório se os tipos de análise no modelo incluírem NLP. Caso contrário, o job falhará.{"sourceLanguage":"cn"}
    TranscriçãosourceLanguagestringSimO modelo de idioma de origem para transcrição. Valores válidos: cn (chinês), en (inglês), yue (cantonês), fspk (mistura de chinês e inglês) e ja (japonês). Se o áudio contiver vários idiomas, você pode definir este parâmetro como multilingual para reconhecer texto em cada idioma. Use este parâmetro com languageHints. Apenas áudio de 16 kHz é suportado."cn"
    languageHintslist[string]NãoEspecifica os idiomas a serem reconhecidos quando sourceLanguage é definido como multilingual. Valores válidos (vários podem ser selecionados): cn (chinês), en (inglês), yue (cantonês), ja (japonês), ko (coreano), de (alemão), fr (francês) e ru (russo). Este parâmetro restringe o escopo da detecção de idioma e evita a identificação incorreta de idiomas irrelevantes. Ele entra em vigor apenas quando sourceLanguage é definido como multilingual.['cn', 'en', 'yue']
    transcriptionModelstringNãoEspecifica o modelo de transcrição a ser usado. Valor válido: fun-asr. Este modelo deve ser usado com sourceLanguage definido como multilingual.fun-asr
    diarizationEnabledbooleanNãoEspecifica se a diarização de falantes deve ser ativada. O padrão é false.true
    speakerCountintegerNãoConfigura a contagem de falantes para a diarização de falantes. 0: O número de falantes é detectado automaticamente. 2: Diariza o áudio para dois falantes.2
    HotwordphraseIdstringNãoO ID do vocabulário de hotwords.ce9c2a34b6d847bf92a77d0a196f***
    Extração e resumo de PPTpptExtractionEnabledbooleanNãoEspecifica se a extração e o resumo de PPT devem ser ativados. Se ativado, o serviço extrai slides de PPT do vídeo e gera um resumo. O padrão é false.true
    ResumosummarizationEnabledbooleanNãoEspecifica se o resumo deve ser ativado. Se ativado, o serviço pode gerar um resumo de texto completo, resumo de falante e outros resultados.true
    summarizationTypesstringNãoQuando o resumo está ativado, você deve especificar os tipos de resumo desejados. Valores válidos: Paragraph (resumo de texto completo), Conversational (resumo de falante), QuestionsAnswering (resumo de perguntas e respostas) e MindMap (mapa mental)."Paragraph,Conversational,QuestionsAnswering,MindMap"
    TraduçãotranslationEnabledbooleanNãoEspecifica se a tradução deve ser ativada.true
    targetLanguagesstringNãoOs idiomas de destino para tradução. Este parâmetro é obrigatório se a tradução estiver ativada. Valores válidos: cn (chinês), en (inglês), yue (cantonês) e fspk (mistura de chinês e inglês)."en,cn"
    Detecção de capítulosautoChaptersEnabledbooleanNãoEspecifica se a geração automática de capítulos deve ser ativada. A saída inclui títulos e resumos de capítulos.true
    Assistência de reuniãomeetingAssistanceEnabledbooleanNãoEspecifica se o recurso de assistência de reunião deve ser ativado. A saída inclui categorias, palavras-chave, frases-chave e itens de ação.true

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    RequestId

    string

    O ID da solicitação.

    ******11-DB8D-4A9A-875B-275798******
    JobId

    string

    O ID do job de smart tagging. Salve este ID para chamadas de API subsequentes.

    ****d80e4e4044975745c14b****

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "JobId": "****d80e4e4044975745c14b****"
}

    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.