Start generating

Text to speech

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

post/v1/text_to_speech

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

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

Changed in 9 of the 54 revisions of this API.4319

Aug 7, 2026cbbe796a13a01See the full diff
- ▲
  removed subschema #1: SeedPresetVoice from the oneOf[subschema #1: seed_audio]/voice request property oneOf list
  request-property-one-of-removed
Aug 7, 202673a12c23285c4See the full diff
- ○
  added subschema #3: eleven_v3 to the request body oneOf list
  request-body-one-of-added
- ○
  added subschema #1: SeedPresetVoice to the oneOf[subschema #1: seed_audio]/voice request property oneOf list
  request-property-one-of-added
- ○
  added the non-success response with the status 400
  response-non-success-status-added
- ○
  added the required property estimatedCost to the response with the 200 status
  response-required-property-added
Jul 6, 20268b1c682294d71See the full diff
- ○
  added subschema #1: seed_audio to the request body oneOf list
  request-body-one-of-added
Dec 4, 20256dab1bdab5d33See the full diff
- ○
  the model request property default value eleven_multilingual_v2 was removed
  request-property-default-value-removed
- ○
  the type request property default value runway-preset was removed
  request-property-default-value-removed
- ○
  added the media type application/json for the response with the status 429
  response-media-type-added
Dec 3, 2025c2a88516fa0c2See the full diff
- ○
  the model request property default value eleven_multilingual_v2 was added
  request-property-default-value-added
- ○
  the type request property default value runway-preset was added
  request-property-default-value-added
Dec 3, 202576b3962cf49e2See the full diff
- ○
  the model request property default value eleven_multilingual_v2 was removed
  request-property-default-value-removed
- ○
  the type request property default value runway-preset was removed
  request-property-default-value-removed
Nov 4, 20256902fa9494c512See the full diff
- ▲
  removed subschema #1 from the oneOf[subschema #1: eleven_multilingual_v2]/voice request property oneOf list
  request-property-one-of-removed
- ○
  the model request property default value eleven_multilingual_v2 was added
  request-property-default-value-added
- ○
  added subschema #1: RunwayPresetVoice to the oneOf[subschema #1: eleven_multilingual_v2]/voice request property oneOf list
  request-property-one-of-added
Oct 22, 20258448e1c9a86211See the full diff
- ▲
  removed subschema #1: RunwayPresetVoice from the oneOf[subschema #1: eleven_multilingual_v2]/voice request property oneOf list
  request-property-one-of-removed
- ○
  added subschema #1 to the oneOf[subschema #1: eleven_multilingual_v2]/voice request property oneOf list
  request-property-one-of-added
Oct 22, 202590724848e40f134See the full diff
- ▲
  the request's body type/format changed from object/ to /
  request-body-type-changed
- ●
  removed the request property model
  request-property-removed
- ●
  removed the request property promptText
  request-property-removed
- ●
  removed the request property voice
  request-property-removed
- ○
  added request discriminator
  request-body-discriminator-added
- ○
  added subschema #1: eleven_multilingual_v2 to the request body oneOf list
  request-body-one-of-added
- ○
  added the non-success response with the status 429
  response-non-success-status-added
- ○
  the id response's property pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ was added for the status 200
  response-property-pattern-added

Full history