Saltar al contenido

Trae tu propia API key

Crea una API key de OpenAI, Anthropic, Gemini u OpenRouter y conectala al agente nativo de Verxion.

El agente nativo de Verxion usa BYOK: trae tu propia API key. Tú eliges el proveedor de IA, creas una llave en su consola y la pegas en Verxion desde tu dispositivo.

Verxion no aloja el modelo por ti y no guarda la llave en nuestros servidores. La llave vive cifrada en tu dispositivo y solo se envía cuando el agente nativo necesita hablar con el proveedor que hayas elegido.

Antes de empezar

Necesitas:

  1. Una cuenta de proveedor: OpenAI, Anthropic, Google u OpenRouter.
  2. Acceso API activado en esa cuenta.
  3. Billing o crédito disponible en el proveedor.
  4. La app nativa de Verxion instalada y con sesión iniciada.

Una suscripción a ChatGPT Plus, Claude Pro o Gemini Advanced no es lo mismo que crédito de API. El agente nativo usa las APIs de los proveedores, así que el consumo se factura en la cuenta del proveedor que creó la llave.

Trata la llave como una contraseña. Cópiala una vez, pégala en Verxion y no la compartas en chats, emails, capturas o mensajes de soporte.

OpenAI

Usa OpenAI si quieres modelos GPT en el agente nativo.

  1. Abre OpenAI Platform API keys.
  2. Inicia sesión con la cuenta de OpenAI que debe pagar el consumo API.
  3. Crea una nueva llave de proyecto.
  4. Copia la llave cuando OpenAI la muestre.
  5. En Verxion Native, abre la pantalla de conexión del agente, elige OpenAI, pega la llave, elige un modelo y valida.

Las llaves de OpenAI suelen empezar por sk-proj-. OpenAI solo muestra el secreto completo cuando lo creas. Si lo pierdes, crea una llave nueva y elimina la anterior. Ver ayuda oficial: Where do I find my OpenAI API key?.

Anthropic / Claude

Usa Anthropic si quieres modelos Claude en el agente nativo.

  1. Abre Anthropic Console API keys.
  2. Inicia sesión con la cuenta de Anthropic que debe pagar el consumo API.
  3. Crea una API key.
  4. Copia la llave.
  5. En Verxion Native, abre la pantalla de conexión del agente, elige Claude, pega la llave, elige un modelo y valida.

Las llaves de Anthropic suelen empezar por sk-ant-. La guía de inicio de Anthropic también cubre el requisito de la API key: Get started with Claude.

Gemini

Usa Gemini si quieres los modelos Gemini de Google en el agente nativo.

  1. Abre Google AI Studio API keys.
  2. Inicia sesión con la cuenta de Google que debe ser dueña de la llave.
  3. Crea una nueva Gemini API key.
  4. Copia la llave.
  5. En Verxion Native, abre la pantalla de conexión del agente, elige Gemini, pega la llave, elige un modelo y valida.

Las llaves de Gemini suelen empezar por AIza. Google explica la creación de llaves y sus tipos aquí: Using Gemini API keys.

OpenRouter

Usa OpenRouter si quieres elegir entre muchos modelos con una sola llave — incluidas opciones económicas (DeepSeek, Qwen, Gemini Flash) y modelos frontier. OpenRouter es una pasarela: enruta tu petición al proveedor del modelo que elijas, bajo tu propia cuenta de OpenRouter.

  1. Abre OpenRouter API keys.
  2. Inicia sesión con la cuenta de OpenRouter que debe pagar el consumo.
  3. Crea una nueva API key (opcionalmente, asígnale un límite de crédito).
  4. Copia la llave.
  5. En Verxion Native, abre la pantalla de conexión del agente, elige OpenRouter, pega la llave, elige un modelo y valida.

Las llaves de OpenRouter suelen empezar por sk-or-v1-. El selector de Verxion muestra una lista curada de modelos compatibles, con los más fiables marcados como recomendados. Para tu privacidad, Verxion fuerza en cada petición un enrutado de no-retención y no-entrenamiento (zdr + data_collection: deny), independientemente de la configuración de tu cuenta. Crea y gestiona llaves aquí: OpenRouter API keys.

Conectarla en Verxion Native

  1. Abre la pestaña Agente.
  2. Si no hay ninguna llave conectada, toca tu proveedor.
  3. Pega la API key.
  4. Elige el modelo que quieres usar.
  5. Pulsa Validar y conectar.

Verxion comprueba la llave antes de guardarla. Si la validación pasa, el agente queda listo. Si falla, la app muestra una categoría segura: llave inválida, sin crédito, rate limit, proveedor no disponible o timeout.

Facturación y límites

Tu proveedor factura el uso de API directamente. Verxion no cobra por el modelo y no controla la factura del proveedor.

Recomendado: define un presupuesto antes de conectar la llave. Las consolas de los proveedores permiten configurar límites de gasto, presupuestos mensuales o alertas de presupuesto según el proveedor. Es una de las mejores formas de controlar lo que puede gastar el agente nativo mientras pruebas modelos, comparas proveedores o dejas el agente disponible en tu dispositivo.

Configura límites reales de gasto en la consola del proveedor:

Verxion puede mostrar estimaciones de coste por turno del agente, pero el panel del proveedor es la fuente de verdad.

Seguridad y revocación

Tu llave se guarda cifrada en este dispositivo. Verxion la envía por petición al proveedor elegido a través del agent harness y nunca la almacena en servidor.

Si crees que una llave se ha filtrado:

  1. Revócala o elimínala en la consola del proveedor.
  2. Crea una llave nueva.
  3. Abre Verxion Native y sustituye la llave antigua.

Quitar la llave de Verxion impide que este dispositivo la use, pero no revoca la llave en el proveedor. Las llaves filtradas se revocan desde la consola del proveedor.

Solución de problemas

La llave no es válida

Comprueba que has pegado la llave completa, no una etiqueta ni un project id. Si el proveedor solo la mostró una vez y no la guardaste, crea una nueva.

El proveedor dice que no tienes crédito

Añade billing o crédito en la consola del proveedor. Verxion no puede añadir crédito por ti.

Las peticiones tienen rate limit

Espera un momento o elige un proveedor/modelo con límites más altos. Los límites los controla la cuenta del proveedor.

El proveedor no responde

Prueba de nuevo más tarde o conecta temporalmente otro proveedor.

He cambiado de dispositivo

Añade la llave otra vez en el dispositivo nuevo. Las llaves BYOK se guardan localmente por dispositivo.