Queries the information about a smart production job.

Usage notes

This operation also returns the processing results of the algorithm specified for the job.

QPS limits

You can call this operation up to 100 times per second. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limit.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes QueryIProductionJob

The operation that you want to perform. Set the value to QueryIProductionJob.

JobId String No 88c6ca184c0e432bbf5b665e2a15****

The ID of the smart production job about which you want to query information. You can obtain the job ID from the response parameters of the SubmitIProductionJob operation.

Response parameters

Parameter Type Example Description
FunctionName String ImageCartoonize

The name of the algorithm that is used for the job. Valid values:

  • VideoH2V: This algorithm transforms a video from the landscape mode to the portrait mode.
  • VideoDelogo: This algorithm removes logos from a video.
  • Cover: This algorithm intelligently generates a cover image for a video.
  • VideoClip: This algorithm intelligently generates a summary for a video.
  • ImageH2V: This algorithm transforms an image from the landscape mode to the portrait mode.
  • ImageDelogo: This algorithm removes logos from an image.
  • CaptionExtraction: This algorithm extracts caption from a video and generates the subtitle file.
  • VideoDetext: This algorithm removes caption from a video.
  • VideoGreenScreenMatting: This algorithm performs green-screen image matting on a video.
  • MusicSegmentDetect: This algorithm detects the chorus of a song.
  • AudioMixing: This algorithm mixes audio streams.
  • VideoSplit: This algorithm segments a PPT video into multiple video clips.
  • AudioBeatDetection: This algorithm detects rhythms.
  • ImageCartoonize: This algorithm converts a two-dimensional media file to a three-dimensional one and stylizes facial images. To use the stylizing feature, contact yuanzhigao1209 on DingTalk.
  • AudioQualityAssessment: This algorithm performs sound quality on audios.
    Note The 16-bit quantized WAV-encoded audio files in mono or binaural mood are supported. Supported audio sampling rate ranges from 8,000 Hz to 48,000 Hz.
Input String oss://example-****.oss-cn-hangzhou.aliyuncs.com/example.mp4

The Object Storage Service (OSS) URL of the input file.

RequestId String D127C68E-F1A1-4CE5-A874-8FF724881A12

The ID of the request.

UserData String null

The returned user business data.

State String Success

The status of the job. Valid values: Valid values:

  • Queuing: The job is waiting in the queue.
  • Analysing: The job is in progress.
  • Fail: The job fails.
  • Success: The job is successful.
Output String oss://example-****.oss-cn-hangzhou.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt

The OSS URL of the output file.

PipelineId String 39f8e0bc005e4f309379701645f4****

The ID of the ApsaraVideo Media Processing (MPS) queue to which the job is submitted.

JobParams String {mode:"gif"}

The returned algorithm-specific parameters.

JobId String 88c6ca184c0e432bbf5b665e2a15****

The ID of the job.

Result String {"Code":"Success","Data":"{\"result\":[{\"file\":\"iproduction/test-result.jpg\"},{\"file\":\"iproduction/test-origin.jpg\"}]}","Message":"Successful."}

The detailed information about the job result. For more information, see Parameters for smart production API operations.

Examples

Sample requests

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryIProductionJob
&JobId=88c6ca184c0e432bbf5b665e2a15****
&<Common request parameters>

Sample success responses

XML format

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

<QueryIProductionJobResponse>
    <FunctionName>ImageCartoonize</FunctionName>
    <Input>oss://example-****.oss-cn-hangzhou.aliyuncs.com/example.mp4</Input>
    <RequestId>D127C68E-F1A1-4CE5-A874-8FF724881A12</RequestId>
    <UserData>null</UserData>
    <State>Success</State>
    <Output>oss://example-****.oss-cn-hangzhou.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt</Output>
    <PipelineId>39f8e0bc005e4f309379701645f4****</PipelineId>
    <JobParams>{mode:"gif"}</JobParams>
    <JobId>88c6ca184c0e432bbf5b665e2a15****</JobId>
    <Result>{"Code":"Success","Data":"{\"result\":[{\"file\":\"iproduction/test-result.jpg\"},{\"file\":\"iproduction/test-origin.jpg\"}]}","Message":"Successful."}</Result>
</QueryIProductionJobResponse>

JSON format

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

{
  "FunctionName" : "ImageCartoonize",
  "Input" : "oss://example-****.oss-cn-hangzhou.aliyuncs.com/example.mp4",
  "RequestId" : "D127C68E-F1A1-4CE5-A874-8FF724881A12",
  "UserData" : "null",
  "State" : "Success",
  "Output" : "oss://example-****.oss-cn-hangzhou.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt",
  "PipelineId" : "39f8e0bc005e4f309379701645f4****",
  "JobParams" : "{mode:\"gif\"}",
  "JobId" : "88c6ca184c0e432bbf5b665e2a15****",
  "Result" : "{\"Code\":\"Success\",\"Data\":\"{\\\"result\\\":[{\\\"file\\\":\\\"iproduction/test-result.jpg\\\"},{\\\"file\\\":\\\"iproduction/test-origin.jpg\\\"}]}\",\"Message\":\"Successful.\"}"
}

Error codes

For a list of error codes, see Service error codes.