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

# Openai Audio Speech

> Openai Audio Speech



## OpenAPI

````yaml /openapi/openai.json post /v1/audio/speech
openapi: 3.0.0
info:
  title: OpenAI generation
  version: 1.0.0
  description: API reference for OpenAI generation on Ace Data Cloud.
servers:
  - url: https://api.acedata.cloud
    description: Ace Data Cloud API
security:
  - bearerAuth: []
paths:
  /v1/audio/speech:
    post:
      summary: Openai Audio Speech
      description: Openai Audio Speech
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - input
              example:
                model: tts-1-hd
                input: Hello from AceData Cloud.
                voice: nova
                response_format: mp3
              properties:
                model:
                  type: string
                  enum:
                    - tts-1
                    - tts-1-hd
                  default: tts-1-hd
                  description: Openai Audio Speech Model
                input:
                  type: string
                  description: Openai Audio Speech Input
                voice:
                  type: string
                  enum:
                    - alloy
                    - echo
                    - fable
                    - onyx
                    - nova
                    - shimmer
                  default: alloy
                  description: Openai Audio Speech Voice
                response_format:
                  type: string
                  enum:
                    - mp3
                    - opus
                    - aac
                    - flac
                    - wav
                    - pcm
                  default: mp3
                  description: Openai Audio Speech Response Format
                speed:
                  type: number
                  default: 1
                  description: Openai Audio Speech Speed
      responses:
        '200':
          description: Openai Audio Speech Response 200
          content:
            audio/mpeg:
              schema:
                type: string
                format: binary
                description: Openai Audio Speech Response 200 Audio
        '400':
          description: Response 400
          content:
            application/json:
              schema:
                type: object
                example:
                  error:
                    code: bad_request
                    message: Please provide a non-empty input text to synthesize.
                  trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
        '401':
          description: Response 401
          content:
            application/json:
              schema:
                type: object
                example:
                  error:
                    code: authentication_failed
                    message: The token is invalid.
                  trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
        '403':
          description: Response 403
          content:
            application/json:
              schema:
                type: object
                example:
                  error:
                    code: used_up
                    message: Your balance is not enough.
                  trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
        '429':
          description: Response 429
          content:
            application/json:
              schema:
                type: object
                example:
                  error:
                    code: too_many_requests
                    message: Too many requests, please try again later.
                  trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
        '500':
          description: Response 500
          content:
            application/json:
              schema:
                type: object
                example:
                  error:
                    code: api_error
                    message: Internal server error, please contact support.
                  trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API token from https://platform.acedata.cloud

````