Trae tu propia clave de IA
Las funciones de IA se basan en un principio: tú traes tu propia clave de proveedor, y tu clave permanece en el lado del servidor. Nunca estás bloqueado en un solo modelo, y nunca pagas a la aplicación un recargo sobre el precio del proveedor.
Cómo funciona
Conectas una clave de API para un proveedor que ya usas, OpenAI, Anthropic, Google, Qwen, DeepSeek, Kimi, GLM, o un endpoint personalizado compatible con OpenAI para chat, además de BytePlus y fal.ai para imagen y video. Cuando usas AI Studio en el espacio de trabajo, la aplicación llama a ese proveedor en tu nombre desde el servidor, por lo que tu clave nunca llega a la página. El asistente en el editor funciona de manera diferente: mantiene tu clave en tu navegador y llama al proveedor directamente desde allí. De cualquier manera, el proveedor te factura directamente por lo que usas, a sus propias tarifas, y puedes cambiar de proveedor en cualquier momento.
| Paso | Detalle |
|---|---|
| Conectar | Agrega una clave de proveedor en Ajustes de IA |
| Probar | Confirma que la clave funciona antes de depender de ella |
| Usar | Chatear, generar imágenes y generar video |
| Cambiar | Cambia de proveedor por tarea, cuando quieras, y cada clave recuerda su propio modelo y configuración |
Tus claves están protegidas
Trata las claves de proveedor como contraseñas
En AI Studio, tus claves de API están cifradas en reposo y nunca se devuelven al navegador, y todas las llamadas a proveedores pasan por el servidor, por lo que tu clave no queda expuesta en la página ni a otros usuarios. Dos cosas funcionan de manera diferente: un endpoint personalizado no tiene un proxy de servidor incorporado, por lo que esas solicitudes van directamente desde tu navegador a la dirección que proporciones; y el asistente en el editor mantiene tu clave en tu navegador y llama a los proveedores directamente en lugar de a través del servidor. Considera ambas razones para conectar una clave solo en un dispositivo de confianza.
¿Qué necesita una clave?
| Característica | Clave |
|---|---|
| Generación de chat, imagen y video | Tu clave de proveedor de IA |
| Habilidades y kits de habilidades | Usan la clave de proveedor que esté activa, no tienen clave propia separada |
| Búsqueda de medios de stock | Tus propias claves de proveedor de stock, separadas de tu clave de IA |
Conectas proveedores y claves en Ajustes de IA. Para la configuración completa, consulta AI Studio y la matriz de proveedores y modelos para ver lo que cubre cada uno.
Obteniendo una clave
Cada proveedor emite claves desde su propia consola de desarrollador o sitio de plataforma, completamente fuera de la aplicación, te registras allí directamente y copias una clave en Ajustes de IA. La mayoría de los proveedores ofrecen un nivel gratuito o de prueba para empezar antes de que necesites agregar facturación en su lado.
Paso a paso: conectar tu primera clave de proveedor
- Obtén una clave de API del sitio de un proveedor de chat, OpenAI, Anthropic, Google, Qwen, DeepSeek, Kimi o GLM funcionan, o apunta a cualquier endpoint compatible con OpenAI que ya estés ejecutando.
- Abre Ajustes de IA desde el menú de tu cuenta y agrega la clave bajo ese proveedor.
- Usa la acción de probar conexión junto a la clave antes de depender de ella. Esto realiza una llamada pequeña y económica al proveedor usando tu clave completamente en el servidor, por lo que descubres de inmediato si la clave es incorrecta en lugar de descubrirlo a mitad de la generación. Un par de proveedores usados solo para imagen o video no tienen un endpoint ligero para probar; para esos, guardar correctamente es la confirmación.
- Abre AI Studio o el asistente en el editor e inicia un chat; usa el proveedor y modelo que seleccionaste por última vez para esa conversación.
- Si también quieres generar imágenes o video, agrega una clave para un proveedor de imagen y video por separado de tu proveedor de chat; se conectan de la misma manera pero se facturan y configuran por su cuenta.
Tareas comunes
- Cambiar de proveedor en medio de una tarea. Cambia el proveedor y modelo activos desde el compositor de chat en cualquier momento; cada proveedor mantiene su propio último modelo y configuración usados, por lo que al volver más tarde retomas donde lo dejaste con ese proveedor.
- Apuntar a un modelo autoalojado o local. Agrégalo como un endpoint personalizado con su URL base y clave. Si ese endpoint es una dirección local en lugar de una https pública, las solicitudes van directamente desde tu navegador a él en lugar de a través del servidor, lo cual es esperado para algo que se ejecuta en tu propia máquina. Un endpoint personalizado accesible solo a través de https desde un host público puede no funcionar a través del proxy del servidor hoy; si un endpoint personalizado alojado no se conecta, esa es la razón probable, usa un proveedor de chat de la lista principal cuando sea posible.
- Usar diferentes claves para diferentes tipos de generación. Chat, imagen y video leen cada uno de su propio proveedor conectado; no es necesario usar la misma empresa para los tres, elige el más fuerte o más barato para cada uno.
- Previsualizar el costo antes de generar video. El flujo de generación de video muestra un costo estimado, basado en la tarifa por segundo o por modelo de tu proveedor y la duración que elegiste, antes de comprometerte a ejecutarlo. Consulta Generación de video.
Solución de problemas
- Una clave que acabas de agregar aparece como inválida. Verifica que copiaste toda la clave sin espacio al final, y que está activa en el panel del proveedor, no solo creada. Usa la acción de probar conexión para confirmar antes de asumir que la aplicación tiene la culpa.
- La generación falla a mitad de camino con un error del proveedor. Esto casi siempre es el propio proveedor: un límite de tasa, una clave caducada o una facturación insuficiente configurada en su lado, no es algo que la aplicación pueda solucionar. Revisa el panel de ese proveedor para ver el uso y el estado de facturación.
- Un modelo que esperabas ver no está disponible. Los modelos disponibles varían según el proveedor, y el soporte de visión (comprensión de imágenes) se limita a modelos específicos dentro de un proveedor. Consulta la matriz de proveedores y modelos para ver lo que cada proveedor expone actualmente.
- Un endpoint personalizado a través de https desde un host público no responde. El proxy del lado del servidor solo reenvía a una lista fija de proveedores conocidos por seguridad; un endpoint https público arbitrario no se incluye automáticamente en esa lista. Un endpoint local no https es el caso admitido de endpoint personalizado; se conecta directamente desde tu navegador.
Por qué traer tu propia clave
Una clave gestionada significaría que la aplicación absorbe y recarga cada token, imagen y segundo de video que generas, y te ata a los modelos que la plataforma elija ofrecer. Traer tu propia clave significa que tus costos de IA escalan con tu uso real al precio real de tu proveedor, y puedes agregar un nuevo proveedor el día que te sea útil en lugar de esperar a que la plataforma lo agregue.
IA gestionada
Una opción gestionada, donde la plataforma proporciona IA sin que tú traigas una clave, está planificada. Hoy, la IA funciona completamente con tu propia clave. Consulta la Hoja de ruta.