Conecta tu propia clave de modelo

Usa una clave de un proveedor de modelos o una pasarela. Para que la conexión funcione, deben coincidir el proveedor, el endpoint, el ID del modelo y los permisos de la cuenta.

Recopila los datos de conexión

Necesitas una API Key del servicio al que quieras llamar, su Base URL de API, un ID de modelo disponible y un protocolo o ajuste predefinido compatible. Tener una cuenta en un sitio web de chat para consumidores no proporciona por sí solo acceso a la API ni créditos de API.

Selecciona el proveedor y, después, haz coincidir su clave, la Base URL de API y el modelo.

Todos los planes, incluido Free, admiten BYOK. La clave de tu proveedor utiliza la facturación y los límites de ese proveedor, en lugar del saldo de OpenDesign.

Añade el proveedor

Abre Settings → Models & providers → API providers.
Elige el ajuste predefinido del servicio que emitió tu clave. En Custom provider, haz coincidir el protocolo documentado por ese servicio.
Pega únicamente el secreto en API Key. No añadas Bearer, comillas ni un contenedor de configuración JSON.
Comprueba Base URL. Si la dirección de un ajuste predefinido está bloqueada, usa su opción de URL personalizada antes de introducir otro endpoint.
Elige un modelo de la lista disponible o introduce el ID exacto del modelo de API en Custom. La carga de modelos depende del servicio y de la cuenta.
Ejecuta Test. Lee la respuesta: una prueba correcta verifica esta pequeña solicitud, no todas las herramientas, modelos multimedia ni solicitudes futuras.
Espera la confirmación de que se ha guardado. Vuelve a abrir Settings para comprobar el proveedor, la dirección y el modelo; después, regresa al proyecto y selecciona esa conexión antes de enviar una tarea pequeña.

Mantén la clave en privado. Puedes mostrar el campo con Show para inspeccionarlo localmente; ocúltalo antes de compartir una captura de pantalla.

OpenRouter utiliza su propia clave, la dirección de su pasarela e IDs de modelo con el prefijo del proveedor.

Ejemplo: DeepSeek

Crea una clave en DeepSeek Platform. Usa https://api.deepseek.com como Base URL y elige un modelo al que pueda acceder tu cuenta. Usa un ID de la lista actual de modelos del proveedor, por ejemplo deepseek-flash; la captura de pantalla del cliente instalado aún contiene un alias de ajuste predefinido anterior. Cuando sea necesario, introduce el ID actual como modelo personalizado. El acceso directo Get key de la versión 0.25.0 instalada puede abrir la página del proveedor equivocado. Usa la propia consola del proveedor en lugar de crear una clave de OpenAI no relacionada.

Campo	Ejemplo de conexión directa con DeepSeek
Proveedor/protocolo	Ajuste predefinido de DeepSeek o un ajuste predefinido personalizado compatible con el protocolo de OpenAI
API Key	Una clave emitida por tu cuenta de DeepSeek Platform
Base URL	https://api.deepseek.com
ID del modelo	deepseek-flash, si está habilitado para tu cuenta

Copia el ID exacto de la documentación actual de la API de DeepSeek, en lugar del nombre mostrado en una captura de pantalla antigua. Para este ejemplo con el protocolo de OpenAI, no uses el endpoint /anthropic independiente.

Ejemplo: OpenRouter

Crea una clave en la configuración de claves de OpenRouter. Usa https://openrouter.ai/api/v1. Copia un ID de modelo de la lista de modelos disponibles de OpenRouter, incluido el prefijo del proveedor. No introduzcas una clave directa de Anthropic u OpenAI en el ajuste predefinido de OpenRouter. La clave debe pertenecer a la pasarela que recibe la solicitud.

Elige OpenRouter en API providers y pega una clave emitida por OpenRouter.
Usa https://openrouter.ai/api/v1 como Base URL.
Copia el ID exacto del modelo del directorio de modelos de OpenRouter, incluido el prefijo del proveedor.
Prueba la conexión, espera a que se guarde y selecciónala en el proyecto antes de ejecutar una solicitud.

Comprueba otro proveedor

Dato	Qué debes comprobar
Protocolo	El ajuste predefinido debe coincidir con el protocolo de API documentado.
Base URL	Usa la raíz de API que espera el ajuste predefinido, sin una ruta del panel ni un segmento de versión duplicado.
Modelo	Usa el ID del modelo de API, no su nombre comercial.
Permiso	Confirma el acceso al modelo, la disponibilidad regional, la cuota y la facturación en la cuenta del proveedor.

Una clave no constituye todo el entorno de ejecución

Las tareas BYOK también necesitan el entorno de ejecución compatible que lleva a cabo las operaciones de archivos y herramientas del agente. Si la aplicación indica que el entorno de ejecución no está disponible, sigue sus instrucciones de instalación o de nuevo escaneo. Sustituir la clave no instalará un archivo ejecutable.

Comprende la facturación

Las solicitudes BYOK las factura el proveedor o la pasarela cuya clave hayas introducido. Una suscripción a OpenDesign y el saldo de un proveedor externo son independientes. Consulta facturación y solución de problemas de conexión si una clave válida sigue sin poder ejecutar una tarea.

Interpreta el resultado de la prueba y soluciona el problema

Resultado	Siguiente acción
401 / clave no válida	Comprueba el servicio emisor y pega la clave completa sin formato adicional. Sustituye una clave revocada desde el servicio que la emitió.
403 / acceso denegado	Comprueba con el proveedor los permisos del modelo, la región y el acceso de la cuenta. Un secreto válido por sí solo no concede acceso al modelo.
404 / modelo no encontrado	Comprueba la raíz de la API y el ID exacto del modelo. Elimina las rutas del panel y los segmentos /v1 duplicados.
429 / cuota o límite de frecuencia	Lee el error del proveedor para distinguir entre un saldo agotado y un límite de frecuencia temporal. Comprueba la consola de la cuenta antes de volver a intentarlo.
Tiempo de espera agotado/error de red	Comprueba si se puede acceder a este endpoint desde el entorno del cliente. Vuelve a intentar una solicitud pequeña después de resolver el problema de red.

Después de una prueba correcta, envía una solicitud pequeña en el proyecto existente e inspecciona la respuesta y cualquier archivo creado. Si la prueba se supera pero fallan las operaciones con archivos, comprueba el entorno de ejecución descrito en la sección sobre el entorno de ejecución; no sustituyas repetidamente una clave que funciona.