Rutas SRT

Usa Rutas SRT para reenviar una entrada SRT o UDP a un destino SRT sin añadir transcodificación al flujo.

Qué haceEnrutar una señal SRT a un destino

Elige este módulo cuandoDebes reenviar SRT o UDP hacia SRT sin transcodificación.

Usa otro módulo cuandoUsa Retransmisiones para transcodificación, overlays o cambios de protocolo; usa Servidores SRT para ingesta gestionada y failover.

1Selecciona la entrada2Define el destino3Inicia la ruta

POST /api/srt-routes/create

Filtrar endpoints8 endpoints

Antes de empezar

Todos los métodos requieren un x-access-token válido. Reserva los puertos de escucha locales y confirma que las URLs de destino son accesibles. Configura de forma coherente en ambos extremos el modo SRT, la latencia, la passphrase y la identidad del stream.

Qué puedes hacer

create y update configuran la entrada, la salida y los ajustes de transporte SRT.
getAll, getCount y getById consultan las rutas.
start y stop controlan la ruta de transporte.
remove elimina una ruta.

Flujo de ejemplo

Selecciona una entrada: listener SRT local, URL SRT o fuente UDP compatible.
Selecciona una salida: listener SRT local o URL SRT de destino.
Crea la ruta con los ajustes de transporte necesarios.
Iníciala y comprueba por separado la fuente y el destino.
Usa la salida de la ruta como entrada estable de otro módulo cuando sea necesario.

Casos de uso habituales

Reenviar la contribución de un recinto a una instancia regional de producción.
Conectar una fuente UDP con una ruta de entrega SRT sin transcodificación.
Exponer una señal de contribución mediante un punto de entrega SRT estable para grabación o distribución downstream.

Límites y resolución de problemas

Una ruta no repara una fuente o un destino que no estén disponibles. Los puertos del listener deben estar libres, las URLs deben ser accesibles y los parámetros SRT deben ser compatibles. Usa Retransmisiones cuando necesites transcodificación, overlays, modificaciones multimedia o más opciones de salida.

Siguientes pasos

Conecta la ruta con la Retransmisión, Grabación u otro consumidor compatible y prueba el recorrido completo.

Receta de solución REST

Enrutar o replicar SRT sin transcodificación

Crea una ruta persistente desde una fuente SRT o UDP hacia un destino SRT, iníciala y revisa el recurso.

Crear la rutaElige los presets verificados de fuente y destino SRT.POST /api/srt-routes/create
Iniciar el enrutamientoInicia tras confirmar la conectividad.POST /api/srt-routes/start
Revisar la rutaConsulta fuente, destino y estado activo.POST /api/srt-routes/getById

Usa rutas SRT para un flujo de transporte. Usa Restreams cuando necesites conversión, transcodificación, escalado, audio u overlays.

POST

/api/srt-routes/create

Requiere token de API

Crea una ruta SRT con nombre, origen, destino y estado activo inicial. Envía el JWT generado en el panel mediante la cabecera x-access-token.

La respuesta contiene la ruta y success: true. Justo después de crearla, las matrices input y output están vacías; usa getById para obtener los objetos relacionados.

Casos de uso habituales

Mantener una entrega SRT estable delante de retransmisiones cuyos destinos cambian entre eventos.
Dar a las grabaciones programadas una salida constante sin vincular cada trabajo directamente a la contribución original.
Crear una ruta bajo demanda desde vMix y utilizar start y stop para el control habitual del operador.

Ejemplos de solicitud

Elige la plantilla correspondiente al origen y el destino y añade solo los ajustes de transporte necesarios.

Puerto de escucha SRT

La ruta escucha en un puerto SRT local y se encarga de recibir la contribución entrante.

Puerto de escucha SRT a puerto de escucha SRT

Ajuste de destino: SRT listen port. La ruta expone un puerto de escucha SRT local para los consumidores posteriores que se conecten más adelante.

Puerto de escucha SRT a puerto de escucha SRT

curl --request POST \
  --url http://localhost/api/srt-routes/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "router_name": "Route from SRT listen port to SRT listen port",
  "input": {
    "input_type": "INPUT_TYPE_SRT_LISTEN",
    "input_stream_listen_port": {
      "port": 2035,
      "transport": "udp"
    },
    "input_settings": {
      "host": "0.0.0.0",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "output": {
    "output_type": "OUTPUT_TYPE_SRT_LISTEN",
    "output_stream_listen_port": {
      "port": 3035,
      "transport": "udp"
    },
    "output_settings": {
      "host": "0.0.0.0",
      "mode": "listener",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "sndbuf": 12288000,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25,
      "groupconnect": "yes",
      "groupminstabletimeo": 60,
      "conntimeo": 3000
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "active": true
}'

curl --request POST \
  --url http://localhost/api/srt-routes/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "router_name": "Route from SRT listen port to SRT listen port",
  "input": {
    "input_type": "INPUT_TYPE_SRT_LISTEN",
    "input_stream_listen_port": {
      "port": 2035,
      "transport": "udp"
    },
    "input_settings": {
      "host": "0.0.0.0",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "output": {
    "output_type": "OUTPUT_TYPE_SRT_LISTEN",
    "output_stream_listen_port": {
      "port": 3035,
      "transport": "udp"
    },
    "output_settings": {
      "host": "0.0.0.0",
      "mode": "listener",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "sndbuf": 12288000,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25,
      "groupconnect": "yes",
      "groupminstabletimeo": 60,
      "conntimeo": 3000
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "active": true
}'

Puerto de escucha SRT a URL de salida SRT

Ajuste de destino: SRT Output URL. La ruta envía de inmediato el flujo a una URL SRT de destino posterior.

Puerto de escucha SRT a URL de salida SRT

curl --request POST \
  --url http://localhost/api/srt-routes/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "router_name": "Route from SRT listen port to SRT Output URL",
  "input": {
    "input_type": "INPUT_TYPE_SRT_LISTEN",
    "input_stream_listen_port": {
      "port": 2035,
      "transport": "udp"
    },
    "input_settings": {
      "host": "0.0.0.0",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "output": {
    "output_type": "OUTPUT_TYPE_SRT_URL",
    "output_stream_url": "srt://destination.example.com:1935",
    "output_settings": {
      "host": "0.0.0.0",
      "mode": "listener",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "sndbuf": 12288000,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25,
      "groupconnect": "yes",
      "groupminstabletimeo": 60,
      "conntimeo": 3000
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "active": true
}'

curl --request POST \
  --url http://localhost/api/srt-routes/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "router_name": "Route from SRT listen port to SRT Output URL",
  "input": {
    "input_type": "INPUT_TYPE_SRT_LISTEN",
    "input_stream_listen_port": {
      "port": 2035,
      "transport": "udp"
    },
    "input_settings": {
      "host": "0.0.0.0",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "output": {
    "output_type": "OUTPUT_TYPE_SRT_URL",
    "output_stream_url": "srt://destination.example.com:1935",
    "output_settings": {
      "host": "0.0.0.0",
      "mode": "listener",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "sndbuf": 12288000,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25,
      "groupconnect": "yes",
      "groupminstabletimeo": 60,
      "conntimeo": 3000
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "active": true
}'

Puerto de escucha SRT a URL de salida UDP

Ajuste de destino: UDP Output URL. La ruta entrega el flujo a una URL UDP de destino posterior cuando el siguiente tramo requiere UDP.

Puerto de escucha SRT a URL de salida UDP

curl --request POST \
  --url http://localhost/api/srt-routes/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "router_name": "Route from SRT listen port to UDP Output URL",
  "input": {
    "input_type": "INPUT_TYPE_SRT_LISTEN",
    "input_stream_listen_port": {
      "port": 2035,
      "transport": "udp"
    },
    "input_settings": {
      "host": "0.0.0.0",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "output": {
    "output_type": "OUTPUT_TYPE_UDP_URL",
    "output_stream_url": "udp://destination.example.com:5000",
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "active": true
}'

URL de flujo SRT

La ruta obtiene el flujo desde una URL SRT de origen, en lugar de esperar en un puerto de escucha local.

URL de flujo SRT a puerto de escucha SRT

Ajuste de destino: SRT listen port. La ruta expone un puerto de escucha SRT local para los consumidores posteriores que se conecten más adelante.

URL de flujo SRT a puerto de escucha SRT

curl --request POST \
  --url http://localhost/api/srt-routes/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "router_name": "Route from SRT Stream URL to SRT listen port",
  "input": {
    "input_type": "INPUT_TYPE_SRT_URL",
    "input_stream_url": "srt://upstream.example.com:2034?mode=caller",
    "input_settings": {
      "rcvbuf": 48234496
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "output": {
    "output_type": "OUTPUT_TYPE_SRT_LISTEN",
    "output_stream_listen_port": {
      "port": 3035,
      "transport": "udp"
    },
    "output_settings": {
      "host": "0.0.0.0",
      "mode": "listener",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "sndbuf": 12288000,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25,
      "groupconnect": "yes",
      "groupminstabletimeo": 60,
      "conntimeo": 3000
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "active": true
}'

curl --request POST \
  --url http://localhost/api/srt-routes/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "router_name": "Route from SRT Stream URL to SRT listen port",
  "input": {
    "input_type": "INPUT_TYPE_SRT_URL",
    "input_stream_url": "srt://upstream.example.com:2034?mode=caller",
    "input_settings": {
      "rcvbuf": 48234496
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "output": {
    "output_type": "OUTPUT_TYPE_SRT_LISTEN",
    "output_stream_listen_port": {
      "port": 3035,
      "transport": "udp"
    },
    "output_settings": {
      "host": "0.0.0.0",
      "mode": "listener",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "sndbuf": 12288000,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25,
      "groupconnect": "yes",
      "groupminstabletimeo": 60,
      "conntimeo": 3000
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "active": true
}'

URL de flujo SRT a URL de salida SRT

Ajuste de destino: SRT Output URL. La ruta envía de inmediato el flujo a una URL SRT de destino posterior.

URL de flujo SRT a URL de salida SRT

curl --request POST \
  --url http://localhost/api/srt-routes/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "router_name": "Route from SRT Stream URL to SRT Output URL",
  "input": {
    "input_type": "INPUT_TYPE_SRT_URL",
    "input_stream_url": "srt://upstream.example.com:2034?mode=caller",
    "input_settings": {
      "rcvbuf": 48234496
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "output": {
    "output_type": "OUTPUT_TYPE_SRT_URL",
    "output_stream_url": "srt://destination.example.com:1935",
    "output_settings": {
      "host": "0.0.0.0",
      "mode": "listener",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "sndbuf": 12288000,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25,
      "groupconnect": "yes",
      "groupminstabletimeo": 60,
      "conntimeo": 3000
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "active": true
}'

URL de flujo SRT a URL de salida UDP

Ajuste de destino: UDP Output URL. La ruta entrega el flujo a una URL UDP de destino posterior cuando el siguiente tramo requiere UDP.

URL de flujo SRT a URL de salida UDP

curl --request POST \
  --url http://localhost/api/srt-routes/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "router_name": "Route from SRT Stream URL to UDP Output URL",
  "input": {
    "input_type": "INPUT_TYPE_SRT_URL",
    "input_stream_url": "srt://upstream.example.com:2034?mode=caller",
    "input_settings": {
      "rcvbuf": 48234496
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "output": {
    "output_type": "OUTPUT_TYPE_UDP_URL",
    "output_stream_url": "udp://destination.example.com:5000",
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "active": true
}'

URL de flujo UDP

La ruta lee desde una URL UDP de origen cuando el extremo de origen ya está expuesto mediante UDP.

URL de flujo UDP a puerto de escucha SRT

Ajuste de destino: SRT listen port. La ruta expone un puerto de escucha SRT local para los consumidores posteriores que se conecten más adelante.

URL de flujo UDP a puerto de escucha SRT

curl --request POST \
  --url http://localhost/api/srt-routes/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "router_name": "Route from UDP Stream URL to SRT listen port",
  "input": {
    "input_type": "INPUT_TYPE_UDP_URL",
    "input_stream_url": "udp://upstream.example.com:5000",
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "output": {
    "output_type": "OUTPUT_TYPE_SRT_LISTEN",
    "output_stream_listen_port": {
      "port": 3035,
      "transport": "udp"
    },
    "output_settings": {
      "host": "0.0.0.0",
      "mode": "listener",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "sndbuf": 12288000,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25,
      "groupconnect": "yes",
      "groupminstabletimeo": 60,
      "conntimeo": 3000
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "active": true
}'

URL de flujo UDP a URL de salida SRT

Ajuste de destino: SRT Output URL. La ruta envía de inmediato el flujo a una URL SRT de destino posterior.

URL de flujo UDP a URL de salida SRT

curl --request POST \
  --url http://localhost/api/srt-routes/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "router_name": "Route from UDP Stream URL to SRT Output URL",
  "input": {
    "input_type": "INPUT_TYPE_UDP_URL",
    "input_stream_url": "udp://upstream.example.com:5000",
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "output": {
    "output_type": "OUTPUT_TYPE_SRT_URL",
    "output_stream_url": "srt://destination.example.com:1935",
    "output_settings": {
      "host": "0.0.0.0",
      "mode": "listener",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "sndbuf": 12288000,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25,
      "groupconnect": "yes",
      "groupminstabletimeo": 60,
      "conntimeo": 3000
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "active": true
}'

URL de flujo UDP a URL de salida UDP

Ajuste de destino: UDP Output URL. La ruta entrega el flujo a una URL UDP de destino posterior cuando el siguiente tramo requiere UDP.

URL de flujo UDP a URL de salida UDP

curl --request POST \
  --url http://localhost/api/srt-routes/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "router_name": "Route from UDP Stream URL to UDP Output URL",
  "input": {
    "input_type": "INPUT_TYPE_UDP_URL",
    "input_stream_url": "udp://upstream.example.com:5000",
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "output": {
    "output_type": "OUTPUT_TYPE_UDP_URL",
    "output_stream_url": "udp://destination.example.com:5000",
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "active": true
}'

Parámetros del cuerpo de la solicitud

Ajustes básicos

router_name

string

Etiqueta en el panel: Nombre de la ruta.

Caracteres admitidos: A-Z, a-z, 0-9 y -.

Origen

input.input_type

string

Grupo del panel: Origen de la ruta SRT/UDP.

Tipo de origen de la ruta. En el panel, la opción SRT aparece como SRT Stream URL (srt://). El ejemplo actual utiliza INPUT_TYPE_SRT_URL.

input.input_stream_url

string

Etiqueta en el panel: URL del flujo SRT (srt://).

Se conecta a la dirección indicada e intenta obtener el flujo. El ejemplo actual utiliza una URL en modo listener: srt://0.0.0.0:2034?mode=listener.

Ajustes avanzados del origen

input.input_settings.rcvbuf

integer

Etiqueta en el panel: Tamaño del búfer del receptor.

Es un ajuste avanzado opcional de la entrada SRT. La ayuda del panel indica un tamaño predeterminado de 12058624 bytes y un valor recomendado de 48234496 bytes. Las pruebas de rutas en producción confirman que la API acepta este campo y que getById lo devuelve cuando está configurado.

Origen

input.module_name

string

Nombre del módulo de entrada. Usa MODULE_SRT_ROUTERS para una ruta SRT.

Destino

output.output_type

string

Grupo del panel: Destino de la ruta SRT.

Etiqueta en el panel: Destino del flujo.

En el panel, la opción de destino SRT aparece como SRT Output URL (srt://). El ejemplo actual utiliza OUTPUT_TYPE_SRT_URL.

output.output_stream_url

string

Etiqueta en el panel: URL del flujo de salida.

Indica la dirección de la plataforma de streaming o del destino del flujo. El ejemplo actual utiliza srt://0.0.0.0:2035.

output.module_name

string

Nombre del módulo de salida. Usa MODULE_SRT_ROUTERS para una ruta SRT.

Origen

input.input_stream_listen_port.port

integer

Ajuste de origen en escucha: Puerto SRT.

Cuando el origen de la ruta se crea con el ajuste de puerto de escucha del panel, el puerto predeterminado es 2035. Es la alternativa práctica a input.input_stream_url.

Ajustes avanzados del origen

input.input_settings.host

string

Etiqueta en el panel: Host de escucha SRT.

Dirección IP local a la que se enlaza. La ayuda del panel indica expresamente 0.0.0.0 para todas las interfaces y 127.0.0.1 para aceptar solo conexiones locales. El valor predeterminado es 0.0.0.0.

input.input_settings.latency

integer

Etiqueta en el panel: Latencia.

Define la latencia máxima de transmisión aceptada. El valor predeterminado actual del panel para los ajustes SRT de una ruta es 500 ms.

input.input_settings.rcvlatency

integer

Etiqueta en el panel: Latencia del receptor.

Retardo mínimo del búfer del receptor antes de que la aplicación reciba el paquete. El valor predeterminado actual del panel es 200 ms.

input.input_settings.fc

integer

Etiqueta en el panel: Tamaño de la ventana de control de flujo.

Limita el número máximo de paquetes en tránsito. El valor predeterminado actual del panel es 25600 paquetes.

input.input_settings.inputbw

integer

Etiqueta en el panel: Ancho de banda de entrada.

Configúralo con el bitrate previsto del flujo en directo. El valor predeterminado actual del panel es 750000 Byte/s.

input.input_settings.oheadbw

integer

Etiqueta en el panel: Ancho de banda de recuperación.

Margen de ancho de banda adicional sobre el ancho de banda de entrada, expresado como porcentaje. El valor predeterminado actual del panel es 25%.

input.input_settings.maxbw

integer

Etiqueta en el panel: Límite de ancho de banda.

Usa 0 para aplicar el límite de ancho de banda predeterminado.

input.input_settings.streamid

string

Etiqueta en el panel: ID de flujo (opcional).

Disponible en el bloque de configuración del origen o puerto de escucha SRT.

input.input_settings.passphrase

string

Etiqueta en el panel: Frase de contraseña (opcional).

Contraseña para la transmisión cifrada. La ayuda del panel indica que debe tener entre 10 y 79 caracteres.

Destino

output.output_stream_listen_port.port

integer

Ajuste de destino en escucha: Puerto SRT.

Cuando el destino de la ruta se crea con el ajuste de puerto de escucha del panel, el puerto predeterminado es 3035. Es la alternativa práctica a output.output_stream_url.

Ajustes avanzados del destino

output.output_settings.host

string

Etiqueta en el panel: Host SRT.

En modo listener, es la IP local a la que se enlaza; en modo caller o rendezvous, es la IP remota a la que se conecta. El valor predeterminado actual del panel es 0.0.0.0.

output.output_settings.mode

string

Etiqueta en el panel: Modo.

Los valores posibles son caller, listener o rendezvous. El valor predeterminado actual del panel es la segunda opción de modo SRT, que corresponde al formulario de ruta predeterminado mostrado en la interfaz.

output.output_settings.latency

integer

Etiqueta en el panel: Latencia.

Define la latencia máxima de transmisión aceptada. El valor predeterminado actual del panel es 500 ms.

output.output_settings.rcvlatency

integer

Etiqueta en el panel: Latencia del receptor.

Retardo mínimo del búfer del receptor antes de entregar los datos a la aplicación receptora. El valor predeterminado actual del panel es 200 ms.

output.output_settings.fc

integer

Etiqueta en el panel: Tamaño de la ventana de control de flujo.

El valor predeterminado actual del panel es 25600 paquetes.

output.output_settings.sndbuf

integer

Etiqueta en el panel: Tamaño del búfer del emisor.

El valor predeterminado actual del panel es 12288000 bytes.

output.output_settings.rcvbuf

integer

Etiqueta en el panel: Tamaño del búfer del receptor.

El valor predeterminado actual del panel es 12288000 bytes.

output.output_settings.inputbw

integer

Etiqueta en el panel: Ancho de banda de entrada.

El valor predeterminado actual del panel es 750000 Byte/s.

output.output_settings.oheadbw

integer

Etiqueta en el panel: Ancho de banda de recuperación.

El valor predeterminado actual del panel es 25%.

output.output_settings.streamid

string

Etiqueta en el panel: ID de flujo (opcional).

La ayuda del panel indica que solo puede configurarse en modo Caller.

output.output_settings.passphrase

string

Etiqueta en el panel: Frase de contraseña (opcional).

Contraseña para la transmisión cifrada. La ayuda del panel indica que debe tener entre 10 y 79 caracteres.

output.output_settings.enforcedencryption

string

Etiqueta en el panel: Cifrado obligatorio.

Exige que ambos extremos de la conexión usen la misma frase de contraseña o que ambos la omitan. En cualquier otro caso, se rechaza la conexión.

output.output_settings.groupconnect

string

Etiqueta en el panel: Aceptar conexiones de grupo.

Cuando se activa en un socket listener, permite que ese socket acepte conexiones de grupo.

output.output_settings.groupminstabletimeo

integer

Etiqueta en el panel: Tiempo de espera de estabilidad del grupo.

El valor predeterminado actual del panel es 60 ms.

output.output_settings.conntimeo

integer

Etiqueta en el panel: Tiempo de espera de la conexión.

Se aplica a los modos de conexión caller y rendezvous. El valor predeterminado actual del panel es 3000 ms.

Estado de la ruta

active

boolean

Etiqueta en el panel: Activar tras crearla.

Determina si la ruta debe activarse inmediatamente después de su creación.

Respuesta

_id

string

Identificador de la nueva ruta SRT.

string

Alias práctico del identificador de la ruta creada. En las respuestas de producción, id coincide con _id.

router_name

string

Nombre guardado para la ruta creada.

input

array

Inmediatamente después de crearla, el producto devuelve en producción una lista input vacía en el nivel superior. Usa getById para obtener los objetos de entrada completos.

output

array

Inmediatamente después de crearla, el producto devuelve en producción una lista output vacía en el nivel superior. Usa getById para obtener los objetos de salida completos.

active

boolean

Indica si la ruta queda activada después de crearla.

created

string

Marca de tiempo de creación que devuelve el producto en producción.

success

boolean

El producto devuelve un indicador booleano de éxito junto con el objeto de la ruta creada. Cuando la operación se completa correctamente, su valor es true.

Respuesta: Crear ruta SRT

JSON

POST

/api/srt-routes/getAll

Requiere token de API

Lista las rutas SRT visibles para el usuario autenticado.

El cuerpo admite paginación y ordenación opcionales. La respuesta es una matriz de rutas sin objeto contenedor.

Cada elemento incluye nombre, estado activo y los objetos input y output, por lo que resulta adecuado para paneles e inventarios.

Parámetros del cuerpo de la solicitud

Paginación

limit

integer

Número máximo de rutas que se devolverán en una página de respuesta.

skip

integer

Desplazamiento utilizado para la paginación. Usa 0 para obtener la primera página.

sort.created

integer

Dirección de ordenación según la marca de tiempo de creación de la ruta. Usa 1 para ordenar de forma ascendente.

Listar rutas SRT

Respuesta

Lista de respuesta

[]

array

El producto devuelve en producción una lista de objetos de ruta SRT sin envoltorio.

router_name

string

Nombre de cada ruta SRT incluida en la lista.

Origen

input[]

array

Objetos de entrada completos asociados a la ruta, incluidos el tipo de entrada, la URL del flujo de entrada y los input_settings opcionales, como rcvbuf, cuando están configurados.

Destino

output[]

array

Objetos de salida completos asociados a la ruta, incluidos el tipo de salida y la URL del flujo de salida.

active

boolean

Indica si el recurso está activo.

success

boolean

Actualmente, cada elemento devuelto incluye success: true en la respuesta de producción.

Respuesta: Listar rutas SRT

JSON

[
  {
    "_id": "69c1de8e28c95839e0dffb74",
    "router_name": "Awesome SRT route updated",
    "input": [
      {
        "_id": "69c1de8e28c95839e0dffb91",
        "input_type": "INPUT_TYPE_SRT_URL",
        "input_stream_url": "srt://0.0.0.0:2034?mode=listener",
        "module_name": "MODULE_SRT_ROUTERS",
        "__v": 0
      }
    ],
    "output": [
      {
        "_id": "69c1de8e28c95839e0dffb94",
        "output_type": "OUTPUT_TYPE_SRT_URL",
        "output_stream_url": "srt://0.0.0.0:2035",
        "module_name": "MODULE_SRT_ROUTERS",
        "__v": 0
      }
    ],
    "active": false,
    "user_id": "69360341db559495f643de6a",
    "created": "2026-03-24T00:45:02.729Z",
    "__v": 0,
    "modified": "2026-03-24T00:45:02.886Z",
    "id": "69c1de8e28c95839e0dffb74",
    "success": true
  }
]

POST

/api/srt-routes/getById

Requiere token de API

Obtén una ruta SRT mediante su ID.

Envía el id en el cuerpo. La respuesta contiene la ruta completa con las matrices input y output expandidas.

Úsalo antes de actualizar o al mostrar todos los datos del origen y el destino.

Parámetros del cuerpo de la solicitud

string

Identificador de la ruta SRT que se quiere cargar.

Obtener ruta SRT por ID

Respuesta

_id

string

Identificador de la ruta solicitada.

router_name

string

Nombre de la ruta solicitada.

input[]

array

Objetos de entrada completos del origen de la ruta. Cuando se usan ajustes avanzados de entrada SRT, el producto también los devuelve en input_settings.

output[]

array

Objetos de salida completos del destino de la ruta.

active

boolean

Indica si el recurso está activo.

success

boolean

El producto devuelve en producción el objeto de la ruta solicitada junto con success: true.

Respuesta: Obtener ruta SRT por ID

JSON

{
  "_id": "69c1de8e28c95839e0dffb74",
  "router_name": "Awesome SRT route updated",
  "input": [
    {
      "_id": "69c1de8e28c95839e0dffb91",
      "input_type": "INPUT_TYPE_SRT_URL",
      "input_stream_url": "srt://0.0.0.0:2034?mode=listener",
      "module_name": "MODULE_SRT_ROUTERS",
      "__v": 0
    }
  ],
  "output": [
    {
      "_id": "69c1de8e28c95839e0dffb94",
      "output_type": "OUTPUT_TYPE_SRT_URL",
      "output_stream_url": "srt://0.0.0.0:2035",
      "module_name": "MODULE_SRT_ROUTERS",
      "__v": 0
    }
  ],
  "active": false,
  "user_id": "69360341db559495f643de6a",
  "created": "2026-03-24T00:45:02.729Z",
  "__v": 0,
  "modified": "2026-03-24T00:45:02.886Z",
  "id": "69c1de8e28c95839e0dffb74",
  "success": true
}

POST

/api/srt-routes/update

Requiere token de API

Actualiza una ruta SRT mediante su ID.

Envía el id junto con el origen, el destino y el estado activo completos.

La respuesta contiene la ruta y success: true. Las matrices input y output quedan vacías en esta respuesta; usa getById para obtener los objetos relacionados.

Parámetros del cuerpo de la solicitud

string

Identificador de la ruta que se quiere actualizar.

router_name

string

Nuevo nombre de la ruta.

input

object

Nuevo objeto de configuración del origen de la ruta.

output

object

Nuevo objeto de configuración del destino de la ruta.

active

boolean

Nuevo estado de activación de la ruta.

Actualizar ruta SRT

curl --request POST \
  --url http://localhost/api/srt-routes/update \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "SRT_ROUTE_ID",
  "router_name": "Awesome SRT route updated",
  "input": {
    "input_type": "INPUT_TYPE_SRT_URL",
    "input_stream_url": "srt://upstream.example.com:2034?mode=caller",
    "input_settings": {
      "rcvbuf": 48234496
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "output": {
    "output_type": "OUTPUT_TYPE_SRT_URL",
    "output_stream_url": "srt://destination.example.com:1935",
    "output_settings": {
      "host": "0.0.0.0",
      "mode": "listener",
      "latency": 500,
      "rcvlatency": 200,
      "fc": 25600,
      "sndbuf": 12288000,
      "rcvbuf": 12288000,
      "inputbw": 750000,
      "oheadbw": 25,
      "groupconnect": "yes",
      "groupminstabletimeo": 60,
      "conntimeo": 3000
    },
    "module_name": "MODULE_SRT_ROUTERS"
  },
  "active": true
}'

Respuesta

router_name

string

Nombre actualizado de la ruta que devuelve el producto en producción.

modified

string

Marca de tiempo de modificación establecida por el producto.

input

array

Inmediatamente después de actualizarla, el producto devuelve actualmente las listas de nivel superior input y output vacías.

success

boolean

El producto devuelve en producción el objeto de la ruta actualizado junto con success: true.

Respuesta: Actualizar ruta SRT

JSON

POST

/api/srt-routes/start

Requiere token de API

Inicia una ruta SRT mediante su ID.

Envía el id en el cuerpo. La respuesta contiene la ruta y success: true; active: true confirma el inicio y input y output contienen IDs relacionados.

Nota para vMix: asigna este método a un botón o trigger cuando la ruta ya existe y el operador solo necesita activarla.

Parámetros del cuerpo de la solicitud

string

Identificador de la ruta que se quiere iniciar.

Iniciar ruta SRT

Respuesta

input

array

Después de iniciarla, el producto devuelve input como una lista de ID de objetos de entrada vinculados.

output

array

Después de iniciarla, el producto devuelve output como una lista de ID de objetos de salida vinculados.

active

boolean

Pasa a true cuando la ruta se inicia correctamente.

success

boolean

El producto devuelve en producción el objeto de la ruta actualizado junto con success: true.

Respuesta: Iniciar ruta SRT

JSON

POST

/api/srt-routes/stop

Requiere token de API

Detiene una ruta SRT mediante su ID.

Envía el id en el cuerpo. La respuesta contiene la ruta y success: true; active: false confirma la detención y input y output conservan los IDs relacionados.

Nota para vMix: combínalo con Start SRT route para desactivar una ruta sin eliminarla.

Parámetros del cuerpo de la solicitud

string

Identificador de la ruta que se quiere detener.

Detener ruta SRT

Respuesta

input

array

Después de detenerla, el producto sigue devolviendo ID de objetos de entrada vinculados, no objetos completos.

output

array

Después de detenerla, el producto sigue devolviendo ID de objetos de salida vinculados, no objetos completos.

active

boolean

Pasa a false cuando la ruta se detiene correctamente.

success

boolean

El producto devuelve en producción el objeto de la ruta actualizado junto con success: true.

Respuesta: Detener ruta SRT

JSON

POST

/api/srt-routes/getCount

Requiere token de API

DELETE

/api/srt-routes/remove

Requiere token de API

AnteriorServidores RTMP SiguienteDispositivos NDI detectados