Створення звукових ефектів Runway

POST

runwayml

sound_effect

curl https://api.cometapi.com/runwayml/v1/sound_effect \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "eleven_text_to_sound_v2",
  "promptText": "Gentle rain falling on a wooden roof with distant thunder.",
  "duration": 5.5,
  "loop": true
}'

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

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

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

Використовуйте POST /runwayml/v1/sound_effect, щоб створити аудіозавдання з текстового prompt. Надсилайте свій ключ CometAPI API за допомогою автентифікації Bearer і тіла JSON-запиту.

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

ID моделі	Обов’язкові вхідні дані	Необов’язкові параметри керування
`eleven_text_to_sound_v2`	`promptText` від 1 до 3000 символів	`duration` від 0,5 до 30 секунд, включно з дробовими секундами; `loop`
`seed_audio`	`promptText` від 1 до 2048 символів	До трьох `referenceAudios`; параметри керування мовленням, гучністю та висотою тону; формат виводу

Для eleven_text_to_sound_v2 не вказуйте duration, щоб вибрати тривалість на основі prompt. Установіть loop: true, щоб надіслати запит на повторюваний звуковий ефект. Для seed_audio звертайтеся до referenceAudios у prompt як до @Audio1, @Audio2, і @Audio3 у порядку масиву. Не вказуйте referenceAudios, якщо посилання не потрібне. Замініть кожен URL прикладу аудіо на доступний HTTPS URL вашого аудіофайлу. Не додавайте duration, loop або voice для цієї моделі в цій кінцевій точці.

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

Поле	Значення	Призначення
`speechRate`	Ціле число від -50 до 100	Від’ємне значення сповільнює мовлення; додатне прискорює його.
`loudnessRate`	Ціле число від -50 до 100	Від’ємне значення зменшує гучність; додатне збільшує її.
`pitchRate`	Ціле число від -12 до 12	Зміщення висоти тону в півтонах.
`sampleRate`	`8000`, `16000`, `24000`, `32000`, `44100`, `48000`	Частота дискретизації аудіо в Гц.
`outputFormat`	`wav`, `mp3`, `ogg_opus`	Формат вихідного аудіо.

Для трьох параметрів швидкості не вказуйте поле або використовуйте 0, щоб зберегти його звичайне значення.

Отримайте результат

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

Авторизації

Authorization

string

header

обов'язково

Use your CometAPI API key.

Тіло

application/json

eleven_text_to_sound_v2
seed_audio

Request settings for eleven_text_to_sound_v2.

model

enum<string>

обов'язково

Model ID for this request.

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

eleven_text_to_sound_v2

Allowed value: "eleven_text_to_sound_v2"

promptText

string

обов'язково

A text description of the sound effect to generate.

Required string length: 1 - 3000

duration

number

Sound effect duration in seconds, from 0.5 to 30. Fractional seconds are accepted. Omit this field to choose duration from the prompt.

Необхідний діапазон: 0.5 <= x <= 30

loop

boolean

за замовчуванням:false

Set true to request a sound effect that loops seamlessly. Defaults to false.

Відповідь

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/sound_effect \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "eleven_text_to_sound_v2",
  "promptText": "Gentle rain falling on a wooden roof with distant thunder.",
  "duration": 5.5,
  "loop": true
}'

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

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

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

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

API-ключі

Створення звукових ефектів Runway

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

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

Отримайте результат

Авторизації

Тіло

Відповідь

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

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

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

Авторизації

Тіло

Відповідь

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

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

Отримайте результат