SubmitMediaCensorJob - : Central de Documentação do Alibaba Cloud

Observações de uso

Esta operação executa o job em modo assíncrono. O sistema adiciona o job a um pipeline do ApsaraVideo Media Processing (MPS) e, em seguida, o agenda, enfileira e executa. Para obter o resultado, chame a operação QueryMediaCensorJobDetail ou configure uma notificação assíncrona.

Limite de QPS

Você pode chamar esta operação até 100 vezes por segundo por conta. Se a frequência de chamadas exceder esse limite, o sistema acionará o throttling, o que pode afetar seus negócios. Recomendamos observar esse limite ao chamar esta operação. Para mais informações, consulte Limite de QPS.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	SubmitMediaCensorJob	A operação a ser executada. Defina o valor como SubmitMediaCensorJob.
Input	String	Não	null	URL do Object Storage Service (OSS) do arquivo de vídeo ou áudio a moderar. Para visualizar a URL do OSS, faça login no MPS console e escolha Media Management > Media List no painel de navegação à esquerda. Para moderar um arquivo de imagem, use o parâmetro `CoverImage` para especificar a URL do OSS correspondente. O valor é um objeto JSON. Para mais informações, consulte Input. Bucket: nome do bucket do OSS que armazena o arquivo de entrada. Location: região do OSS. Deve ser a mesma região onde o serviço MPS está ativado. Object: objeto do OSS a moderar.
CoverImages	String	Não	[{"Bucket":"example-bucket-**","Location":"oss-cn-shanghai","Object":"example-**.jpeg"}]	URL do OSS do arquivo de imagem usado como miniatura. Para visualizar a URL do OSS, faça login no MPS console e escolha Media Management > Media List no painel de navegação à esquerda. É possível especificar até cinco miniaturas em um array JSON. Bucket: nome do bucket do OSS que armazena o arquivo de entrada. Location: região do OSS. Deve ser a mesma região onde o serviço MPS está ativado. Object: objeto do OSS a moderar.
Title	String	Não	Hello World	Título do vídeo. O tamanho máximo é de 64 bytes.
Description	String	Não	example description	Descrição do vídeo. O tamanho máximo é de 128 bytes.
Barrages	String	Não	hello world	Comentários ao vivo.
PipelineId	String	Sim	b22c173cced04565b1f38f1ecc39****	ID da fila do MPS. Use este ID para associar o job a um método de notificação. Para visualizar o ID da fila, faça login no MPS console e escolha Global Settings > Pipelines no painel de navegação à esquerda. Uma string vazia ("") indica o uso da fila padrão do MPS para executar o job. Por padrão, uma fila do MPS processa no máximo 10 jobs de moderação de conteúdo simultâneos. Para aumentar esse limite, envie um ticket. Nota O sistema cria as filas do MPS automaticamente. Para mais informações sobre como consultar e atualizar filas do MPS, consulte UpdatePipeline.
VideoCensorConfig	String	Sim	null	Configurações de moderação de vídeo e URLs do OSS dos snapshots de saída. Para visualizar as URLs do OSS dos snapshots de saída, faça login no MPS console e escolha Media Management > Media List no painel de navegação à esquerda. O valor é um objeto JSON. OutputFile: Bucket: nome do bucket do OSS que armazena os snapshots de saída. Location: região do OSS. Deve ser a mesma região onde o serviço MPS está ativado. Object: objeto do OSS a gerar. No valor, {Count} indica o número sequencial do snapshot de quadro. StoreVideoTimeline: especifica se deve gerar o arquivo `{jobId}.video_timeline`, armazenado no OSS. O valor true gera o arquivo; false não o gera. Se omitido, o sistema não gera o arquivo por padrão. Para mais informações sobre o formato, consulte o exemplo de arquivo {jobId}.video_timeline em QueryMediaCensorJobDetail. SaveType: modo de saída. O valor abnormal gera snapshots apenas para quadros ilegais. O valor all gera snapshots para todos os quadros. Biztype: modelo de moderação. Se omitido ou definido como common, o sistema usa o modelo padrão. Envie um ticket para criar um modelo personalizado e defina este parâmetro com seu ID de usuário para utilizá-lo. Scenes: cenários de moderação. Especifique os cenários desejados. Se omitido, o sistema usa os cenários de terrorismo e pornografia por padrão. Valores válidos: porn: detecção de conteúdo pornográfico terrorism: detecção de conteúdo terrorista ad: detecção de violação de anúncios live: detecção de cenas indesejáveis logo: detecção de logotipos específicos audio: anti-spam de áudio Nota Se o arquivo de entrada contiver faixas de áudio e você especificar o cenário de moderação de áudio, o sistema moderará essas faixas. Caso contrário, não é necessário especificar o cenário de áudio.
UserData	String	Não	UserDatatestid-001-****	Dados personalizados. O tamanho máximo é de 128 bytes.
ExternalUrl	String	Não	http://www.example.com/video-**/test-**.mp4	URL do vídeo.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	25818875-5F78-4A13-BEF6-D7393642CA58	ID da solicitação.
JobId	String	88c6ca184c0e47098a5b665e2****	ID do job de moderação de conteúdo. Recomendamos guardar este ID para chamadas de operações subsequentes.

Parâmetros de notificação assíncrona

Parâmetro	Tipo	Descrição
Type	String	Tipo da mensagem. O valor é MediaCensor.
MediaCensorJobNotify	AliyunMediaCensorJobNotify	Conteúdo da notificação do job de moderação de conteúdo.
UserData	String	Dados personalizados.

Exemplos

Exemplos de solicitações

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=SubmitMediaCensorJob
&Input={"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"}
&CoverImages=[{"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.jpeg"}]
&Title=Hello World
&Description=example description
&Barrages=hello world
&PipelineId=b22c173cced04565b1f38f1ecc39****
&VideoCensorConfig={"Scenes" : ["porn"], "OutputFile":{"Bucket": "example-001","Location": "oss-cn-hangzhou","Object": "test/example-{Count}.jpg"},"SaveType" : "abnormal","BizType":"common"}
&UserData=UserDatatestid-001-****
&ExternalUrl=http://www.example.com/video-****/test-****.mp4
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<SubmitMediaCensorJobResponse>
    <RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
    <JobId>88c6ca184c0e47098a5b665e2****</JobId>
</SubmitMediaCensorJobResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "25818875-5F78-4A13-BEF6-D7393642CA58",
  "JobId" : "88c6ca184c0e47098a5b665e2****"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.