Згенеруйте мовлення Runway із тексту

POST

runwayml

text_to_speech

curl https://api.cometapi.com/runwayml/v1/text_to_speech \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "eleven_multilingual_v2",
  "promptText": "Welcome to our audio guide. Let us begin the tour.",
  "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/text_to_speech, щоб створити завдання мовлення з тексту. Надсилайте свій ключ CometAPI API за допомогою автентифікації Bearer і тіла JSON-запиту.

Виберіть модель і голос

Кожен запит потребує model і promptText. Поле voice є обов’язковим для eleven_multilingual_v2 і eleven_v3 та необов’язковим для seed_audio.

Ідентифікатор моделі	Обмеження тексту	Конфігурація голосу
`eleven_multilingual_v2`	1000 кодових одиниць UTF-16	`type: runway-preset` і `presetId`, наприклад `Maya`
`eleven_v3`	5000 символів	`type: runway-preset` і `presetId`, наприклад `Maya`
`seed_audio`	2048 символів	Не вказуйте `voice` для голосу за замовчуванням або використовуйте `type: reference-audio` і `audioUri`

Для попередньо налаштованих голосів виберіть presetId зі схеми запиту. Для seed_audio, замініть приклад audioUri доступною HTTPS URL-адресою вашого еталонного голосу.

Налаштування виразності мовлення

За допомогою eleven_v3 значення promptText може містити виразні теги, як-от [whispers] або [laughs]. Модель також приймає такі елементи керування:

Поле	Значення	Значення
`stability`	Число від 0 до 1	Нижчі ненульові значення забезпечують більше виразності; вищі значення є стабільнішими.
`similarityBoost`	Число від 0 до 1	Вищі значення точніше відповідають вибраному голосу.
`style`	Число від 0 до 1	Вищі значення підкреслюють стиль голосу.
`speed`	Число від 0,7 до 1,2	`1` використовує звичайну швидкість.
`useSpeakerBoost`	`true`	Запитує більшу схожість із вибраним голосом.
`languageCode`	Код мови ISO 639-1	Спрямовує вимову та нормалізацію тексту.
`applyTextNormalization`	`auto`, `on`, `off`	Керує тим, як текст, наприклад числа, перетворюється на вимовлені слова.
`seed`	Ціле число від 1 до 4294967295	Установлює seed для семплування.

Для stability, similarityBoost і style значення 0 використовує значення моделі за замовчуванням, як і пропуск поля. useSpeakerBoost: false також використовує значення моделі за замовчуванням. Щоб установити seed для семплування, використовуйте додатне ціле число; seed: 0 вибирає seed автоматично.

Налаштування швидкості та формату мовлення

За допомогою seed_audio використовуйте speechRate і loudnessRate від -50 до 100 або pitchRate від -12 до 12 півтонів. Ці елементи керування приймають цілі числа; пропуск або 0 зберігає звичайне значення. Установіть для sampleRate значення 8000, 16000, 24000, 32000, 44100 або 48000 Гц. Установіть для outputFormat значення wav, mp3 або ogg_opus. Не додавайте duration, referenceAudios, а також елементи керування Eleven v3 з seed_audio на цьому endpoint.

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

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

Авторизації

Authorization

string

header

обов'язково

Use your CometAPI API key.

Тіло

application/json

eleven_multilingual_v2
eleven_v3
seed_audio

Request settings for eleven_multilingual_v2.

model

enum<string>

обов'язково

Model ID for this request.

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

eleven_multilingual_v2

Allowed value: "eleven_multilingual_v2"

promptText

string

обов'язково

Text to speak, from 1 to 1000 UTF-16 code units.

Required string length: 1 - 1000

voice

RunwayPresetVoice · object

обов'язково

The voice to use for the generated speech.

Show child attributes

Відповідь

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/text_to_speech \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "eleven_multilingual_v2",
  "promptText": "Welcome to our audio guide. Let us begin the tour.",
  "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 із тексту

Виберіть модель і голос

Налаштування виразності мовлення

Налаштування швидкості та формату мовлення

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

Авторизації

Тіло

Відповідь

​Виберіть модель і голос

​Налаштування виразності мовлення

​Налаштування швидкості та формату мовлення

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

Авторизації

Тіло

Відповідь

Виберіть модель і голос

Налаштування виразності мовлення

Налаштування швидкості та формату мовлення

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