tencent cloud

Feedback

Audio Quality Inspection Task Status Query API

Last updated: 2024-07-18 17:56:25
    Use the taskId to query the status and results of the audio quality inspection task.

    Calling Protocol

    HTTPS + JSON
    POST /v2/ivh/algotaskserver/algotaskservice/getaudioevaluationstate
    Header Content-Type: application/json;charset=utf-8

    Request Parameters

    Parameters
    Type
    Mandatory
    Description
    TaskId
    string
    Yes

    Response Parameter

    Parameters
    Type
    Mandatory
    Description
    TaskState
    string
    Yes
    Task Status:
    CREATED: Created
    QUEUING: Queuing
    PROCESSING: In process
    SUCCESS: Task succeeded
    FAIL: Task failed
    Result
    object
    Yes
    Audio quality inspection task results
    Result.Snr
    object
    Yes
    Audio signal-to-noise ratio metric
    Result.Snr.Value
    float
    Yes
    Measured value of the audio signal-to-noise ratio metric
    Result.Snr.QualifiedRange
    Array of [float]
    Yes
    Acceptable range of the audio signal-to-noise ratio metric [lower_limit,upper_limit]
    Result.Snr.Description
    string
    Yes
    Description of the audio signal-to-noise ratio metric
    Result.C50
    object
    Yes
    Audio reverberation metric
    Result.C50.Value
    float
    Yes
    Measured value of the audio reverberation metric
    Result.C50.QualifiedRange
    Array of [float]
    Yes
    Acceptable range of the audio reverberation metric [lower_limit,upper_limit]
    Result.C50.Description
    string
    Yes
    Description of the audio reverberation metric
    Result.Clipping
    object
    Yes
    Audio clipping metric
    Result.Clipping.Value
    float
    Yes
    Measured value of the audio clipping metric
    Result.Clipping.QualifiedRange
    Array of [float]
    Yes
    Acceptable range of the audio clipping metric [lower_limit,upper_limit]
    Result.Clipping.Description
    string
    Yes
    Description of the audio clipping metric
    Result.Duration
    object
    Yes
    Audio duration metric
    Result.Duration.Value
    float
    Yes
    Audio duration
    Result.Duration.QualifiedRange
    Array of [float]
    Yes
    Acceptable range of the audio duration [lower_limit,upper_limit]
    Result.Duration.Description
    string
    Yes
    Description of the audio duration metric
    Result.Wer
    object
    Yes
    Audio text accuracy metric
    Result.Wer.Value
    float
    Yes
    Text accuracy, only valid when the "reference text" is not empty.
    Result.Wer.QualifiedRange
    Array of [float]
    Yes
    Acceptable range of text accuracy [lower_limit,upper_limit]
    Result.Wer.Description
    string
    Yes
    Description of text accuracy
    Result.AlignDetails
    array of [TextAlign]
    Yes
    Text alignment result
    ErrorMsg
    string
    Yes
    Task failure prompt message
    TextAlign
    Parameters
    Type
    Mandatory
    Description
    Detail
    Array of [string]
    Yes
    Text alignment result for each character, such as ["good","good"]/["good","<eps>"], and "<eps>" is a placeholder.

    Request Sample

    {
    "Header": {},
    "Payload": {
    "TaskId": "xxx"
    }
    }

    Response Sample

    {
    "Header": {
    "Code": 0,
    "Message": "",
    "RequestID": "123"
    },
    "Payload": {
    "Status": "SUCCESS",
    "Result": {
    "Snr": {
    "Value": 72.67048,
    "QualifiedRange": [
    30,
    2147483600
    ],
    "Description": "Audio signal-to-noise ratio; the higher, the better."
    },
    "C50": {
    "Value": 57.082405,
    "QualifiedRange": [
    30,
    2147483600
    ],
    "Description": "Reverberation metric; the higher, the better."
    },
    "Clipping": {
    "QualifiedRange": [
    -2147483600,
    0
    ],
    "Description": "Clipping metric: Being less than or equal to 0 is acceptable",
    "Value": 0
    },
    "Duration": {
    "Value": 24.21,
    "QualifiedRange": [
    600,
    2147483600
    ],
    "Description": "Effective duration: It is measured in seconds, and being greater than or equal to 10 minutes is acceptable."
    },
    "Wer": {
    "Value": 0.91358024,
    "QualifiedRange": [
    0.7,
    1
    ],
    "Description": "Text accuracy: Being greater than or equal to 70% is acceptable."
    },
    "AlignDetails": [
    {
    "Detail": [
    "<eps>",
    "Big"
    ]
    },
    {
    "Detail": [
    "Family"
    "Family"
    ]
    },
    {
    "Detail": [
    "<eps>",
    "Good"
    ]
    }
    ]
    },
    "ErrorMsg": ""
    }
    }
    
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support