Convertire il parlato di 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>"
  }
}

Usa POST /runwayml/v1/speech_to_speech per convertire il dialogo registrato in una voce predefinita. Usa l’ID modello eleven_multilingual_sts_v2. Invia la chiave API CometAPI con l’autenticazione Bearer e un corpo della richiesta JSON.

Fornire dialogo e una voce

Campo	Valore richiesto
`model`	`eleven_multilingual_sts_v2`
`media.type`	`audio` per un file audio o `video` per un video contenente dialogo
`media.uri`	URL HTTPS accessibile del file sorgente
`voice.type`	`runway-preset`
`voice.presetId`	Una voce predefinita dallo schema della richiesta, ad esempio `Maya`

Sostituisci l’URL del file multimediale di esempio con quello del file sorgente. Se usi un video, modifica media.type in video e fornisci il relativo URL video in media.uri. Imposta removeBackgroundNoise: true per rimuovere il rumore di fondo dal parlato generato. Ometti questo campo per usare l’impostazione predefinita del modello.

Recuperare il risultato

Salva il valore id restituito, quindi usa Recupera un’attività Runway per recuperare lo stato dell’attività. Quando status è SUCCEEDED, scarica i contenuti multimediali risultanti dagli URL in output. Se l’attività non riesce, esamina failure e failureCode.

Autorizzazioni

Authorization

string

header

obbligatorio

Use your CometAPI API key.

Corpo

application/json

Request settings for eleven_multilingual_sts_v2.

model

enum<string>

obbligatorio

Model ID for this request.

Opzioni disponibili:

eleven_multilingual_sts_v2

Allowed value: "eleven_multilingual_sts_v2"

media

SpeechToSpeechAudio · object

obbligatorio

Audio or video file containing the dialogue to convert.

SpeechToSpeechAudio
SpeechToSpeechVideo

Show child attributes

voice

RunwayPresetVoice · object

obbligatorio

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.

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

Moderazione dei contenuti

Chiavi API

Fornire dialogo e una voce

Recuperare il risultato

Autorizzazioni

Corpo

Risposta

​Fornire dialogo e una voce

​Recuperare il risultato

Autorizzazioni

Corpo

Risposta

Fornire dialogo e una voce

Recuperare il risultato