> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senseaudio.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 音频质量检测

> 检测音频质量与噪声情况

## 说明

检测音频质量与噪声情况，帮助筛选或评估原始音频文件的质量。

* **接口地址**：`https://api.senseaudio.cn/v1/audio/analysis`
* **Content-Type**：`multipart/form-data`
* **鉴权方式**：Bearer Token，详见 [快速接入](/guides/account/quick-access)

## Authorizations

<ParamField header="Authorization" type="string" required>
  Bearer 鉴权头，格式为 `Bearer SENSEAUDIO_API_KEY`。
</ParamField>

## Body

<Note>`multipart/form-data`</Note>

<ParamField body="file" type="file" required>
  音频文件。
</ParamField>

<ParamField body="model" type="string" required default="senseaudio-asr-check-1.5-260319">
  模型名称。目前仅支持 `senseaudio-asr-check-1.5-260319`。
</ParamField>

## Response

`200` — `application/json`

<ResponseField name="audio_info" type="object">
  音频信息。

  <Expandable title="child attributes">
    <ResponseField name="audio_info.duration" type="integer">
      音频时长（ms）。
    </ResponseField>

    <ResponseField name="audio_info.format" type="string">
      音频格式。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="result" type="object">
  检测结果。

  <Expandable title="child attributes">
    <ResponseField name="result.has_noise" type="boolean">
      是否有噪声。
    </ResponseField>

    <ResponseField name="result.noise_score" type="number">
      噪声评分。
    </ResponseField>

    <ResponseField name="result.severity" type="string">
      严重程度。
    </ResponseField>

    <ResponseField name="result.noise_types" type="string[]">
      噪声类型列表。
    </ResponseField>

    <ResponseField name="result.analysis" type="string">
      分析结果。
    </ResponseField>
  </Expandable>
</ResponseField>

## 相关指南

* [语音识别介绍](/guides/asr/overview)
* [语音识别转写](/api-reference/endpoint/asr/transcriptions)
* [计费说明](/guides/account/billing)


## OpenAPI

````yaml api-reference/endpoint/asr/analysis.openapi.json POST /v1/audio/analysis
openapi: 3.1.0
info:
  title: SenseAudio - 音频质量检测
  version: 1.0.0
servers:
  - url: https://api.senseaudio.cn
    description: 生产环境
security:
  - bearerAuth: []
paths:
  /v1/audio/analysis:
    post:
      tags:
        - ASR
      summary: 音频质量检测
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
                - file
                - model
              properties:
                file:
                  type: string
                  format: binary
                  example: '@audio.mp3'
                model:
                  type: string
                  description: 模型名称。目前仅支持 senseaudio-asr-check-1.5-260319。
                  enum:
                    - senseaudio-asr-check-1.5-260319
                  default: senseaudio-asr-check-1.5-260319
                  example: senseaudio-asr-check-1.5-260319
            example:
              file: '@audio.mp3'
              model: senseaudio-asr-check-1.5-260319
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudioAnalysisResponse'
              example:
                audio_info:
                  duration: 5230
                  format: wav
                result:
                  has_noise: true
                  noise_score: 0.42
                  severity: low
                  noise_types:
                    - background
                  analysis: 音频整体清晰，存在轻微的环境底噪。
components:
  schemas:
    AudioAnalysisResponse:
      type: object
      properties:
        audio_info:
          type: object
          properties:
            duration:
              type: integer
              description: 音频时长（ms）
            format:
              type: string
              description: 音频格式
        result:
          type: object
          properties:
            has_noise:
              type: boolean
              description: 是否有噪声
            noise_score:
              type: number
              description: 噪声评分
            severity:
              type: string
              description: 严重程度
            noise_types:
              type: array
              items:
                type: string
              description: 噪声类型列表
            analysis:
              type: string
              description: 分析结果
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API_KEY
      description: 格式：`Bearer <API_KEY>`

````