Convertir voz de 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 para convertir diálogo grabado en una voz predefinida. Usa el ID de modelo eleven_multilingual_sts_v2. Envía tu clave de API de CometAPI con autenticación Bearer y un cuerpo de solicitud JSON.

Proporciona diálogo y una voz

Campo	Valor obligatorio
`model`	`eleven_multilingual_sts_v2`
`media.type`	`audio` para un archivo de audio o `video` para un video que contenga diálogo
`media.uri`	URL HTTPS accesible del archivo de origen
`voice.type`	`runway-preset`
`voice.presetId`	Una voz predefinida del esquema de solicitud, como `Maya`

Reemplaza la URL de medios de ejemplo por tu archivo de origen. Si usas un video, cambia media.type por video y proporciona su URL de video en media.uri. Establece removeBackgroundNoise: true para eliminar el ruido de fondo de la voz generada. Omite este campo para usar el valor predeterminado del modelo.

Recupera el resultado

Guarda el id devuelto y luego usa Obtener una tarea de Runway para recuperar el estado de la tarea. Cuando status sea SUCCEEDED, descarga los resultados multimedia de las URL en output. Si la tarea falla, inspecciona failure y failureCode.

Autorizaciones

Authorization

string

header

requerido

Use your CometAPI API key.

Cuerpo

application/json

Request settings for eleven_multilingual_sts_v2.

model

enum<string>

requerido

Model ID for this request.

Opciones disponibles:

eleven_multilingual_sts_v2

Allowed value: "eleven_multilingual_sts_v2"

media

SpeechToSpeechAudio · object

requerido

Audio or video file containing the dialogue to convert.

SpeechToSpeechAudio
SpeechToSpeechVideo

Show child attributes

voice

RunwayPresetVoice · object

requerido

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.

Respuesta

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

string

requerido

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

Última modificación el 18 de septiembre de 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>"
  }
}

Moderación de contenido

Claves API

Proporciona diálogo y una voz

Recupera el resultado

Autorizaciones

Cuerpo

Respuesta

​Proporciona diálogo y una voz

​Recupera el resultado

Autorizaciones

Cuerpo

Respuesta

Proporciona diálogo y una voz

Recupera el resultado