Claves de proveedores de IA

Con tu propia clave (BYOK) puedes hacer que las solicitudes de IA compatibles usen tu cuenta con el proveedor de IA. No necesitas una clave: la plataforma proporciona los modelos de forma predeterminada. Guardar una clave requiere el plan Scale. Las claves que ya estén guardadas siguen funcionando en Launch y Operate. Sigues pagando el plan de Make Agent Fast más una tarifa fija de plataforma por acción; el proveedor te factura directamente el uso de sus modelos.

Proveedores compatibles#

Solo se pueden añadir claves nuevas de dos proveedores: uno para texto y otro para voz:

Claves heredadas#

Las claves directas de proveedores guardadas antes del cambio a OpenRouter y Speko aparecen en Claves heredadas. Siguen funcionando hasta que las revoques y todavía puedes revocarlas, pero no puedes añadir ni reemplazar ninguna:

La disponibilidad de proveedores también depende de los proveedores de texto, voz y tiempo real configurados en la plataforma. Guardar una clave válida no obliga a que todas las funciones usen ese proveedor.

Añadir una clave de proveedor#

1. Crea una clave en la consola de OpenRouter o de Speko y activa la facturación del proveedor o un límite de gasto si es necesario.
2. Abre Panel → Ajustes → Claves de proveedores de IA. Solo el propietario de facturación de un espacio de trabajo Scale puede guardar una clave.
3. Pega la clave en la tarjeta de OpenRouter o de Speko.
4. Selecciona Probar y guardar.
5. Espera el resultado de la validación y luego prueba la función que usa el proveedor.

Make Agent Fast realiza una solicitud de validación en vivo antes de guardar una clave; no se consumen tokens de modelo ni créditos de la plataforma. La clave no debe contener espacios ni saltos de línea y debe tener entre 16 y 512 caracteres. Las claves de OpenRouter deben empezar por sk-or-; las de Speko deben empezar por sk_speko_ o sk_live_. La validación en vivo es la que decide.

Guardar otra clave válida del mismo proveedor reemplaza el valor almacenado anteriormente. Una clave que no supera la validación no se guarda, así que la clave que ya estaba guardada sigue funcionando. El panel solo conserva datos de identificación seguros, como los últimos cuatro caracteres, la fecha de validación y el estado.

Cómo se selecciona el proveedor de texto#

Para la generación de texto, tiene prioridad una clave activa de OpenRouter. Si no hay ninguna, Make Agent Fast busca una clave heredada activa que coincida con el proveedor de texto configurado en la plataforma y después las demás claves heredadas de texto (Anthropic, OpenAI, Gemini, xAI, DeepSeek) en ese orden. Si no existe ninguna clave BYOK adecuada, usa el proveedor de la plataforma cuando el plan y la implementación lo permitan.

Las claves de voz son específicas de cada proveedor. Una clave de Speko se usa cuando la voz se procesa a través de Speko. Una clave heredada de Deepgram solo se usa cuando el proveedor activo de voz a texto es Deepgram; una clave heredada de ElevenLabs solo se usa cuando la conversión de texto a voz está configurada con ElevenLabs.

Las claves BYOK actualmente no reemplazan las credenciales de embeddings de conocimiento de la plataforma. La ingesta y la recuperación de conocimiento siguen usando el proveedor de embeddings configurado en la implementación.

Facturación y créditos#

• El proveedor externo cobra el uso de tokens de IA a la cuenta que emitió la clave.
• Make Agent Fast sigue cobrando la suscripción más una tarifa fija de plataforma por cada acción que se ejecuta con tu clave: 1 crédito por respuesta de chat en lugar del cargo basado en tokens. La tarifa cubre la recuperación, la orquestación y el alojamiento que rodean la llamada, y no es un porcentaje de tu factura de tokens.
• La tarifa se aplica por cada llamada al proveedor. Los pasos de voz que financia la plataforma (por ejemplo, la transcripción cuando solo tienes una clave de texto) se cobran a la tarifa normal, y las llamadas en vivo siempre usan la tarifa de la plataforma.
• Si se agota la cuota del proveedor, una solicitud puede fallar aunque aún te queden créditos de Make Agent Fast.

Revisa tanto Uso y créditos en Make Agent Fast como el panel de uso del propio proveedor.

Estados de la clave y gestión de errores#

Si una solicitud falla porque un proveedor rechaza la credencial o la cuota, Make Agent Fast puede marcar la clave almacenada como no válida. Corregir la clave en el proveedor no revela ni reescribe el secreto almacenado; en el caso de una clave de OpenRouter o Speko, usa Probar conexión para volver a comprobarla o guarda de nuevo la clave que funciona. Una clave heredada que pasa a ser no válida no se puede reemplazar por otra clave heredada: en su lugar, migra ese proveedor a OpenRouter o Speko.

Rotar una clave de proveedor#

1. Crea una nueva clave de proveedor sin eliminar la anterior.
2. Guarda la nueva clave en Make Agent Fast y confirma que pasa a estar activa.
3. Prueba el chat de texto o los mensajes de voz, según cuál use ese proveedor.
4. Revoca la clave anterior en la consola del proveedor.
5. Revisa los registros del proveedor por si hubiera un uso inesperado de la clave anterior.

Si una clave queda expuesta en el control de versiones o en código del navegador, revócala de inmediato en el proveedor. Eliminarla únicamente de Make Agent Fast no impide que otra persona que la tenga siga usándola directamente con el proveedor.