Start generating

Speech to speech

This endpoint will start a new task to convert speech from one voice to another in audio or video.

post/v1/speech_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

removeBackgroundNoiseboolean

Whether to remove background noise from the generated speech.

model'eleven_multilingual_sts_v2' required

Example request

{
  "media": {
    "uri": "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 10 of the 54 revisions of this API.2221

Aug 7, 202673a12c23285c2See the full diff
- ○
  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
May 8, 2026c9dc9ce1282a1See the full diff
- ●
  removed the request property oneOf[subschema #1: eleven_multilingual_sts_v2]/runwayVoiceId
  request-property-removed
Apr 30, 20261d3bb312672a1See the full diff
- ○
  added the new optional request property oneOf[subschema #1: eleven_multilingual_sts_v2]/runwayVoiceId
  new-optional-request-property
Apr 15, 202687bdf413b9841See the full diff
- ●
  removed the request property oneOf[subschema #1: eleven_multilingual_sts_v2]/runwayVoiceId
  request-property-removed
Apr 15, 20266f5bc53a0d361See the full diff
- ○
  added the new optional request property oneOf[subschema #1: eleven_multilingual_sts_v2]/runwayVoiceId
  new-optional-request-property
Dec 4, 20256dab1bdab5d35See the full diff
- ○
  the model request property default value eleven_multilingual_sts_v2 was removed
  request-property-default-value-removed
- ○
  the type request property default value audio was removed
  request-property-default-value-removed
- ○
  the type request property default value runway-preset was removed
  request-property-default-value-removed
- ○
  the type request property default value video 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, 2025c2a88516fa0c4See the full diff
- ○
  the model request property default value eleven_multilingual_sts_v2 was added
  request-property-default-value-added
- ○
  the type request property default value audio was added
  request-property-default-value-added
- ○
  the type request property default value runway-preset was added
  request-property-default-value-added
- ○
  the type request property default value video was added
  request-property-default-value-added
Dec 3, 202576b3962cf49e4See the full diff
- ○
  the model request property default value eleven_multilingual_sts_v2 was removed
  request-property-default-value-removed
- ○
  the type request property default value audio was removed
  request-property-default-value-removed
- ○
  the type request property default value runway-preset was removed
  request-property-default-value-removed
- ○
  the type request property default value video was removed
  request-property-default-value-removed
Nov 4, 20256902fa9494c523See the full diff
- ▲
  removed subschema #1 from the oneOf[subschema #1: eleven_multilingual_sts_v2]/voice request property oneOf list
  request-property-one-of-removed
- ▲
  removed subschema #1 subschema #2 from the oneOf[subschema #1: eleven_multilingual_sts_v2]/media request property oneOf list
  request-property-one-of-removed
- ○
  the model request property default value eleven_multilingual_sts_v2 was added
  request-property-default-value-added
- ○
  added subschema #1: RunwayPresetVoice to the oneOf[subschema #1: eleven_multilingual_sts_v2]/voice request property oneOf list
  request-property-one-of-added
- ○
  added subschema #1: SpeechToSpeechAudio subschema #2: SpeechToSpeechVideo to the oneOf[subschema #1: eleven_multilingual_sts_v2]/media request property oneOf list
  request-property-one-of-added
Oct 22, 20258448e1c9a8621See the full diff
- ○
  endpoint added
  endpoint-added

Full history