Ir al contenido

Configurar servicios de modelos

Elige cómo pagar los servicios de IA, configura la conexión y verifícala sin generar contenido.

¿Necesitas un servicio de modelos?

Recortar y ordenar videos existentes, editar subtítulos existentes y exportar localmente no requiere una clave de modelo de generación. Analizar videos, transcribir voz y generar imágenes, video o audio requiere el servicio correspondiente. Configura solo los servicios que tu tarea necesita.

1. Elige la forma de facturación

Con tu propia cuenta de proveedor, el proveedor cobra a esa cuenta. Para una conexión oficial de rikoko, usa únicamente la dirección del servicio y la clave personal de API que te hayan proporcionado; comprueba la disponibilidad y los créditos de tu cuenta. El inicio de sesión del sitio, la clave personal de API de rikoko, la clave del proveedor y la clave del espacio de trabajo local tienen funciones distintas. No las intercambies.

La aplicación web usa la cuenta en la nube y los servicios configurados por su operador. Cambiar los archivos de tu MCP local no configura la aplicación web. Que un modelo aparezca en una interfaz no garantiza que esté habilitado para tu cuenta.

2. Localiza la configuración activa

En una instalación administrada, busca el archivo installation.json indicado por VIDEOWORKBENCH_MANAGED_CONFIG en la entrada MCP de rikoko del cliente. Su campo home identifica el directorio de instalación. Las rutas siguientes son relativas a ese directorio. Las instalaciones desde código fuente o en servidores propios pueden usar otra ruta; revisa su configuración de inicio.

ArchivoQué contiene
config/models.jsonModo de conexión, adaptadores, perfiles de modelos y límites de entrada/costo. Sin valores de claves secretas.
config/credentials.jsonValores privados de las claves, asociados al nombre exacto de keyEnv en models.json. Ingresa los secretos localmente, no en el chat.
data/server.logDiagnóstico de inicio y conexión. Elimina los secretos antes de compartir fragmentos.

3. Configura un perfil compatible

Para usar tu propia cuenta de proveedor, copia esta solicitud e indica al agente qué proveedor usas. Puede localizar los archivos y preparar la configuración contigo. Para una conexión oficial, pide que use la dirección del servicio que te proporcionaron. Los detalles de configuración manual aparecen después de la solicitud.

Solicitud
Ayúdame a configurar los servicios de IA de mi instalación existente de rikoko. Primero identifica la versión, los archivos activos y la forma de facturación sin mostrar secretos. Quiero usar mi propio proveedor para generar videos, de preferencia con un perfil MiniMax compatible. Revisa el perfil de la versión, el soporte de referencias y el precio actual antes de proponer cambios. Conserva las otras conexiones. Indica dónde ingresar la clave de forma privada. No habilites la ejecución de pago ni envíes tareas hasta que apruebe la configuración y el presupuesto.

Para tu propio proveedor, models.json usa schemaVersion: 1, mode: "custom" y un arreglo providers. Cada conexión incluye id, adapter, keyEnv, enabled y models. Los adaptadores admitidos son fal, fal-video, replicate y gemini. Cada perfil necesita endpoint exacto, kind, parameters, priceVersion, maxCostCents y hardBoundConfirmed; los modelos con referencias también requieren los vínculos de entrada correctos. La marca del modelo o la clave de API por sí sola no basta.

Pide al agente que revise un perfil compatible de la versión instalada y verifique endpoint, límites de entrada y precio actual del proveedor. No inventes costos ni marques hardBoundConfirmed como true antes de verificar el límite de costo. Mantén enabled en false durante la preparación. Guarda la credencial de forma privada bajo el nombre de keyEnv correspondiente; en macOS/Linux el archivo debe ser accesible solo por su propietario (0600). Respalda la configuración y conserva las demás conexiones.

Para una conexión oficial proporcionada, usa mode: "official", official.url con el origen del servicio indicado y official.keyEnv con el nombre de la credencial. No inventes una URL de nube ni reutilices una clave de proveedor. Si no recibiste una dirección y clave oficiales, usa tu propio proveedor compatible o continúa editando localmente.

4. Aplica y verifica

Después de revisar el perfil y el límite de gasto, habilita la conexión elegida. Termina las tareas activas, reinicia el servicio local con el procedimiento de tu instalación y vuelve a conectar el cliente. Recargar el chat no actualiza la configuración de un backend en ejecución. Solicita una consulta de capabilities y generation_usage, sin generación.

Solicitud
Consulta capabilities y generation_usage de rikoko. Indica el origen de facturación, los IDs exactos de los modelos, la disponibilidad, las referencias admitidas y la configuración de salida. Explica qué falta configurar. No analices archivos ni generes nada.

La consulta debe identificar el modelo y la forma de facturación esperados. No comprueba el saldo del proveedor ni la calidad real del resultado. Si un modelo no está disponible, revisa enabled, el nombre de la credencial, la validación del perfil y la confirmación del costo. Si sigue apareciendo un catálogo anterior, revisa la instalación activa y reinicia. La primera prueba de pago es un paso separado, con su propio presupuesto acordado.

Catálogo de modelos y configuración de entrada →

Solución de problemas detallada →

Guía para rikoko 0.1.32, revisada el 22 de octubre de 2026. Consulta los modelos disponibles en el servicio que conectaste.