Generare effetti sonori 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 per creare un’attività audio da un Prompt di testo. Invia la tua chiave API CometAPI con l’autenticazione Bearer e un corpo della richiesta JSON.

Scegli un modello

ID modello	Input obbligatori	Controlli facoltativi
`eleven_text_to_sound_v2`	`promptText` con 1–3000 caratteri	`duration` da 0,5 a 30 secondi, inclusi i secondi frazionari; `loop`
`seed_audio`	`promptText` con 1–2048 caratteri	Fino a tre `referenceAudios`; controlli di voce, volume e tonalità; formato di output

Per eleven_text_to_sound_v2, ometti duration per scegliere la durata dal Prompt. Imposta loop: true per richiedere un effetto sonoro ripetuto. Per seed_audio, fai riferimento a referenceAudios nel Prompt come @Audio1, @Audio2, e @Audio3, nell’ordine dell’array. Ometti referenceAudios quando non ti serve un riferimento. Sostituisci ogni URL audio di esempio con un URL HTTPS accessibile del tuo file audio. Non includere duration, loop o voice con questo modello su questo endpoint.

Configura i controlli audio

Campo	Valori	Significato
`speechRate`	Intero da -50 a 100	Un valore negativo rallenta la voce; un valore positivo la accelera.
`loudnessRate`	Intero da -50 a 100	Un valore negativo riduce il volume; un valore positivo lo aumenta.
`pitchRate`	Intero da -12 a 12	Spostamento della tonalità in semitoni.
`sampleRate`	`8000`, `16000`, `24000`, `32000`, `44100`, `48000`	Frequenza di campionamento audio in Hz.
`outputFormat`	`wav`, `mp3`, `ogg_opus`	Formato audio di output.

Per i tre controlli di regolazione, ometti il campo o usa 0 per mantenere il valore normale.

Recupera il risultato

Salva il valore id restituito, quindi usa Ottieni un’attività Runway per recuperare lo stato dell’attività. Quando status è SUCCEEDED, leggi gli URL audio in output. Se l’attività non riesce, controlla failure e failureCode.

Autorizzazioni

Authorization

string

header

obbligatorio

Use your CometAPI API key.

Corpo

application/json

eleven_text_to_sound_v2
seed_audio

Request settings for eleven_text_to_sound_v2.

model

enum<string>

obbligatorio

Model ID for this request.

Opzioni disponibili:

eleven_text_to_sound_v2

Allowed value: "eleven_text_to_sound_v2"

promptText

string

obbligatorio

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.

Intervallo richiesto: 0.5 <= x <= 30

loop

boolean

predefinito:false

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

Risposta

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

string

obbligatorio

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

Ultima modifica il 18 settembre 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>"
  }
}

Moderazione dei contenuti

Chiavi API

Scegli un modello

Configura i controlli audio

Recupera il risultato

Autorizzazioni

Corpo

Risposta

​Scegli un modello

​Configura i controlli audio

​Recupera il risultato

Autorizzazioni

Corpo

Risposta

Scegli un modello

Configura i controlli audio

Recupera il risultato