Conectar un proveedor

AI Studio funciona con la clave de tu propio proveedor, que se conecta desde Settings, AI Settings, en la pestaña Provider & Model. Antes de poder chatear o generar, conecta al menos un proveedor. Consulta Usa tu propia clave de IA para entender la idea detrás de esto.

Vistazo rápido

1. Abre Settings, AI Settings y elige una pestaña de proveedor.
2. Pega tu clave de API.
3. Elige un modelo de la lista de ese proveedor.
4. Define un esfuerzo de razonamiento y, si quieres, un prompt de sistema, la temperatura y el máximo de tokens.
5. Prueba la conexión y luego activa el proveedor para el chat.

El flujo de configuración

Para cada proveedor, los pasos son los mismos tres campos, más los ajustes avanzados opcionales.

Paso	Detalle
Clave de API	Un campo con la contraseña oculta. Una vez guardada, solo se muestra como una pista breve, nunca el valor completo
Modelo	Un desplegable de los modelos disponibles de ese proveedor
Esfuerzo de razonamiento	Un conjunto de niveles específico del proveedor, que se muestra solo en proveedores con capacidad de chat
Prueba	Envía una pequeña solicitud para confirmar que la clave funciona antes de que dependas de ella
Usar para el chat	Un interruptor que convierte a este en el proveedor activo para el chat

Las opciones de esfuerzo de razonamiento varían según el proveedor, por ejemplo Default, Low, Medium, High y a veces Extra High o Max en proveedores compatibles con un razonamiento más profundo; un proveedor sin esta capacidad se salta el control por completo. El valor se aplica automáticamente a cada solicitud de chat de ese proveedor, no hay un interruptor por mensaje en el compositor.

La pantalla de ajustes de un vistazo

La pestaña Provider & Model muestra a la izquierda una lista de todos los proveedores. Un icono de escudo marca cada proveedor que ya tiene una clave guardada, y el que actualmente impulsa el chat lleva la etiqueta Active. Una franja de resumen en la parte superior siempre te indica qué proveedor y modelo está usando el chat ahora mismo, y si hay una clave conectada, para que puedas confirmar tu configuración sin abrir ningún panel.

Haz clic en un proveedor de esa lista para abrir su panel a la derecha, organizado en tres pasos numerados:

1. API Key, un campo oculto. Una vez que guardas, se contrae a un botón Change y un control de eliminar (papelera), y nunca vuelve a mostrar la clave completa.
2. Model, un desplegable de los modelos de ese proveedor, con el valor predeterminado sensato marcado como recommended.
3. Try it, el botón Test connection.

Si el proveedor admite razonamiento ajustable, un pequeño desplegable Reasoning en línea aparece entre el Paso 2 y el Paso 3. Debajo de los tres pasos, un acordeón Advanced (optional) contiene los ajustes más finos. Activar un proveedor para el chat es el interruptor Use for chat: no puedes desactivarlo directamente mientras ese proveedor es el activo, en su lugar activas un proveedor distinto, lo que automáticamente le pasa la etiqueta Active.

Opciones avanzadas

Una sección opcional y contraída añade un control más fino.

Ajuste	Rango	Notas
Prompt de sistema	Texto libre	Instrucciones personalizadas superpuestas bajo cada respuesta
Temperatura	0 a 1.5	Etiquetada como Precise, Balanced o Creative a medida que mueves el control deslizante
Máximo de tokens	256 a 16384	Predeterminado 2048. Limita cuánto puede extenderse una sola respuesta

Cada campo avanzado se guarda por su cuenta en cuanto haces clic fuera de él (al perder el foco), con un pequeño aviso de confirmación, así que no hay un botón Save aparte para estos tres. Una vez conectada, tu clave se muestra oculta, y puedes cambiarla o eliminarla cuando quieras. Puedes conectar tantos proveedores como quieras a la vez, cada uno conserva su propia clave, modelo y esfuerzo de razonamiento de forma independiente, así que no hay nada que reconfigurar cuando cambias cuál está activo.

Niveles de esfuerzo de razonamiento por proveedor

El conjunto exacto de niveles varía según el proveedor, algunos llegan más lejos que otros.

Proveedor	Niveles
OpenAI	Default, Off, Low, Medium, High, Extra High
Anthropic Claude	Default, Low, Medium, High, Extra High, Max
DeepSeek	Default, Off, High, Max (sin nivel Low ni Medium)
Qwen	Default (off, recommended), Low, Medium, High
Kimi	Default, Off, On (un simple encendido o apagado, sin niveles graduados)
GLM	Default, Off, On; un modelo GLM de gama más alta desbloquea además Low, High y Max por encima del encendido o apagado básico
Google Gemini	Default, Minimal, Low, Medium, High

Un proveedor que no tiene ningún control de razonamiento, como uno que no admite esfuerzo ajustable, simplemente se salta este campo.

Paso a paso

La pantalla se ve igual para cada proveedor, así que una vez que lo hagas una vez, los demás son rápidos. Estos recorridos usan clics y ubicaciones exactas.

Conectar una clave de OpenAI y prepararte para chatear

1. Abre Settings, AI Settings y quédate en la pestaña Provider & Model.
2. En la lista de proveedores de la izquierda, haz clic en OpenAI. Su panel se abre a la derecha.
3. En Step 1, API Key, pega tu clave en el campo oculto. Si aún no tienes una, usa el pequeño enlace externo junto al nombre del proveedor para abrir la propia consola de desarrolladores de OpenAI y crear una clave en su página de claves de API, luego vuelve y pégala. Haz clic en Save.
4. En Step 2, Model, elige un modelo del desplegable, o deja el que ya está marcado como recommended.
5. Si aparece un desplegable Reasoning entre el Paso 2 y el Paso 3, elige un nivel o déjalo en Default.
6. En Step 3, Try it, haz clic en Test connection y espera el mensaje "Connection successful, key is valid."
7. Activa el interruptor Use for chat si OpenAI no está ya etiquetado como Active. Eso lo convierte en el proveedor que usa el chat.
8. Opcional: abre el acordeón Advanced (optional) para añadir instrucciones del asistente (un prompt de sistema), ajustar la creatividad (temperatura) o limitar la longitud máxima de respuesta. Cada uno de esos campos se guarda por su cuenta al hacer clic fuera, así que no hay nada más que pulsar.

Configurar un proveedor solo de vídeo como fal.ai

1. Abre la pestaña Settings, AI Settings, Provider & Model y haz clic en fal.ai en la lista de la izquierda.
2. Pega tu clave de fal.ai (con el formato de un id de clave y un secreto unidos por dos puntos) en el campo API Key y haz clic en Save. La obtienes en la página Keys del panel de fal.ai, a la que llegas desde el enlace externo junto al nombre del proveedor.
3. Fíjate en que aquí no hay desplegable de modelo ni interruptor Use for chat. fal.ai es un motor de generación, así que su tarjeta muestra un distintivo Video engine en su lugar, y explica que el modelo real se elige más tarde, en el momento de generar.
4. Al hacer clic en Test devuelve "Key saved (this provider has no live test)" en lugar de validarla de verdad, porque este proveedor no tiene un endpoint económico al que hacer ping. Eso es lo esperado, no un error.
5. Elige el modelo cuando generes: en el modo Video del compositor (Seedance 2.0, Seedance 2.0 Fast, Veo 3.1, Veo 3.1 Fast o Kling 2.6), o dentro de Marketing Studio. Consulta Generar vídeo para conocer los controles del modo. BytePlus funciona de la misma manera, con un distintivo Video + image engine, y también elige su modelo en el momento de generar.

Cambiar tu proveedor de chat activo sin perder tus otras claves

1. Abre la pestaña Settings, AI Settings, Provider & Model.
2. En la lista de la izquierda, haz clic en un proveedor distinto que ya tenga una clave guardada, señalado por un icono de escudo.
3. Activa su interruptor Use for chat. Se convierte en el proveedor de chat Active de inmediato, y el anterior pierde la etiqueta Active por su cuenta (nunca desactivas el antiguo a mano).

Todos los demás proveedores conservan su clave, su modelo elegido y su nivel de razonamiento guardados, así que volver a uno más tarde no requiere reconfiguración. No se pierde nada de lo que conectaste al cambiar cuál está activo.

Conectar un endpoint autoalojado o personalizado compatible con OpenAI

1. Abre la pestaña Settings, AI Settings, Provider & Model y haz clic en Custom Endpoint en la lista.
2. Introduce una Base URL y un Model Name en lugar de elegir de un desplegable de modelos fijo.
3. Aquí no hay una prueba de conexión en vivo: el área del botón dice "No test for a custom provider, try it in chat" en su lugar. Envía un mensaje en el chat para confirmar que funciona.
4. Activa Use for chat para dejarlo activo.

Un endpoint personalizado es el único proveedor cuya clave no se cifra en el servidor ni se enruta por proxy, ya que no hay un host fijo por el que redirigir. Su clave permanece en tu navegador y las solicitudes van directas desde el navegador a la Base URL que escribiste, así que usa solo un endpoint en el que confíes. Este es el mismo comportamiento indicado en Endpoint personalizado más abajo.

Tus claves están seguras

Las claves se guardan en el servidor

Tu clave se cifra en reposo en el servidor y nunca se envía de vuelta al navegador. Cada llamada al proveedor se hace desde el servidor en tu nombre, así que la propia página nunca guarda tu clave real, solo un marcador en su lugar.

No todos los proveedores se pueden probar en vivo

Test Connection hace una solicitud real para la mayoría de los proveedores. Un par de proveedores solo de vídeo no exponen un endpoint adecuado para una prueba en vivo, así que guardar la clave allí simplemente confirma que se almacenó, no que funciona.

Qué proveedores

Distintos proveedores admiten cosas distintas: algunos solo impulsan el chat, algunos solo generan imágenes o vídeo, y un par hacen ambas cosas. Consulta la Matriz de proveedores y modelos para ver el desglose completo por modo.

Endpoint personalizado

Si tu proveedor habla el formato de chat completions compatible con OpenAI, conéctalo como un Custom Endpoint dando una Base URL y un Model Name en lugar de elegir de una lista fija. Esta es la forma de usar un modelo autoalojado o un proveedor menos común.

Los endpoints personalizados se saltan el proxy del servidor

Los proveedores con nombre se llaman desde el servidor, así que tu navegador nunca habla con ellos directamente. Un endpoint personalizado es la única excepción: como no hay una ruta de proxy integrada para una URL arbitraria, las solicitudes a él se envían directas desde tu navegador a la dirección que indiques, y su clave permanece en el navegador en lugar de cifrarse en el servidor.

Cambiar o quitar una clave

Vuelve a la misma pestaña de proveedor cuando quieras para pegar una clave nueva sobre la antigua, o eliminarla por completo. Eliminar una clave no elimina los modelos ni las conversaciones que ya usaste con ella, solo impide que ese proveedor sea utilizable hasta que añadas una clave de nuevo. Si el proveedor que eliminas era el proveedor de chat activo, activa un proveedor conectado distinto antes de volver a chatear.

Si una clave no funciona

Una Test Connection fallida casi siempre significa una de unas pocas cosas: la clave se escribió mal o tiene espacios en blanco al final, la clave pertenece a un producto distinto de la misma empresa, o la cuenta detrás de la clave aún no tiene cuota ni facturación configurada del lado del propio proveedor. El mensaje de error que devuelve el proveedor se muestra tal cual, así que revísalo primero antes de suponer que la culpa es de la app.

Solución de problemas

El esfuerzo de razonamiento se reinicia en un navegador o dispositivo nuevo

A diferencia de tu clave de API, que está cifrada y guardada en el servidor de modo que te sigue a cualquier dispositivo en el que inicies sesión, el nivel de esfuerzo de razonamiento que eliges por proveedor se guarda solo en el almacenamiento local del navegador actual. No viaja a un navegador distinto, un ordenador distinto ni una ventana privada, donde vuelve a empezar en Default. Si tus respuestas se sienten de pronto más superficiales tras cambiar de máquina, vuelve a elegir el nivel de razonamiento allí. Tu clave, modelo y ajustes avanzados no se ven afectados, solo el nivel de razonamiento es local del navegador.

Qué significa cada mensaje de Test connection

Test connection asigna un error bruto del proveedor a un mensaje breve y sencillo, y tiene un límite de 10 pruebas por minuto por cuenta.

Mensaje	Qué significa
Connection successful, key is valid.	La clave funcionó y el proveedor respondió.
Key saved (this provider has no live test)	fal.ai y BytePlus no tienen un endpoint económico al que hacer ping, así que guardar la clave es todo lo que se confirma.
No test for a custom provider, try it in chat	Un endpoint personalizado no tiene acción de prueba; envía un mensaje de chat para comprobarlo.
Key is invalid, you may have copied it incompletely	El proveedor rechazó la clave (un error tipo 401 o 403). Vuelve a copiarla completa.
Provider is busy (429), try again shortly	El proveedor devolvió un límite de frecuencia (429). Espera un momento y reintenta.
Could not reach the provider (network/CORS)	Un fallo de red o de CORS impidió que la solicitud llegara.
Save your key first.	Aún no hay ninguna clave guardada que probar.
Too many tests, try again in a minute.	Superaste las 10 pruebas en un minuto; haz una breve pausa e inténtalo de nuevo.

Eliminar una clave no borra lo que creaste

Quitar la clave de un proveedor solo detiene las nuevas solicitudes a él. Tu galería de imágenes y clips generados, y las conversaciones que ya tuviste, permanecen en su sitio. Consulta Cambiar o quitar una clave más arriba para conocer los pasos exactos.

Relacionado

• Usa tu propia clave de IA
• Matriz de proveedores y modelos
• Usar el chat de IA
• Asistente de chat de IA para la versión dentro del editor de esta misma configuración