Claves de IA y de API
Todas las funciones de IA y de contenido de archivo del editor funcionan con claves que aportas tú. Esta página cubre dónde introducirlas: el proveedor de IA que usa el asistente de chat, los cinco proveedores de contenido de archivo que usa la pestaña Media, y la base de conocimiento opcional de búsqueda vectorial que hay detrás de las recetas de diseño del asistente.
Vistazo rápido
- Abre Settings y luego AI Settings.
- Elige la pestaña de un proveedor, pega tu clave de API y escoge un modelo.
- Fija un system prompt, una temperatura y un máximo de tokens opcionales en General Settings, y luego pulsa Save Settings.
- Usa Test Connection para confirmar que la clave funciona antes de depender de ella.
- Cambia a la sección Knowledge Base, o baja hasta Stock Media API Keys, para los otros dos conjuntos de claves.
Referencia detallada
Proveedores de IA
| Proveedor | Notas |
|---|---|
| Qwen (DashScope) | El proveedor por defecto |
| Kimi (Moonshot) | |
| DeepSeek | |
| GLM (Zhipu) | |
| OpenAI | |
| Google Gemini | |
| Anthropic Claude | |
| Endpoint personalizado | Cualquier API de chat completions compatible con OpenAI |
Cada pestaña muestra un campo de clave de API enmascarado como contraseña con un interruptor para mostrar u ocultar, y un selector de modelo en forma de cuadrícula de tarjetas. La pestaña Custom Endpoint sustituye la cuadrícula de modelos por un campo Base URL y otro Model Name, ya que no hay una lista fija de modelos entre los que elegir. Consulta Asistente de chat con IA para saber qué proveedores admiten visión y generación nativa de imágenes.
Ajustes generales
Compartidos entre todos los proveedores.
| Ajuste | Rango | Notas |
|---|---|---|
| System prompt | Texto libre | Instrucciones personalizadas opcionales, por ejemplo para orientar al asistente hacia un estilo de diseño concreto |
| Temperature | 0 a 2 | Etiquetada como Precise, Balanced, Creative o Wild a medida que mueves el control deslizante |
| Max tokens | 100 a 32768 | Limita la longitud máxima de una sola respuesta |
Save Settings guarda el proveedor, la clave y el modelo activos; Test Connection envía una petición pequeña para confirmar que la clave es válida sin esperar a un chat real.
Stock Media API Keys
Una lista aparte de claves que impulsan la búsqueda dentro de la biblioteca multimedia, sin relación con la clave propia del asistente de chat.
| Proveedor | Se usa para | Registro | Notas |
|---|---|---|---|
| Unsplash | Búsqueda de imágenes | unsplash.com/oauth/applications | Usa una Access Key, no la Secret Key; alrededor de 50 peticiones/hora en una app de demostración sin revisar, mucho más una vez tu app está aprobada para producción |
| Pexels | Búsqueda de imágenes y vídeo | pexels.com/api | La clave se emite al instante en cuanto la solicitas |
| Pixabay | Búsqueda de imágenes, vídeo y audio | pixabay.com/api/docs | Una sola clave cubre los tres tipos de contenido, con un límite por minuto en lugar de por día |
| Freesound | Búsqueda de audio | freesound.org/apiv2/apply | Se envía como un token, no con el valor de clave en bruto, en la petición |
| Jamendo | Búsqueda de audio | devportal.jamendo.com | Gratis para uso no comercial |
| GIPHY | GIFs y stickers | developers.giphy.com | También lo usa el panel Emoji, GIFs y stickers |
Cada campo tiene un interruptor de Show/Hide e instrucciones de registro en línea. Una acción Test Keys comprueba todas las claves configuradas de una vez e informa de si cada proveedor pasa o falla, incluido el código de estado HTTP en caso de fallo, de modo que es fácil distinguir una clave incorrecta o caducada de un proveedor que simplemente está caído.
Knowledge Base
Una base de datos vectorial de Qdrant opcional que respalda la búsqueda semántica del asistente sobre sus recetas de diseño integradas. Sin ella, el asistente recurre a la coincidencia local por palabras clave, que sigue funcionando pero es menos precisa.
| Campo | Propósito |
|---|---|
| Qdrant URL | Tu endpoint de Qdrant Cloud (o autoalojado) |
| Qdrant API key | Autentica contra ese endpoint |
| Embedding provider | OpenAI, Qwen, Google o GLM |
| Embedding model | Depende del proveedor elegido |
| Embedding API key | Opcional; déjalo vacío para reutilizar la clave de tu proveedor de chat de IA |
Save & Enable activa la búsqueda de Qdrant, Seed Qdrant empuja el conjunto de recetas integradas hacia él, y Disable Qdrant vuelve a la búsqueda local sin perder los datos de la conexión.
Skills Manager
El botón Customize / Skills en la parte superior de AI Settings abre el editor de habilidades, donde creas y asignas habilidades de IA, perfiles de instrucciones personalizadas que se activan con un slash command. Consulta Habilidades de IA para saber cómo crearlas y usarlas.
Una habilidad se estructura como una carpeta pequeña: una instrucción principal SKILL.md más un conjunto opcional de documentos de referencia, cada uno con su propio título y contenido, de los que la habilidad puede nutrirse.
| Elemento | Detalle |
|---|---|
| Habilidades integradas | Vienen con el editor; su nombre, descripción y SKILL.md son de solo lectura, pero aun así puedes asignarlas a proveedores |
| My Skills | Todo lo que creas tú; totalmente editable, incluidos SKILL.md, referencias, icono y descripción |
| Asignación de proveedor | Una cuadrícula de casillas te permite activar una habilidad para uno o más proveedores de forma independiente, de modo que distintos proveedores pueden ejecutar distintas habilidades |
| Slash command | El nombre de cada habilidad se convierte en un comando de chat con formato de slug (se muestra en vivo mientras editas el nombre); por ejemplo, una habilidad llamada "Brand Voice" se convierte en /brand-voice |
| Duplicate | Funciona tanto con habilidades integradas como personalizadas; duplicar una habilidad integrada es la forma de empezar a editarla, ya que el original permanece bloqueado |
Detalles de conexión de la Knowledge Base
La sección Knowledge Base (una entrada de barra lateral aparte de AI Settings) es donde se introducen y guardan la Qdrant URL, la clave y el proveedor de embeddings de la tabla anterior; Save & Enable, Seed Qdrant y Disable Qdrant viven todos en esa sección.
Paso a paso
Conectar una clave de proveedor de IA de principio a fin
- Abre Settings y luego AI Settings.
- Haz clic en la pestaña de un proveedor (por ejemplo Qwen, DeepSeek o Anthropic Claude).
- Pega tu clave en el campo API Key, usando el interruptor de mostrar/ocultar para verificarla, y luego elige un modelo en la cuadrícula de tarjetas (o, en Custom Endpoint, rellena en su lugar un Base URL y un Model Name).
- Opcionalmente, fija un system prompt, una temperatura y un máximo de tokens en General Settings.
- Haz clic en Save Settings y luego en Test Connection para confirmar que la clave funciona de verdad antes de depender de ella en un chat.
Configurar una clave de contenido de archivo y verificarla
- Baja hasta Stock Media API Keys, más abajo en AI Settings.
- Regístrate en el sitio del proveedor listado arriba y copia la clave que te emita.
- Pégala en el campo correspondiente y haz clic en Save API Keys.
- Haz clic en Test Keys; cada proveedor configurado informa en línea de OK o de un error HTTP concreto, así que sabes de inmediato si una clave necesita arreglo.
Crear una habilidad de IA personalizada y activarla
- Haz clic en Customize / Skills en la parte superior de AI Settings.
- Haz clic en New Skill, dale un nombre y una descripción, y elige un icono.
- Escribe tus instrucciones en el editor de SKILL.md; añade uno o más documentos de referencia desde el árbol de archivos si la habilidad necesita material de apoyo más allá de la instrucción principal.
- Marca el proveedor o los proveedores en los que quieres que esté disponible en la cuadrícula de Provider Assignment, y luego guarda.
- En el chat de IA, escribe el slash command de la habilidad (mostrado en la vista previa bajo el editor) para activarla.
Activar la base de conocimiento de Qdrant
- Abre Settings y luego Knowledge Base.
- Introduce tu Qdrant URL y tu clave de API, elige un proveedor y un modelo de embeddings, y opcionalmente una clave de API de embeddings aparte (déjala vacía para reutilizar la clave de tu proveedor de chat de IA).
- Haz clic en Save & Enable y luego en Seed Qdrant para empujar el conjunto de recetas integradas hacia él.
- Si quieres volver a la coincidencia local por palabras clave, haz clic en Disable Qdrant; los datos de tu conexión se conservan, así que volver a activarlo más tarde no requiere reintroducirlos.
Tareas habituales
| Tarea | Pasos |
|---|---|
| Cambiar el proveedor activo sin perder otras claves | Haz clic en la pestaña de otro proveedor y guarda; la clave de cada proveedor se almacena de forma independiente |
| Dar una habilidad solo a tu proveedor más rápido | Desmárcala para todos los demás proveedores en la cuadrícula de Provider Assignment de esa habilidad |
| Empezar a editar una habilidad integrada | Ábrela, haz clic en Duplicate y edita la copia en My Skills |
| Confirmar que un Custom Endpoint funciona de verdad | No hay lista de modelos con la que comprobarlo, así que envía un mensaje de chat real tras guardar en lugar de fiarte solo de Test Connection |
| Liberar una conexión de base de conocimiento sin perder las recetas cargadas en ella | Usa Disable Qdrant en lugar de vaciar los campos de URL y clave |
Resolución de problemas
Una clave que falta muestra un aviso, no un fallo silencioso
Tanto los paneles de búsqueda de contenido de archivo como el panel de GIFs/stickers muestran un mensaje explícito de "añade tu clave" que enlaza de vuelta a Settings cuando falta una clave necesaria, en lugar de devolver resultados vacíos.
Test Keys informa del estado HTTP por proveedor
Una prueba fallida muestra el código de estado HTTP real que devolvió ese proveedor (por ejemplo un 401 por una clave incorrecta frente a un 429 por límite de peticiones), así que puedes distinguir un error de tecleo de una caída temporal del proveedor.
Las habilidades integradas no se pueden editar ni eliminar en su sitio
Sus campos de nombre, descripción y SKILL.md son de solo lectura, y no hay botón de eliminar. Duplica primero una habilidad integrada para obtener una copia editable y eliminable en My Skills.
Consejos
Mantén separadas las claves de chat y las de archivo
La clave del proveedor de IA impulsa la conversación y la generación; las claves de contenido de archivo solo alimentan la búsqueda dentro de la pestaña Media. Configurar una no configura la otra.
Prueba antes de depender de ella
Las API de los proveedores cambian sus formatos de clave y sus límites de peticiones con el tiempo. Ejecuta Test Connection o Test Keys después de pegar una clave, en lugar de descubrir un error de tecleo a mitad de un diseño.
Relacionado
- Asistente de chat con IA para saber qué admite cada proveedor
- Habilidades de IA para crear y activar habilidades personalizadas
- Biblioteca multimedia y contenido de archivo para saber qué desbloquean las claves de archivo
- Ajustes del editor para el resto de la pantalla de Settings