Todos os produtos
Search
Central de documentação

:SubmitIProductionJob

Última atualização: Jun 27, 2026

Envia um job de produção inteligente.

Observações de uso

Os jobs enviados por esta operação são executados de forma assíncrona. Após a adição do job à fila do ApsaraVideo Media Processing (MPS), o sistema o agenda para execução. Para consultar o resultado, chame a operação QueryIProductionJob ou configure um callback.

Limites de QPS

Esta operação aceita até 100 chamadas por segundo. Se o volume de chamadas ultrapassar esse limite, ocorre throttling, o que pode afetar seu negócio. 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 SubmitIProductionJob

A operação a ser executada. Defina o valor como SubmitIProductionJob.

FunctionName String Sim ImageCartoonize

Nome do algoritmo a ser usado no job. Valores válidos:

  • VideoH2V: Transforma um vídeo do modo paisagem para o modo retrato.
  • VideoDelogo: Remove logotipos de um vídeo.
  • Cover: Gera inteligentemente uma imagem de capa para um vídeo.
  • VideoClip: Cria automaticamente um resumo em vídeo.
  • ImageMatting: Recorta uma figura de uma imagem.
  • ImageH2V: Converte uma imagem do modo paisagem para o modo retrato.
  • ImageDelogo: Elimina logotipos presentes em uma imagem.
  • CaptionExtraction: Extrai legendas de um vídeo e gera o arquivo de legenda correspondente. Especifique a URL do vídeo a ser processado.
  • VideoDetext: Remove legendas embutidas em um vídeo.
  • VideoGreenScreenMatting: Aplica recorte de tela verde em um vídeo e produz um novo arquivo. Requer a URL do vídeo original e a URL da imagem que substituirá o fundo.
  • MusicSegmentDetect: Identifica os refrões de uma música. Ao fornecer a URL do vídeo ou áudio, o sistema retorna os horários de início e fim de cada refrão. Caso não haja refrão, o parâmetro retornado estará vazio.
  • AudioMixing: Mixa fluxos de áudio.
  • VideoSplit :Segmenta um vídeo de PPT em vários clipes.
  • AudioBeatDetection: Detecta ritmos musicais. Após indicar a URL do vídeo ou áudio, são retornados os parâmetros BeatList e DownBeatList.
  • ASR: Executa reconhecimento automático de fala.
  • AsyncTextToSpeech: Converte texto em fala de maneira assíncrona.
  • TextToSpeech: Transforma texto em áudio falado.
  • ImageCartoonize :Converte arquivos de mídia bidimensionais em tridimensionais e estiliza imagens faciais. Para utilizar o recurso de estilização, entre em contato com yuanzhigao1209 no DingTalk.
ModelId String Não null

ID do modelo de algoritmo. Recomendamos não especificar este parâmetro; assim, o sistema utilizará o modelo padrão associado ao algoritmo escolhido.

JobParams String Sim null

Parâmetros específicos do algoritmo necessários para enviar o job de produção inteligente. Devem ser definidos como objetos JSON e variam conforme o algoritmo selecionado. Para mais detalhes, consulte Parâmetros específicos de algoritmo para job de produção inteligente.

ScheduleParams String Não null

Parâmetros para configuração do agendamento do job. Sugerimos deixar o parâmetro ScheduleParams vazio.

NotifyUrl String Não mns://125340688170****.oss-cn-shanghai.aliyuncs.com/queues/example-pipeline

URL de callback. Apenas URLs de filas do Message Service (MNS) são suportadas. Para visualizar a URL, faça login no MNS console, clique em Queues no painel de navegação à esquerda, localize a fila MNS desejada e clique em Details na coluna Actions.

UserData String Não null

Dados personalizados do usuário que serão retornados na URL de callback. Recomendamos manter este parâmetro vazio.

PipelineId String Sim 39f8e0bc005e4f309379701645f4****

ID da fila MPS onde o job de produção inteligente será enviado. Para obter o ID, acesse o MPS console e selecione Global Settings > Pipelines no painel de navegação à esquerda. É possível vincular uma fila MNS à fila MPS para receber callbacks do job. Jobs de diferentes locatários podem ser direcionados a filas MPS distintas, garantindo isolamento de dados multi-locatário. Se este parâmetro não for especificado, o job será submetido à fila MPS padrão. Por padrão, uma fila MPS processa no máximo 10 jobs simultâneos e não possui tópico MNS vinculado.

Input String Não oss://example-****.oss-cn-shanghai.aliyuncs.com/example.mp4

URL do arquivo de entrada. Somente URLs do Object Storage Service (OSS) são aceitas. Para obter a URL, acesse o MPS console e vá em Media Management > Media List no painel de navegação à esquerda. Também é possível verificar a URL diretamente no console do OSS.

Output String Não oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt

URL do arquivo de saída. Apenas URLs do OSS são suportadas. Obtenha a URL acessando o MPS console e navegando até Media Management > Media List no painel de navegação à esquerda, ou consulte o console do OSS.

Nota A URL deve seguir o formato oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt. Os campos {source}, {timestamp} e {sequenceId} são placeholders substituíveis, respectivamente, por nome de arquivo, timestamp UNIX e número sequencial. Embora opcionais, o campo {sequenceId} torna-se obrigatório em algoritmos que podem gerar múltiplos resultados (como smart cover), evitando duplicidade nas URLs de saída. A extensão do arquivo pode ser personalizada.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

5210DBB0-E327-4D45-ADBC-0B83C8796E26

ID da solicitação.

JobId

String

39f8e0bc005e4f309379701645f4****

ID do job. Recomendamos armazenar este identificador para uso em chamadas de operações subsequentes.

Result

String

null

Resultados retornados. O conteúdo varia conforme o algoritmo utilizado. Para mais informações, consulte Parâmetros específicos de algoritmo para job de produção inteligente.

Exemplos

Exemplos de solicitações

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=SubmitIProductionJob
&FunctionName=ImageCartoonize
&ModelId=null
&JobParams={mode:"gif"}
&ScheduleParams=null
&NotifyUrl=mns://125340688170****.oss-cn-shanghai.aliyuncs.com/queues/example-pipeline
&UserData=null
&PipelineId=39f8e0bc005e4f309379701645f4****
&Input=oss://example-****.oss-cn-shanghai.aliyuncs.com/example.mp4
&Output=oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<SubmitIProductionJobResponse>
    <RequestId>5210DBB0-E327-4D45-ADBC-0B83C8796E26</RequestId>
    <JobId>39f8e0bc005e4f309379701645f4****</JobId>
    <Result>{ "Code":"Success", "Details":[], "FunctionName":"ImageCartoonize", "JobId":"39f8e0bc005e4f309379701645f4****", "Message":"success", "State":"Success", "Type":"IProduction" }</Result>
</SubmitIProductionJobResponse>

Formato JSON

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

{
  "RequestId" : "5210DBB0-E327-4D45-ADBC-0B83C8796E26",
  "JobId" : "39f8e0bc005e4f309379701645f4****",
  "Result" : "{ \"Code\":\"Success\", \"Details\":[], \"FunctionName\":\"ImageCartoonize\", \"JobId\":\"39f8e0bc005e4f309379701645f4****\", \"Message\":\"success\", \"State\":\"Success\", \"Type\":\"IProduction\" }"
}

Códigos de erro

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