Verdent Docs
Configuración

Bring Your Own Key (BYOK)

Usa tus propias claves API de proveedor en Verdent Desktop y descubre dónde están disponibles los modelos de BYOK

Descripción general

BYOK (Bring Your Own Key) te permite conectar tus propias claves API de proveedor y usar esos modelos directamente dentro de los agentes integrados de Verdent.

BYOK frente a BYOA

Verdent ofrece dos rutas de "trae lo tuyo"; no las confundas:

BYOKBYOA
Qué aportasUna clave API de proveedorUn runtime de Agent (Codex / Claude Code)
Qué ejecuta tu tareaEl agente integrado de Verdent, usando el proveedor detrás de tu claveEl agente de CLI externo en tu equipo
Caso de uso típicoAcceder a un modelo bajo tu propia facturación, o usar un proveedor no incluido por defectoMantener tu flujo de trabajo existente de Codex / Claude Code mientras Manager le asigna tareas de Worker
Configurar enSettings → Models → Configure ModelsSettings → Models → CLI Agents

Consulta BYOA para ejecutar tareas de Worker en un runtime de Agent externo.

Proveedores compatibles

  • Anthropic
  • OpenAI
  • OpenRouter

Agregar una clave API

Abrir la configuración de modelos

Ve a Settings → Models → Configure Models.

Comenzar a agregar una clave

Selecciona Add API Key + en la esquina superior derecha.

Elegir proveedor y modelos

Selecciona un proveedor y elige los modelos que quieres habilitar.

Ingresar credenciales

Agrega tu clave API.

Guardar y validar

Selecciona Save. Verdent valida la clave automáticamente.

Resultados de la validación

  • Si la validación tiene éxito, la clave se guarda y los modelos seleccionados quedan disponibles.
  • Si la validación falla, Verdent muestra un error para que puedas actualizar la clave e intentarlo de nuevo.

Administrar las claves API existentes

En Settings → Models → Configure Models, puedes:

  • Habilitar o deshabilitar todos los modelos de un proveedor
  • Habilitar o deshabilitar modelos individuales
  • Editar una clave API existente
  • Eliminar una clave API

Dónde aparecen los modelos de BYOK

Después de agregar una clave válida, los modelos de BYOK aparecen en:

  • El selector de modelo del chat
  • La configuración de modelos predefinidos
  • La configuración de subagentes
  • La configuración del revisor

Los modelos de BYOK se comportan como los modelos integrados una vez habilitados.

Limitaciones

  • Las funciones integradas como Smart Suggestions no admiten claves API de BYOK.
  • La compresión automática no admite claves API de BYOK.