Generar efectos de sonido de 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>"
  }
}

Usa POST /runwayml/v1/sound_effect para crear una tarea de audio a partir de un Prompt de texto. Envía tu clave de API de CometAPI con autenticación Bearer y un cuerpo de solicitud JSON.

Elige un modelo

ID del modelo	Entradas obligatorias	Controles opcionales
`eleven_text_to_sound_v2`	`promptText` con entre 1 y 3000 caracteres	`duration` de 0,5 a 30 segundos, incluidos los segundos fraccionarios; `loop`
`seed_audio`	`promptText` con entre 1 y 2048 caracteres	Hasta tres `referenceAudios`; controles de voz, volumen y tono; formato de salida

Para eleven_text_to_sound_v2, omite duration para elegir la duración según el Prompt. Establece loop: true para solicitar un efecto de sonido repetitivo. Para seed_audio, menciona referenceAudios en el Prompt como @Audio1, @Audio2, y @Audio3, en el orden del array. Omite referenceAudios cuando no necesites una referencia. Reemplaza cada URL de audio de ejemplo por una URL HTTPS accesible de tu archivo de audio. No incluyas duration, loop ni voice con este modelo en este endpoint.

Configurar controles de audio

Campo	Valores	Significado
`speechRate`	Entero de -50 a 100	Los valores negativos ralentizan la voz; los positivos la aceleran.
`loudnessRate`	Entero de -50 a 100	Los valores negativos reducen el volumen; los positivos lo aumentan.
`pitchRate`	Entero de -12 a 12	Cambio de tono en semitonos.
`sampleRate`	`8000`, `16000`, `24000`, `32000`, `44100`, `48000`	Frecuencia de muestreo de audio en Hz.
`outputFormat`	`wav`, `mp3`, `ogg_opus`	Formato de audio de salida.

Para los tres controles de velocidad, omite el campo o usa 0 para conservar su valor normal.

Recuperar el resultado

Guarda el id devuelto y luego usa Obtener una tarea de Runway para recuperar el estado de la tarea. Cuando status sea SUCCEEDED, lee las URL de audio en output. Si la tarea falla, inspecciona failure y failureCode.

Autorizaciones

Authorization

string

header

requerido

Use your CometAPI API key.

Cuerpo

application/json

eleven_text_to_sound_v2
seed_audio

Request settings for eleven_text_to_sound_v2.

model

enum<string>

requerido

Model ID for this request.

Opciones disponibles:

eleven_text_to_sound_v2

Allowed value: "eleven_text_to_sound_v2"

promptText

string

requerido

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.

Rango requerido: 0.5 <= x <= 30

loop

boolean

predeterminado:false

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

Respuesta

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

string

requerido

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

Última modificación el 18 de septiembre de 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>"
  }
}

Moderación de contenido

Claves API

Elige un modelo

Configurar controles de audio

Recuperar el resultado

Autorizaciones

Cuerpo

Respuesta

​Elige un modelo

​Configurar controles de audio

​Recuperar el resultado

Autorizaciones

Cuerpo

Respuesta

Elige un modelo

Configurar controles de audio

Recuperar el resultado