Générer des effets sonores 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,
  "loop": true
}'

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

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

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

Utilisez POST /runwayml/v1/sound_effect pour créer une tâche audio à partir d’un Prompt texte. Envoyez votre clé API CometAPI avec l’authentification Bearer et un corps de requête JSON.

Choisir un modèle

ID du modèle	Entrées requises	Contrôles facultatifs
`eleven_text_to_sound_v2`	`promptText` avec 1 à 3 000 caractères	`duration` en secondes entières, de 1 à 30 ; `loop`
`seed_audio`	`promptText` avec 1 à 2 048 caractères	Jusqu’à trois `referenceAudios` ; contrôles de la parole, du volume et de la hauteur ; format de sortie

Pour eleven_text_to_sound_v2, omettez duration pour choisir la durée à partir du Prompt. Définissez loop: true pour demander un effet sonore en boucle. Pour seed_audio, faites référence à referenceAudios dans le Prompt comme @Audio1, @Audio2, et @Audio3, dans l’ordre du tableau. Omettez referenceAudios lorsque vous n’avez pas besoin d’une référence. Remplacez chaque URL audio d’exemple par une URL HTTPS accessible de votre fichier audio. N’incluez pas duration, loop ni voice avec ce modèle sur cet endpoint.

Configurer les contrôles audio

Champ	Valeurs	Signification
`speechRate`	Entier de -50 à 100	Une valeur négative ralentit la parole ; une valeur positive l’accélère.
`loudnessRate`	Entier de -50 à 100	Une valeur négative réduit le volume ; une valeur positive l’augmente.
`pitchRate`	Entier de -12 à 12	Décalage de hauteur en demi-tons.
`sampleRate`	`8000`, `16000`, `24000`, `32000`, `44100`, `48000`	Fréquence d’échantillonnage audio en Hz.
`outputFormat`	`wav`, `mp3`, `ogg_opus`	Format audio de sortie.

Pour les trois contrôles de taux, omettez le champ ou utilisez 0 pour conserver sa valeur normale.

Récupérer le résultat

Enregistrez le id renvoyé, puis utilisez Récupérer une tâche Runway pour récupérer l’état de la tâche. Lorsque status est SUCCEEDED, lisez les URL audio dans output. Si la tâche échoue, examinez failure et failureCode.

Autorisations

Authorization

string

header

requis

Use your CometAPI API key.

Corps

application/json

eleven_text_to_sound_v2
seed_audio

Request settings for eleven_text_to_sound_v2.

model

enum<string>

requis

Model ID for this request.

Options disponibles:

eleven_text_to_sound_v2

Allowed value: "eleven_text_to_sound_v2"

promptText

string

requis

A text description of the sound effect to generate.

Required string length: 1 - 3000

duration

integer

Sound effect duration in whole seconds, from 1 to 30. Omit this field to choose duration from the prompt.

Plage requise: 1 <= x <= 30

loop

boolean

défaut:false

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

Réponse

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

string

requis

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

Dernière modification le 21 septembre 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,
  "loop": true
}'

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

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

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

Modération de contenu

Clés API

Choisir un modèle

Configurer les contrôles audio

Récupérer le résultat

Autorisations

Corps

Réponse

​Choisir un modèle

​Configurer les contrôles audio

​Récupérer le résultat

Autorisations

Corps

Réponse

Choisir un modèle

Configurer les contrôles audio

Récupérer le résultat