# 语音识别接口

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/audio/transcriptions:
    post:
      summary: 语音识别接口
      deprecated: false
      description: >-
        详细说明参考：[语音识别文档](https://docs.link-ai.tech/platform/api/voice-recognition)
      tags:
        - 语音
      parameters:
        - name: Authorization
          in: header
          description: >-
            在 [LinkAI平台-应用接入](https://link-ai.tech/console/interface) 生成API
            Key并填入
          required: true
          example: Bearer YOUR_API_KEY
          schema:
            type: string
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  format: binary
                  type: string
                  description: >-
                    音频文件，支持 mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm, flac,
                    amr 类型
                  example: ''
            example:
              app_code: T8kjAqQw7o
              args:
                height: '1.8'
                weight: '75'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  text:
                    type: string
                    description: 语音识别的文本内容
                    title: 文本内容
                required:
                  - text
                x-apifox-orders:
                  - text
          headers: {}
          x-apifox-name: 成功
        '400':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                    x-apifox-orders:
                      - type
                      - message
                required:
                  - error
                x-apifox-orders:
                  - error
              example:
                error:
                  type: invalid_request_error
                  message: 'Invalid request: user message content is empty'
          headers: {}
          x-apifox-name: 参数不正确
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                    x-apifox-orders:
                      - type
                      - message
                required:
                  - error
                x-apifox-orders:
                  - error
              example:
                error:
                  type: invalid_request_error
                  message: >-
                    Authentication failed, please check your API_KEY in
                    https://link-ai.tech/console/interface
          headers: {}
          x-apifox-name: API Key鉴权失败
        '402':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                    required:
                      - message
                    x-apifox-orders:
                      - message
                x-apifox-orders:
                  - error
              example:
                error:
                  message: App not found, please check your app_code param
          headers: {}
          x-apifox-name: 应用不存在
        '403':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                    required:
                      - message
                    x-apifox-orders:
                      - message
                x-apifox-orders:
                  - error
              example:
                error:
                  message: No app access permissions
          headers: {}
          x-apifox-name: 应用无访问权限
        '406':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                    required:
                      - message
                    x-apifox-orders:
                      - message
                x-apifox-orders:
                  - error
              example:
                error:
                  message: >-
                    You exceeded your current quota, please check your balance
                    in https://link-ai.tech/console/account
          headers: {}
          x-apifox-name: 余额不足
        '408':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                success: false
                code: 408
                message: 当前版本无可用API访问权限
                data: null
          headers: {}
          x-apifox-name: 无API访问权限
        '409':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                    required:
                      - message
                    x-apifox-orders:
                      - message
                x-apifox-orders:
                  - error
              example:
                error:
                  message: Content sensitivity detection failed (内容合规检查不通过)
          headers: {}
          x-apifox-name: 内容审核不通过
        '503':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                    required:
                      - message
                    x-apifox-orders:
                      - message
                x-apifox-orders:
                  - error
              example:
                error:
                  message: >-
                    Server is too busy, please retry or contact the customer
                    service
          headers: {}
          x-apifox-name: 服务异常
      security:
        - bearerAuth: []
          x-apifox:
            schemeGroups:
              - id: fxalgFNckA8_wiEiIOIkk
                schemeIds:
                  - bearerAuth
            required: true
            use:
              id: fxalgFNckA8_wiEiIOIkk
            scopes:
              fxalgFNckA8_wiEiIOIkk:
                bearerAuth: []
      x-apifox-folder: 语音
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/3294133/apis/api-233262806-run
components:
  schemas: {}
  securitySchemes:
    bearerAuth:
      type: bearer
      scheme: bearer
      description: LinkAI API Key，可在 https://link-ai.tech/console/interface 创建
servers:
  - url: https://api.link-ai.tech
    description: 正式环境
security:
  - bearerAuth: []
    x-apifox:
      schemeGroups:
        - id: fxalgFNckA8_wiEiIOIkk
          schemeIds:
            - bearerAuth
      required: true
      use:
        id: fxalgFNckA8_wiEiIOIkk
      scopes:
        fxalgFNckA8_wiEiIOIkk:
          bearerAuth: []

```