:SubmitAnalysisJob

Observações de uso

• Ao chamar a operação SubmitAnalysisJob para enviar um job de análise de modelo predefinido, o ApsaraVideo Media Processing (MPS) analisa inteligentemente o arquivo de entrada e recomenda um modelo predefinido adequado. Chame a operação QueryAnalysisJobList para consultar o resultado da análise ou ative notificações assíncronas para recebê-lo.

• O resultado da análise permanece disponível por apenas duas semanas após a geração. Após esse período, ele é excluído. Se você utilizar o modelo predefinido recomendado em um job de transcodificação depois de duas semanas, o job falhará e retornará o código de erro AnalysisResultNotFound.

Limite de QPS

Você pode chamar esta operação até 100 vezes por segundo por conta. Se a frequência de chamadas exceder o limite, o throttling será acionado, 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âmetros de resposta

Exemplos

Exemplos de solicitações

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=SubmitAnalysisJob
&Input={"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.flv"}
&AnalysisConfig={"QualityControl":{"RateQuality":25,"MethodStreaming":"network"}}
&UserData=testid-001
&PipelineId=bb558c1cc25b45309aab5be44d19****
&Priority=10
&<Common request parameters>

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

<SubmitAnalysisJobResponse>
    <RequestId>B52658D4-07AB-43CD-82B0-210958A65E23</RequestId>
    <AnalysisJob>
        <CreationTime>2014-01-10T12:00:00Z</CreationTime>
        <Percent>100</Percent>
        <State>Success</State>
        <AnalysisConfig>
            <QualityControl>
                <MethodStreaming>network</MethodStreaming>
                <RateQuality>50</RateQuality>
            </QualityControl>
            <PropertiesControl>
                <Deinterlace>Force</Deinterlace>
                <Crop>
                    <Top>8</Top>
                    <Width>8</Width>
                    <Height>8</Height>
                    <Left>8</Left>
                    <Mode>Auto</Mode>
                </Crop>
            </PropertiesControl>
        </AnalysisConfig>
        <Message>The resource operated \"PipelineId\" cannot be found</Message>
        <Priority>10</Priority>
        <MNSMessageResult>
            <MessageId>3ca84a39a9024f19853b21be9cf9****</MessageId>
        </MNSMessageResult>
        <TemplateList>
            <Video>
                <Bufsize>5000</Bufsize>
                <Degrain>5</Degrain>
                <BitrateBnd>
                    <Max>20</Max>
                    <Min>10</Min>
                </BitrateBnd>
                <PixFmt>yuvj420p</PixFmt>
                <Codec>H.264</Codec>
                <Height>1880</Height>
                <Qscale>15</Qscale>
                <Bitrate>10</Bitrate>
                <Maxrate>10</Maxrate>
                <Profile>baseline</Profile>
                <Crf>27</Crf>
                <Gop>1</Gop>
                <Width>1990</Width>
                <Fps>60</Fps>
                <Preset>medium</Preset>
                <ScanMode>progressive</ScanMode>
            </Video>
            <TransConfig>
                <TransMode>onepass</TransMode>
            </TransConfig>
            <State>Normal</State>
            <MuxConfig>
                <Gif>
                    <FinalDelay>0</FinalDelay>
                    <Loop>0</Loop>
                </Gif>
                <Segment>
                    <Duration>60</Duration>
                </Segment>
            </MuxConfig>
            <Name>FLV-UD</Name>
            <Audio>
                <Profile>aac_low</Profile>
                <Codec>mp3</Codec>
                <Samplerate>32000</Samplerate>
                <Qscale>10</Qscale>
                <Channels>1</Channels>
                <Bitrate>8</Bitrate>
            </Audio>
            <Id>S00000000-00****</Id>
            <Container>
                <Format>flv</Format>
            </Container>
        </TemplateList>
        <UserData>testid-001</UserData>
        <InputFile>
            <Object>example.flv</Object>
            <Location>oss-cn-hangzhou</Location>
            <Bucket>example-bucket</Bucket>
        </InputFile>
        <PipelineId>bb558c1cc25b45309aab5be44d19****</PipelineId>
        <Id>57f6aa3f84824309bcba67231b40****</Id>
    </AnalysisJob>
</SubmitAnalysisJobResponse>

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

{
    "RequestId": "B52658D4-07AB-43CD-82B0-210958A65E23",
    "AnalysisJob": {
        "CreationTime": "2014-01-10T12:00:00Z",
        "Percent": 100,
        "State": "Success",
        "AnalysisConfig": {
            "QualityControl": {
                "MethodStreaming": "network",
                "RateQuality": "50"
            },
            "PropertiesControl": {
                "Deinterlace": "Force",
                "Crop": {
                    "Top": "8",
                    "Width": "8",
                    "Height": "8",
                    "Left": "8",
                    "Mode": "Auto"
                }
            }
        },
        "Message": "The resource operated \\\"PipelineId\\\" cannot be found",
        "Priority": "10",
        "MNSMessageResult": {
            "MessageId": "3ca84a39a9024f19853b21be9cf9****",
        },
        "TemplateList": [
            {
                "Video": {
                    "Bufsize": "5000",
                    "Degrain": "5",
                    "BitrateBnd": {
                        "Max": "20",
                        "Min": "10"
                    },
                    "PixFmt": "yuvj420p",
                    "Codec": "H.264",
                    "Height": "1880",
                    "Qscale": "15",
                    "Bitrate": "10",
                    "Maxrate": "10",
                    "Profile": "baseline",
                    "Crf": "27",
                    "Gop": "1",
                    "Width": "1990",
                    "Fps": "60",
                    "Preset": "medium",
                    "ScanMode": "progressive"
                },
                "TransConfig": {
                    "TransMode": "onepass"
                },
                "State": "Normal",
                "MuxConfig": {
                    "Gif": {
                        "FinalDelay": "0",
                        "Loop": "0"
                    },
                    "Segment": {
                        "Duration": "60"
                    }
                },
                "Name": "FLV-UD",
                "Audio": {
                    "Profile": "aac_low",
                    "Codec": "mp3",
                    "Samplerate": "32000",
                    "Qscale": "10",
                    "Channels": "1",
                    "Bitrate": "8"
                },
                "Id": "S00000000-00****",
                "Container": {
                    "Format": "flv"
                }
            }
        ],
        "UserData": "testid-001",
        "InputFile": {
            "Object": "example.flv",
            "Location": "oss-cn-hangzhou",
            "Bucket": "example-bucket"
        },
        "PipelineId": "bb558c1cc25b45309aab5be44d19****",
        "Id": "57f6aa3f84824309bcba67231b40****"
    }
}

Códigos de erro

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