Перетворення мовлення Runway

POST

runwayml

speech_to_speech

curl https://api.cometapi.com/runwayml/v1/speech_to_speech \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "eleven_multilingual_sts_v2",
  "media": {
    "type": "audio",
    "uri": "https://your-audio-host/source-speech.mp3"
  },
  "voice": {
    "type": "runway-preset",
    "presetId": "Maya"
  }
}'

{
  "id": "123e4567-e89b-42d3-a456-426614174000"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Використовуйте POST /runwayml/v1/speech_to_speech, щоб перетворити записаний діалог на попередньо налаштований голос. Використовуйте ID моделі eleven_multilingual_sts_v2. Надсилайте свій ключ API CometAPI з автентифікацією Bearer і тілом JSON-запиту.

Укажіть діалог і голос

Поле	Обов’язкове значення
`model`	`eleven_multilingual_sts_v2`
`media.type`	`audio` для аудіофайлу або `video` для відео, що містить діалог
`media.uri`	Доступний HTTPS URL вихідного файлу
`voice.type`	`runway-preset`
`voice.presetId`	Попередньо налаштований голос зі схеми запиту, наприклад `Maya`

Замініть приклад URL медіафайлу своїм вихідним файлом. Якщо використовуєте відео, змініть media.type на video і вкажіть URL відео в media.uri. Установіть removeBackgroundNoise: true, щоб видалити фоновий шум зі згенерованого мовлення. Пропустіть це поле, щоб використати значення моделі за замовчуванням.

Отримання результату

Збережіть повернутий id, а потім використовуйте Отримати завдання Runway щоб отримати статус завдання. Коли status має значення SUCCEEDED, завантажте отриманий медіафайл за URL-адресами в output. Якщо виконання завдання не вдається, перевірте failure і failureCode.

Авторизації

Authorization

string

header

обов'язково

Use your CometAPI API key.

Тіло

application/json

Request settings for eleven_multilingual_sts_v2.

model

enum<string>

обов'язково

Model ID for this request.

Доступні опції:

eleven_multilingual_sts_v2

Allowed value: "eleven_multilingual_sts_v2"

media

SpeechToSpeechAudio · object

обов'язково

Audio or video file containing the dialogue to convert.

SpeechToSpeechAudio
SpeechToSpeechVideo

Show child attributes

voice

RunwayPresetVoice · object

обов'язково

The voice to use for the generated speech.

Show child attributes

removeBackgroundNoise

boolean

Set true to remove background noise from the generated speech. Omit or use false for the model default.

Відповідь

Task created. Save the returned id to retrieve task status.

string

обов'язково

Task ID for GET /runwayml/v1/tasks/{id}.

status

string

Task state, when returned.

createdAt

string<date-time>

Task submission timestamp, when returned.

output

string<uri>[]

Result URLs, when returned.

failure

string

Failure explanation, when returned.

failureCode

string

Machine-readable failure code, when returned.

estimatedCost

object

Task estimate metadata, when returned.

Show child attributes

cost

object

Task cost metadata, when returned.

Show child attributes

Останнє оновлення 18 вересня 2026 р.

curl https://api.cometapi.com/runwayml/v1/speech_to_speech \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "eleven_multilingual_sts_v2",
  "media": {
    "type": "audio",
    "uri": "https://your-audio-host/source-speech.mp3"
  },
  "voice": {
    "type": "runway-preset",
    "presetId": "Maya"
  }
}'

{
  "id": "123e4567-e89b-42d3-a456-426614174000"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Модерація контенту

API-ключі

Перетворення мовлення Runway

Укажіть діалог і голос

Отримання результату

Авторизації

Тіло

Відповідь

​Укажіть діалог і голос

​Отримання результату

Авторизації

Тіло

Відповідь

Укажіть діалог і голос

Отримання результату