Documentación

Claves API

Cómo funciona 

Metamorfon utiliza sus propias claves API (modelo «bring your own key», BYOK). Usted crea las claves en los proveedores de modelos que utiliza; la facturación de las llamadas (tokens, cuotas, suscripciones) depende exclusivamente de esos proveedores y de su cuenta. Metamorfon muestra indicadores de uso (tokens, costes estimados) para ayudarle a seguir el consumo, pero no factura el uso de las API de los proveedores.

Dónde introducir las claves

Abra Ajustes y la sección «Claves API». Para cada proveedor puede pegar la clave, mostrarla u ocultarla y usar la validación para comprobar que es aceptada y que hay modelos disponibles para su cuenta. Tras la validación, la aplicación puede sincronizar la lista de modelos disponibles en el proveedor.

Almacenamiento y privacidad

Sus claves se guardan localmente en su dispositivo (navegador o aplicación de escritorio, según su instalación). No se envían a servidores de Metamorfon en Internet. Solo sirven para que la aplicación llame a las API oficiales de los proveedores que haya configurado. La validación y el listado de modelos pasan por un backend local (FastAPI; véase más abajo).

Backend local y validación

La validación de claves y la obtención de modelos pasan por un servidor local (por defecto http://127.0.0.1:8000). La aplicación intenta iniciarlo automáticamente. Si la validación falla o el servidor no responde: espere unos segundos, use «Reintentar» en la zona de claves, compruebe que ningún otro programa use el puerto 8000 y que el backend pueda arrancarse (véanse los registros o la ayuda en la aplicación si el problema continúa).

Proveedores admitidos y enlaces útiles

• OpenAI — Prefijo habitual: sk-. Obtener o gestionar claves: https://platform.openai.com/api-keys
• Anthropic — Prefijo habitual: sk-ant-. Claves: https://console.anthropic.com/settings/keys
• Google — Clave API de Google (Gemini / AI Studio según su cuenta). Claves: https://makersuite.google.com/app/apikey
• Mistral — Claves API: https://console.mistral.ai/api-keys
• xAI — Prefijo habitual: xai-. Consola: https://console.x.ai
• DeepSeek — Prefijo habitual: sk-. Claves API: https://platform.deepseek.com/api_keys
• Cohere — Claves API: https://dashboard.cohere.com/api-keys

Errores frecuentes

• Clave no válida, caducada o sin modelos disponibles — Verifique la clave en el sitio del proveedor, la cuenta o proyecto correcto, y que un modelo compatible esté habilitado para su región o plan.
• Cuota o límite de velocidad — Consulte el panel del proveedor (facturación, límites, estado del servicio).
• Backend local inaccesible — Compruebe que el servidor local responde, que el puerto está libre y vuelva a validar.

Buenas prácticas de seguridad

• Nunca comparta una clave API en texto plano.
• No exponga sus claves en capturas de pantalla, foros ni tickets de soporte.
• Si una clave está comprometida, revóquela de inmediato en el sitio del proveedor y genere una nueva.
• Cuando sea posible, use claves con permisos restringidos.

Usuarios avanzados (variables de entorno)

Si ejecuta usted mismo el backend o una configuración personalizada, variables como OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, etc. pueden complementar o sustituir la introducción en la interfaz según su despliegue. En el uso normal desde la aplicación gráfica basta la sección Claves API en Ajustes.

Inicio rápido

1. Instale y abra Metamorfon en un sistema compatible (Windows o macOS).
2. Espere a que el backend local esté activo (véase Backend local). La aplicación suele iniciarlo; el estado se muestra en la interfaz.
3. Abra Ajustes → Claves API, añada al menos una clave, valide y sincronice los modelos.
4. Cree una nueva sesión, elija la estrategia de diálogo y los modelos, escriba su prompt y ejecute el primer turno.
5. Use exportar cuando quiera una copia portable de la sesión (Markdown, Word o instantánea JSON; véase Sesiones, exportación e importación).

Cuenta y suscripción

Gestionar su suscripción

Para gestionar su plan, actualizar su método de pago o descargar sus facturas, abra la aplicación y acceda a : Cuenta (panel inferior izquierdo) → Mi cuenta → Gestionar suscripción
Esto abre el portal de facturación de Stripe en su navegador, desde el que puede realizar todas las acciones relacionadas con su suscripción.

Cancelar su suscripción

Para cancelar, siga el mismo camino : Cuenta → Mi cuenta → Gestionar suscripción → Cancelar plan
La cancelación surte efecto al final del período de facturación actual — conserva acceso completo hasta entonces. Si cancela durante el período de prueba gratuito de 14 días, no se realizará ningún cargo.

Cambiar de plan

Puede cambiar del plan mensual al anual (o viceversa) en cualquier momento desde el portal de Stripe. Los cambios surten efecto en el siguiente ciclo de facturación.

Backend local

Metamorfon depende de un servidor FastAPI local (por defecto http://127.0.0.1:8000) para la validación de claves, el listado de modelos y la orquestación de llamadas. La aplicación intenta iniciar este servidor automáticamente.

Si la validación o la sincronización fallan:

• Espere unos segundos y use Reintentar en la zona de claves.
• Asegúrese de que nada más use el puerto 8000.
• Compruebe que el cortafuegos no bloquee el tráfico local hacia esa dirección.
• Si sigue fallando, use las rutas de registro o diagnósticos que muestre la aplicación, o su procedimiento interno para arrancar el backend manualmente (configuraciones avanzadas).

Este backend es local; no equivale a enviar datos al sitio web de Metamorfon.

Privacidad y flujo de datos

Las claves API se almacenan en su dispositivo. No se envían a los servidores de Metamorfon en Internet. Sirven para que la aplicación llame a las API oficiales de los proveedores que elija.

Los prompts, respuestas y contenido asociado se procesan según la configuración de la sesión (modelos, acceso web, etc.). En el uso habitual con modelos en la nube, ese contenido se envía a los proveedores de LLM que haya seleccionado, no a Metamorfon como procesador central. Para el texto legal exacto (conservación, encargados, regiones), remítase a su política de privacidad y mantenga esta sección alineada con ella.

Las exportaciones pueden incluir el texto completo del diálogo; trate los archivos compartidos como documentos sensibles.

Sesiones, exportación e importación

La exportación permite extraer el diálogo en varios formatos: Markdown, Word o una instantánea JSON del estado de la sesión.

La importación (cuando exista) restaura una sesión desde una instantánea JSON para reanudar con los mismos parámetros e historial, según la compatibilidad de versiones.

Antes de compartir una exportación: elimine o anonimice datos sensibles; los archivos exportados no se anonimizan solos.

Métricas y costes

La interfaz muestra indicadores de uso como tokens y costes estimados para seguir el consumo durante la sesión. Sirven para seguir el uso en la aplicación; pueden no coincidir línea a línea con la factura del proveedor (redondeos, tramos de precio, tokens en caché o reglas de facturación propias).

La facturación de las llamadas API es entre usted y cada proveedor de LLM en su cuenta (BYOK). Metamorfon no le cobra el uso de las API de los proveedores.

Ajustes importantes (resumen)

• Temperatura (por modelo): Ajusta aleatoriedad frente a determinismo; valores más bajos suelen ser más estables, más altos más variados.
• Acceso web (si está disponible): Permite usar fuentes web en directo cuando el proveedor lo soporte. Puede afectar la latencia, el coste y qué datos salen de su máquina. Actívelo solo si lo necesita.
• Modelos predeterminados (p. ej. síntesis o resumen): Defínalos en Ajustes para no reconfigurar cada sesión.
• Estrategias de diálogo y modos de debate: Definen los turnos y la intensidad del cuestionamiento entre modelos. La aplicación puede incluir textos de ayuda; el sitio web describe estas funciones con más detalle.

Solución de problemas

• Backend o servidor no disponible: Puerto 8000 libre, servidor local en ejecución, reintento tras unos segundos, cortafuegos que no bloquee localhost.
• Clave no válida o sin modelos: Clave correcta en el sitio del proveedor, proyecto y facturación adecuados, acceso a modelos en su región, cuotas no superadas.
• Límite de ritmo o cuota: Panel del proveedor: límites, método de pago, estado del servicio.
• Errores de red: Conexión a Internet, VPN o proxy que bloqueen las API del proveedor, reglas del cortafuegos corporativo para HTTPS saliente hacia los dominios del proveedor.
• Costes inesperados: Acceso web activo, contexto grande, muchos turnos — véase Métricas y costes y la tarifa del proveedor.

Requisitos del sistema y entorno

• SO: Versiones Windows y macOS ofrecidas en el sitio.
• Red: Necesaria para las API LLM en la nube y funciones web opcionales; el backend local usa localhost.
• Redes corporativas: Si las llamadas solo fallan en la oficina, pida a TI que revise inspección TLS, proxy o reglas de salida hacia los dominios de los proveedores.