SubmitAnalysisJob - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Lorsque vous appelez l'opération SubmitAnalysisJob pour soumettre une tâche d'analyse de modèle prédéfini, ApsaraVideo Media Processing (MPS) analyse intelligemment le fichier d'entrée de la tâche et recommande un modèle prédéfini adapté. Appelez l'opération QueryAnalysisJobList pour consulter le résultat de l'analyse ou activez les notifications asynchrones afin de le recevoir.
Le résultat de l'analyse n'est conservé que pendant deux semaines à compter de sa génération. Il est supprimé après ce délai. Si vous utilisez le modèle prédéfini recommandé dans une tâche de transcodage après deux semaines, la tâche échoue et le code d'erreur AnalysisResultNotFound est renvoyé.

Limite QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde par compte. Si le nombre d'appels par seconde dépasse cette limite, un mécanisme de limitation du débit (throttling) se déclenche, ce qui peut affecter votre activité. Tenez compte de cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la rubrique Limite QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	SubmitAnalysisJob	Nom de l'opération à effectuer. Définissez la valeur sur SubmitAnalysisJob.
Input	String	Yes	null	Informations d'entrée relatives à la tâche d'analyse de modèle prédéfini à soumettre. La valeur est un objet JSON. Connectez-vous à la console Object Storage Service (OSS) pour accorder à MPS les autorisations de lecture sur le bucket OSS spécifié. ~~29253~~
AnalysisConfig	String	No	null	Configuration de la tâche. Définissez ce paramètre si nécessaire. ~~29253~~
UserData	String	No	testid-001	Données personnalisées. Elles peuvent contenir des lettres, des chiffres et des traits d'union (-), et leur taille ne peut pas dépasser 1 024 octets. Elles ne doivent pas commencer par un caractère spécial.
PipelineId	String	Yes	bb558c1cc25b45309aab5be44d19****	ID de la file d'attente MPS à laquelle la tâche est ajoutée. Pour afficher l'ID de la file d'attente MPS, connectez-vous à la MPS console et choisissez Global Settings > Pipelines dans le volet de navigation de gauche. Si vous souhaitez activer les notifications asynchrones, assurez-vous que la file d'attente est associée à un topic Message Service (MNS).
Priority	String	No	10	Priorité de la tâche dans la file d'attente MPS à laquelle elle est ajoutée. Valeurs valides : 1 à 10. Une valeur de 10 indique la priorité la plus élevée. Valeur par défaut : 6.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	B52658D4-07AB-43CD-82B0-210958A65E23	ID de la requête.
AnalysisJob	Object		Informations relatives à la tâche d'analyse de modèle prédéfini soumise.
CreationTime	String	2014-01-10T12:00:00Z	Heure de création de la tâche.
Percent	Long	100	Progression du transcodage.
State	String	Success	État de la tâche. Valeurs valides : Submitted : La tâche a été soumise. Analyzing : La tâche est en cours d'exécution. Success : La tâche a réussi. Fail : La tâche a échoué.
AnalysisConfig	Object		Configuration de la tâche.
QualityControl	Object		Contrôle qualité appliqué à la sortie de la tâche.
MethodStreaming	String	network	Mode de lecture. Valeurs valides : network : lecture en ligne local : lecture sur des appareils locaux Valeur par défaut : network.
RateQuality	String	50	Niveau de qualité de la sortie de la tâche.
PropertiesControl	Object		Contrôle des attributs de la sortie de la tâche.
Deinterlace	String	Force	Indique si le désentrelacement a été forcé. Valeurs valides : Auto : Le désentrelacement a été exécuté automatiquement. Force : Le désentrelacement a été forcé. None : Le désentrelacement a été explicitement désactivé.
Crop	Object		Configuration du recadrage des images vidéo.
Top	String	8	Marge supérieure recadrée. Remarque Ce paramètre n'est pas valide si le paramètre Mode est défini sur Auto ou None.
Width	String	8	Largeur de la vidéo après recadrage des marges. Remarque Ce paramètre n'est pas valide si le paramètre Mode est défini sur Auto ou None.
Height	String	8	Hauteur de la vidéo après recadrage des marges. Remarque Ce paramètre n'est pas valide si le paramètre Mode est défini sur Auto ou None.
Left	String	8	Marge gauche recadrée. Remarque Ce paramètre n'est pas valide si le paramètre Mode est défini sur Auto ou None.
Mode	String	Auto	Mode de recadrage. Valeurs valides : Auto : Le recadrage a été exécuté automatiquement. Il s'agit de la valeur par défaut. Force : Le recadrage a été forcé. None : Le recadrage a été explicitement désactivé.
Message	String	The resource operated \"PipelineId\" cannot be found	Message d'erreur renvoyé en cas d'échec de la tâche.
Priority	String	10	Priorité de la tâche dans la file d'attente MPS à laquelle elle est ajoutée. Valeurs valides : 1 à 10. Une valeur de 10 indique la priorité la plus élevée. Valeur par défaut : 10.
MNSMessageResult	Object		Message envoyé par MNS pour notifier l'utilisateur du résultat de la tâche.
MessageId	String	3ca84a39a9024f19853b21be9cf9****	ID du message de succès. Ce paramètre n'est pas renvoyé si la tâche échoue.
ErrorMessage	String	The resource operated \"PipelineId\" cannot be found	Message d'erreur renvoyé en cas d'échec de la tâche. Ce paramètre n'est pas renvoyé si la tâche réussit.
ErrorCode	String	InvalidParameter.ResourceNotFound	Code d'erreur renvoyé en cas d'échec de la tâche. Ce paramètre n'est pas renvoyé si la tâche réussit.
TemplateList	Array of Template		Liste des modèles prédéfinis correspondants.
Template
Video	Object		Configuration du codec vidéo.
Bufsize	String	5000	Taille du tampon (buffer). Unité : Ko. Valeur par défaut : 6000.
Degrain	String	5	Niveau de l'algorithme de débruitage indépendant.
BitrateBnd	Object		Plage de débit binaire moyen de la vidéo.
Max	String	20	Limite supérieure du débit binaire total. Unité : Kbit/s.
Min	String	10	Limite inférieure du débit binaire total. Unité : Kbit/s.
PixFmt	String	yuvj420p	Format de pixel pour l'encodage des couleurs vidéo. Valeurs valides : formats de pixel standard tels que yuv420p et yuvj420p.
Codec	String	H.264	Format du codec vidéo. Valeur par défaut : H.264.
Height	String	1880	Hauteur de la vidéo. Unité : pixel. Valeur par défaut : la hauteur d'origine de la vidéo.
Qscale	String	15	Niveau de contrôle qualité de la vidéo.
Bitrate	String	10	Débit binaire moyen de la vidéo. Unité : Kbit/s.
Maxrate	String	10	Débit binaire maximal de la vidéo. Unité : Kbit/s.
Profile	String	baseline	Profil du codec. Valeurs valides : baseline : applicable aux appareils mobiles. main : applicable aux appareils en définition standard. high : applicable aux appareils en haute définition. Valeur par défaut : high.
Crf	String	27	Facteur de taux constant (CRF), qui est le paramètre de contrôle qualité par défaut. Valeur par défaut lorsque le paramètre Codec est défini sur H.264 : 23. Valeur par défaut lorsque le paramètre Codec est défini sur H.265 : 26. Si ce paramètre est renvoyé, le paramétrage du paramètre Bitrate n'est pas pris en compte.
Gop	String	1	Nombre maximal d'images entre deux images clés. Valeur par défaut : 250.
Width	String	1990	Largeur de la vidéo. Unité : pixel. Valeur par défaut : la largeur d'origine de la vidéo.
Fps	String	60	Fréquence d'images. La valeur est 60 si la fréquence d'images du fichier d'entrée dépasse 60. Valeur par défaut : la fréquence d'images du fichier d'entrée.
Preset	String	medium	Algorithme vidéo prédéfini. Valeurs valides : veryfast, fast, medium, slow et slower. Valeur par défaut : medium.
ScanMode	String	progressive	Mode de balayage. Valeurs valides : interlaced : Un balayage entrelacé a été effectué. progressive : Un balayage progressif a été effectué.
TransConfig	Object		Configuration générale de transcodage.
TransMode	String	onepass	Mode de transcodage. Valeurs valides : onepass, twopass et CBR. Valeur par défaut : onepass.
State	String	Normal	État du modèle. Valeurs valides : Normal : Le modèle est dans un état normal. Deleted : Le modèle est supprimé.
MuxConfig	Object		Configuration de transmuxing.
Gif	Object		Format GIF.
FinalDelay	String	0	Intervalle entre deux boucles consécutives pour le format GIF. Unité : 0,01 s. Par exemple, une valeur de 500 indique 5 secondes.
Loop	String	0	Nombre de boucles pour le format GIF ou WebP. Valeur par défaut : 0.
Segment	Object		Configuration des segments.
Duration	String	60	Durée du segment. Unité : secondes.
Name	String	FLV-UD	Nom du modèle.
Audio	Object		Configuration du codec audio.
Profile	String	aac_low	Profil du codec du fichier audio. Valeurs valides lorsque le paramètre Codec est défini sur aac : aac_low, aac_he, aac_he_v2, aac_ld et aac_eld.
Codec	String	mp3	Format du codec audio. Valeur par défaut : aac.
Samplerate	String	32000	Fréquence d'échantillonnage. Unité : Hz. Valeur par défaut : 44100.
Qscale	String	10	Niveau de contrôle qualité de l'audio.
Channels	String	1	Nombre de canaux audio. Valeur par défaut : 2.
Bitrate	String	8	Débit binaire audio du fichier de sortie. Unité : Kbit/s. Valeur par défaut : 128.
Id	String	S00000000-00****	ID du modèle de transcodage.
Container	Object		Configuration du conteneur.
Format	String	flv	Format du conteneur.
UserData	String	testid-001	Données personnalisées.
Code	String	InvalidParameter.ResourceNotFound	Code d'erreur renvoyé en cas d'échec de la tâche. Ce paramètre n'est pas renvoyé si la tâche réussit.
InputFile	Object		Informations relatives à l'entrée de la tâche.
Object	String	example.flv	Nom du fichier d'entrée téléchargé sur le bucket OSS.
Location	String	oss-cn-hangzhou	ID de la région OSS.
Bucket	String	example-bucket	Nom du bucket OSS sur lequel le fichier d'entrée est téléchargé.
PipelineId	String	bb558c1cc25b45309aab5be44d19****	ID de la file d'attente MPS à laquelle la tâche est ajoutée.
Id	String	57f6aa3f84824309bcba67231b40****	ID de la tâche d'analyse de modèle.

Exemples

Exemples de requêtes

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>

Exemples de réponses réussies

XML format

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>

JSON format

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****"
    }
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.