# 语音合成接口

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/audio/speech:
    post:
      summary: 语音合成接口
      deprecated: false
      description: |-
        详细说明参考：[语音合成文档](https://docs.link-ai.tech/platform/api/voice-speech)
        该接口[标准版](https://link-ai.tech/console/price?type=upgrade)及以上可用
      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:
          application/json:
            schema:
              type: object
              properties:
                input:
                  type: string
                  title: 文本输入
                  description: 需要合成为语音的文本内容
                app_code:
                  type: string
                  title: 应用code
                  description: 如果填写了该值，则使用应用中设置的音色，无需再填写voice参数
                voice:
                  type: string
                  description: >-
                    指定合成的音色，如果填写该值则无需填写app_code参数。 所有可选声音见
                    [音色列表](https://docs.link-ai.tech/platform/api/voice-speech/voices)
                  title: 音色编码
              x-apifox-orders:
                - input
                - app_code
                - voice
              required:
                - input
            example:
              input: 你好，请问有什么需要帮助的?
              voice: BV007_streaming
      responses:
        '200':
          description: 语音文件二进制
          content:
            audio/mpeg:
              schema:
                type: object
                properties:
                  01JCJCHKS13NRBEGGGS6VX1HBD:
                    type: string
                x-apifox-orders:
                  - 01JCJCHKS13NRBEGGGS6VX1HBD
                required:
                  - 01JCJCHKS13NRBEGGGS6VX1HBD
          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: []
      x-apifox-folder: ''
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/3294133/apis/api-233275570-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.link-ai.tech
    description: 正式环境
security: []

```