Generer Runway-lydeffekter

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>"
  }
}

Bruk POST /runwayml/v1/sound_effect til å opprette en lydoppgave fra en tekst-Prompt. Send CometAPI API-nøkkelen din med Bearer-autentisering og en JSON-forespørselstekst.

Velg en modell

Modell-ID	Påkrevde inndata	Valgfrie kontroller
`eleven_text_to_sound_v2`	`promptText` med 1–3000 tegn	`duration` fra 0,5 til 30 sekunder, inkludert brøkdeler av sekunder; `loop`
`seed_audio`	`promptText` med 1–2048 tegn	Opptil tre `referenceAudios`; kontroller for tale, lydstyrke og tonehøyde; utdataformat

For eleven_text_to_sound_v2 kan du utelate duration for å velge lengden fra Prompten. Angi loop: true for å be om en repeterende lydeffekt. For seed_audio kan du referere til referenceAudios i Prompten som @Audio1, @Audio2, og @Audio3, i matrise-rekkefølge. Utelat referenceAudios når du ikke trenger en referanse. Erstatt hver eksempel-URL for lyd med en tilgjengelig HTTPS-URL til lydfilen din. Ikke inkluder duration, loop eller voice med denne modellen på dette endepunktet.

Konfigurer lydkontroller

Felt	Verdier	Betydning
`speechRate`	Heltall fra -50 til 100	Negativ verdi senker talehastigheten, mens positiv verdi øker den.
`loudnessRate`	Heltall fra -50 til 100	Negativ verdi reduserer lydstyrken, mens positiv verdi øker den.
`pitchRate`	Heltall fra -12 til 12	Endring av tonehøyde i halvtoner.
`sampleRate`	`8000`, `16000`, `24000`, `32000`, `44100`, `48000`	Lydsamplingsfrekvens i Hz.
`outputFormat`	`wav`, `mp3`, `ogg_opus`	Lydformat for utdata.

For de tre rate-kontrollene kan du utelate feltet eller bruke 0 for å beholde normalverdien.

Hent resultatet

Lagre den returnerte id, og bruk deretter Hent en Runway-oppgave for å hente oppgavestatus. Når status er SUCCEEDED, kan du lese lyd-URL-ene i output. Hvis oppgaven mislykkes, kan du undersøke failure og failureCode.

Autorisasjoner

Authorization

string

header

påkrevd

Use your CometAPI API key.

Kropp

application/json

eleven_text_to_sound_v2
seed_audio

Request settings for eleven_text_to_sound_v2.

model

enum<string>

påkrevd

Model ID for this request.

Tilgjengelige alternativer:

eleven_text_to_sound_v2

Allowed value: "eleven_text_to_sound_v2"

promptText

string

påkrevd

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.

Nødvendig område: 0.5 <= x <= 30

loop

boolean

standard:false

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

Svar

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

string

påkrevd

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

Sist endret 18. september 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>"
  }
}

Innholdsmoderering

API-nøkler

Velg en modell

Konfigurer lydkontroller

Hent resultatet

Autorisasjoner

Kropp

Svar

​Velg en modell

​Konfigurer lydkontroller

​Hent resultatet

Autorisasjoner

Kropp

Svar

Velg en modell

Konfigurer lydkontroller

Hent resultatet