Start generating

Text to speech

Changed on

This endpoint will start a new task to generate speech from text.

post/v1/text_to_speech

Request

  • Base URL
    https://api.dev.runwayml.com
  • URL
    https://api.dev.runwayml.com/v1/text_to_speech
  • Auth
    HTTP bearer

Headers

X-Runway-Version'2024-11-06' required

The version of the RunwayML API being used. You can read more about versioning here.

Request body

OR
OR
OR

Example request

{
  "voice": {
    "audioUri": "https://example.com/audio.mp3"
  }
}

Response

The task that was created.

idstring uuid required

The ID of the task that was created. Use this to retrieve the task later.

Changes

  • ef7e1923afafRevision changes
    • info

      added subschema #2: eleven_v4 to the request body oneOf list

    • info

      the / request property's maxLength was increased from 5 to 16

    • info

      added the optional property to the response with the status

  • 1c0d2ae99f66Revision changes
    • breaking

      added the new required request property //

    • breaking

      added the new required request property //

    • breaking

      removed subschema #1: SeedReferenceVoice from the / request property oneOf list

    • breaking

      the / request property type changed from no type to object

    • info

      removed discriminator from / request property