API de vídeo para desarrolladores

Una API de streaming de vídeo para la subida reanudable, la transcodificación en paralelo, el DRM Widevine y FairPlay, los directos, la entrega por CDN y la analítica. Tu agente de IA gestiona vídeos, directos y analítica a través del servidor MCP, y tus apps los reproducen con SDK nativos y multiplataforma.

Conecta tu agente de IA a Kinescope

Kinescope MCP Server, ahora en beta pública, deja que Cursor, Claude Desktop, Claude Code y otros clientes MCP trabajen con tu espacio de trabajo en lenguaje natural. Usa tu token de API y los permisos de tu cuenta, y las operaciones de borrado están desactivadas.

Qué puede hacer tu agente

  • Vídeos Busca por título, descripción y etiquetas, edita metadatos y privacidad, copia y mueve vídeos entre proyectos.
  • Proyectos Crea proyectos y ordena los vídeos en carpetas y listas de reproducción.
  • Analítica Reproducciones, interacción, geografía de la audiencia e informes a medida.
  • Directos Crea y programa eventos, configura la retransmisión y descarga las grabaciones.
  • Subtítulos y capítulos Añade archivos de subtítulos, lee el texto de los subtítulos y actualiza capítulos con marcas de tiempo.
  • Y más Pósteres, materiales complementarios, solicitudes de subida y estadísticas de uso y facturación.
mcp.json Cursor Claude Code Qwen3
{
  "mcpServers": {
    "Kinescope MCP": {
      "type": "streamable-http",
      "url": "https://api.kinescope.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Claude Desktop terminal
npx -y @smithery/cli@latest mcp add kinescope/kinescope-mcp --client claude

Después, pídele

  • Muestra las estadísticas de reproducción de todos los vídeos del proyecto «Marketing» del último mes
  • Crea un directo «Lanzamiento del producto Q4» para la semana que viene
  • Añade capítulos al vídeo: en 5:30, «Visión general de la API»; en 12:15, «Precios»

Lanza funciones de vídeo antes. La infraestructura corre de nuestra cuenta.

Kinescope opera su propio CDN de vídeo, con capacidad propia y sin reventa, y puntos de presencia en Latinoamérica, Estados Unidos, Europa y la CEI. La señal en directo entra por RTMP, RTMPS y SRT en servidores de ingesta de cuatro continentes.

Norteamérica Brasil Europa CEI Asia
Servidores de ingesta para directos: Norteamérica, Brasil, Europa, Asia y la CEI. Lista de servidores
de disponibilidad (SLA)
99,98 %
vídeos subidos
+100 M
minutos vistos al día
5 M
directos emitidos a través de la API
+10.000
  • RTMP
  • RTMPS
  • SRT
  • HLS
  • CMAF
  • LL-HLS
  • Widevine
  • FairPlay

De la subida a la reproducción protegida en tres pasos

Tres fragmentos de la documentación: la API de subida y transcodificación recibe el archivo, un iframe lo reproduce y tu backend decide quién lo ve. Sustituye el token de API y los ID por los tuyos.

  1. 1

    Subir

    Importa un archivo por URL, como aquí, súbelo en una sola petición o crea un enlace de subida para apps cliente. Los archivos grandes van por partes con TUS.

    cURL · importar por URL
    curl -X POST https://uploader.kinescope.io/v2/video \
      -H "Authorization: Bearer $KINESCOPE_API_TOKEN" \
      -H "X-Parent-ID: $PARENT_ID" \
      -H "X-Video-Title: Clase 1" \
      -H "X-Video-URL: https://example.com/clase-1.mp4"
  2. 2

    Insertar

    Kinescope codifica cada vídeo subido en versiones adaptativas de hasta 4K. Pega el iframe o controla el reproductor desde JavaScript con la IFrame Player API.

    HTML · iframe
    <iframe src="https://kinescope.io/embed/VIDEO_ID"
      allow="autoplay; fullscreen; picture-in-picture; encrypted-media;"
      frameborder="0" allowfullscreen
      width="560" height="315"></iframe>
  3. 3

    Proteger

    Activa el DRM y conecta Kinescope a tu backend de autorización. Antes de emitir la clave de descifrado, Kinescope consulta a tu servidor, y tu 200 o 403 decide quién ve el vídeo.

    cURL · backend de autorización
    curl -X PUT https://api.kinescope.io/v1/drm/auth \
      -H "Authorization: Bearer $KINESCOPE_API_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"url": "https://api.example.com/drm/authorize"}'
    
    # El espectador llega desde la inserción: ?drmauthtoken=USER_JWT
    # Responde 200 para permitir la reproducción o 403 para denegarla.

Controla el reproductor desde tu código

Un reproductor real de Kinescope. Cada botón llama a un método de la IFrame Player API, el panel muestra el código que se ha ejecutado y el registro muestra los eventos que devuelve el reproductor.

currentTime
0
paused
true
playbackRate
1
quality
—
volume
1
muted
false
Reproducción
Velocidad
Calidad
Sonido
Subtítulos
player.js
import { load } from '@kinescope/player-iframe-api-loader';

const factory = await load();
const player = await factory.create('player', {
  url: 'https://kinescope.io/56Jg27MqvvttAwHcrCzEA4',
  size: { width: '100%', height: '100%' },
});

player.on(player.Events.TimeUpdate, ({ data }) => {
  console.log(data.currentTime, data.percent);
});
// Pulsa un botón de la izquierda para ejecutar una llamada
Eventos Se carga al llegar aquí
  1. Los eventos aparecen aquí en cuanto carga el reproductor.

Todos los métodos y eventos están en la documentación de la IFrame Player API.

SDK de vídeo para web y móvil

Ocho SDK de código abierto para el mismo reproductor, en el orden en que los descargan los desarrolladores. Cada línea de instalación sale del README del paquete.

  • JavaScript IFrame Player API

    @kinescope/player-iframe-api-loader
    npm install @kinescope/player-iframe-api-loader
  • React componente de reproductor de vídeo

    @kinescope/react-kinescope-player
    npm install @kinescope/react-kinescope-player
  • Flutter plugin de reproductor de vídeo

    flutter_kinescope_sdk
    flutter pub add flutter_kinescope_sdk
  • Vue componente de reproductor de vídeo

    @kinescope/vue-kinescope-player
    npm install @kinescope/vue-kinescope-player
  • iOS SDK para Swift

    KinescopeSDK
    pod 'KinescopeSDK' o Swift Package Manager
  • Android SDK para Kotlin

    io.kinescope:kotlin-kinescope-player
    implementation 'io.kinescope:kotlin-kinescope-player:<version>' Maven Central
  • React Native componente de reproductor de vídeo

    @kinescope/react-native-kinescope-video
    yarn add @kinescope/react-native-kinescope-video más las dependencias peer que indica el README
  • Angular componente de reproductor de vídeo

    @kinescope/angular-kinescope-player
    npm install @kinescope/angular-kinescope-player

Qué construyes con la API

Los endpoints, eventos y herramientas que hay detrás del reproductor. Cada tarjeta enlaza con su parte de la documentación.

API de directos

Una API de streaming en directo: crea y programa eventos y retransmisiones, envía la señal por RTMP o SRT desde OBS o cualquier codificador y guarda la grabación automática. El reproductor web y los SDK de iOS y Android reproducen el directo.

Webhooks

Siete eventos enviados en JSON: media.update.status para el procesamiento y seis para el ciclo de vida de los directos.

API de analítica

Totales de reproducción, una línea temporal y rankings por país, ciudad, dispositivo, sistema operativo y navegador desde /v1/analytics/overview, para todo el espacio de trabajo o un solo vídeo, y el consumo de CDN, codificación y almacenamiento desde /v1/billing/usage.

Subtítulos y capítulos con IA

Genera subtítulos en el idioma del vídeo con una sola llamada a la API, y capítulos y una descripción breve con IA desde el panel. A través del servidor MCP, un agente lee el texto de los subtítulos y escribe los capítulos de vuelta.

No hay un plan aparte para desarrolladores: la API completa viene con los planes de pago desde 10 €/mes, con almacenamiento y entrega por CDN desde 0,03 € por GB y procesamiento desde 0,01 € por minuto. Precios y calculadora

Preguntas frecuentes

¿No encuentras la respuesta que buscas? Consulta nuestro portal para desarrolladores.

Sí. La API REST de Kinescope cubre la subida (una sola petición, enlaces de subida, importación por URL y TUS para archivos grandes), la transcodificación automática en versiones adaptativas de hasta 4K, los directos por RTMP, la protección de la reproducción y la analítica. Las peticiones van a api.kinescope.io/v1 con un token de API. Consulta la referencia de la API.

Sí. Crea un token de API en el panel, en Settings → API tokens, y envía peticiones REST con JSON a api.kinescope.io/v1 con el token en una cabecera Bearer. El inicio rápido de esta página va de la subida a la reproducción protegida en tres pasos. En el frontend, los SDK de código abierto cubren iOS, Android, Flutter, React, React Native, Vue y Angular, y la IFrame Player API funciona en cualquier página web. Un agente de IA hace el mismo trabajo a través del servidor MCP. Con el plan gratuito lo pruebas antes de pagar.

Sí, en beta pública. Kinescope MCP Server funciona en https://api.kinescope.io/mcp y es compatible con Cursor, Claude Desktop, Claude Code, Qwen3 y otros clientes MCP. Con tu token de API, tu agente busca y edita vídeos, ordena proyectos y listas de reproducción, consulta la analítica y gestiona directos en lenguaje natural. Las operaciones de borrado están desactivadas. La configuración está en la documentación del MCP.

SDK de código abierto para iOS (Swift), Android (Kotlin), Flutter, React, React Native, Vue y Angular, y la IFrame Player API de JavaScript para cualquier página web. Todos están en GitHub.

Consigue un token de API y publica tu primer vídeo.

Empieza gratis y pasa a la API completa desde 10 €/mes. Sin tarjeta de crédito.