---
agentTools:
  projectIndex: https://unrealspeech.readme.io/llms.txt
---

# /speech

Send up to 3,000 characters and synchronously receive an MP3 and JSON timestamp URLs.

> 🤖 Processing Details
>
> * On average, 850 characters result in 1 minute of audio. In other words, 3,000 characters will result in approximately 3.5 minutes of audio.
> * On average, it takes 1 second per 700 characters. In other words, 3,000 characters will take approximately 4 seconds.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Text-to-Speech API v7",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.v7.unrealspeech.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-bearer-format": "bearer",
        "x-default": ""
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/speech": {
      "post": {
        "summary": "/speech",
        "description": "Send up to 3,000 characters and synchronously receive an MP3 and JSON timestamp URLs.",
        "operationId": "speech",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "Text",
                  "VoiceId"
                ],
                "properties": {
                  "Text": {
                    "type": "string",
                    "description": "This is the text to be synthesized to audio. Up to 3,000 characters.",
                    "default": "This is a test"
                  },
                  "VoiceId": {
                    "type": "string",
                    "description": "Scarlett, Dan, Liv, Will, Amy",
                    "default": "Scarlett"
                  },
                  "Bitrate": {
                    "type": "string",
                    "description": "320k, 256k, 192k, ...",
                    "default": "192k"
                  },
                  "Speed": {
                    "type": "string",
                    "description": "-1.0 to 1.0",
                    "default": "0"
                  },
                  "Pitch": {
                    "type": "string",
                    "description": "0.5 to 1.5",
                    "default": "1"
                  },
                  "TimestampType": {
                    "type": "string",
                    "description": "word or sentence",
                    "default": "sentence"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"CreationTime\": \"2024-01-31T06:53:34.56Z\",\n  \"OutputUri\": \"https://unreal-expire-in-90-days.s3-us-west-2.amazonaws.com/3f2a72d0-0.mp3\",\n  \"RequestCharacters\": 14,\n  \"TaskId\": \"3f2a72d0\",\n  \"TaskStatus\": \"completed\",\n  \"TimestampsUri\": \"https://unreal-expire-in-90-days.s3-us-west-2.amazonaws.com/3f2a72d0-0.json\",\n  \"VoiceId\": \"Scarlett\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "CreationTime": {
                      "type": "string",
                      "example": "2024-01-31T06:53:34.56Z"
                    },
                    "OutputUri": {
                      "type": "string",
                      "example": "https://unreal-expire-in-90-days.s3-us-west-2.amazonaws.com/3f2a72d0-0.mp3"
                    },
                    "RequestCharacters": {
                      "type": "integer",
                      "example": 14,
                      "default": 0
                    },
                    "TaskId": {
                      "type": "string",
                      "example": "3f2a72d0"
                    },
                    "TaskStatus": {
                      "type": "string",
                      "example": "completed"
                    },
                    "TimestampsUri": {
                      "type": "string",
                      "example": "https://unreal-expire-in-90-days.s3-us-west-2.amazonaws.com/3f2a72d0-0.json"
                    },
                    "VoiceId": {
                      "type": "string",
                      "example": "Scarlett"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "65ba1daa32beaf00785d937e:65ba3fb9f3a3a100542129b7"
}
```