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