Convertir la parole avec Runway

POST

runwayml

speech_to_speech

curl https://api.cometapi.com/runwayml/v1/speech_to_speech \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "eleven_multilingual_sts_v2",
  "media": {
    "type": "audio",
    "uri": "https://your-audio-host/source-speech.mp3"
  },
  "voice": {
    "type": "runway-preset",
    "presetId": "Maya"
  }
}'

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

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

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

Utilisez POST /runwayml/v1/speech_to_speech pour convertir des dialogues enregistrés en une voix prédéfinie. Utilisez l’ID de modèle eleven_multilingual_sts_v2. Envoyez votre clé API CometAPI avec l’authentification Bearer et un corps de requête JSON.

Fournir un dialogue et une voix

Champ	Valeur requise
`model`	`eleven_multilingual_sts_v2`
`media.type`	`audio` pour un fichier audio ou `video` pour une vidéo contenant des dialogues
`media.uri`	URL HTTPS accessible du fichier source
`voice.type`	`runway-preset`
`voice.presetId`	Une voix prédéfinie du schéma de requête, telle que `Maya`

Remplacez l’URL multimédia d’exemple par votre fichier source. Si vous utilisez une vidéo, remplacez media.type par video et fournissez son URL vidéo dans media.uri. Définissez removeBackgroundNoise: true pour supprimer le bruit de fond de la parole générée parole. Omettez ce champ pour utiliser la valeur par défaut du modèle.

Récupérer le résultat

Enregistrez le id renvoyé, puis utilisez Obtenir une tâche Runway pour récupérer l’état de la tâche. Lorsque status est SUCCEEDED, téléchargez le fichier résultant multimédia depuis les URL dans output. En cas d’échec de la tâche, examinez failure et failureCode.

Autorisations

Authorization

string

header

requis

Use your CometAPI API key.

Corps

application/json

Request settings for eleven_multilingual_sts_v2.

model

enum<string>

requis

Model ID for this request.

Options disponibles:

eleven_multilingual_sts_v2

Allowed value: "eleven_multilingual_sts_v2"

media

SpeechToSpeechAudio · object

requis

Audio or video file containing the dialogue to convert.

SpeechToSpeechAudio
SpeechToSpeechVideo

Show child attributes

voice

RunwayPresetVoice · object

requis

The voice to use for the generated speech.

Show child attributes

removeBackgroundNoise

boolean

Set true to remove background noise from the generated speech. Omit or use false for the model default.

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/speech_to_speech \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "eleven_multilingual_sts_v2",
  "media": {
    "type": "audio",
    "uri": "https://your-audio-host/source-speech.mp3"
  },
  "voice": {
    "type": "runway-preset",
    "presetId": "Maya"
  }
}'

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

Fournir un dialogue et une voix

Récupérer le résultat

Autorisations

Corps

Réponse

​Fournir un dialogue et une voix

​Récupérer le résultat

Autorisations

Corps

Réponse

Fournir un dialogue et une voix

Récupérer le résultat