Skip to main content

Conectar un proveedor en la nube

Qué es

Un proveedor en la nube es un modelo alojado al que se llega por HTTPS con una clave de API. Esta página lo configura desde /settings, usando OpenRouter como ejemplo.

Para qué

  • Usar un modelo alojado cuando no hay ningún servidor local en marcha.
  • Guardar el proveedor en el proyecto, para que la siguiente sesión arranque con él.

Cómo

  1. Arranca loom en tu proyecto y escribe /settings.
  2. Indica el tipo de proveedor, la URL base, el nombre de la variable de la clave y el modelo.
  3. Escribe la clave en el campo de clave y guarda. O define la variable fuera de Loomcoding.

Ejemplo​

La forma del loomcoding.toml del proyecto tras guardar, con marcadores:

model = "<model-id>"
max_steps = 8

[provider]
kind = "openai_compat"
base_url = "https://openrouter.ai/api/v1"
api_key_env = "OPENROUTER_API_KEY"

Si quieres guardar la clave en un fichero, copia el .env.example del repositorio a .env en la carpeta de tu proyecto, y escribe la clave después de OPENROUTER_API_KEY=.

De dónde sale la clave​

Loomcoding busca la clave en este orden y usa la primera que encuentra:

  1. La clave introducida en /settings, para ese guardado.
  2. La variable indicada en api_key_env, en el entorno del proceso loom.
  3. La misma variable, en el fichero .env de la carpeta del proyecto.
  4. La entrada del Administrador de credenciales de Windows que guarda /settings. Solo en Windows.

La clave nunca va a loomcoding.toml. El fichero guarda solo el nombre de la variable. Una dirección local (localhost, 127.0.0.1 o ::1) no necesita clave.

Ajustes y valores por defecto​

NombreValor por defectoRequiere reiniciar
[provider] kindObligatorio, sin valor por defecto. Uno de openai_compat, openai_responses, anthropic, geminiNo, tras /settings
[provider] base_urlObligatorio, sin valor por defecto. HTTPS, o HTTP para una dirección localNo, tras /settings
[provider] api_key_envVacío: ninguna variableNo, tras /settings
modelObligatorio, sin valor por defectoNo, tras /model o /settings
effortSin definir: el nivel por defectoNo, tras /effort

Resultado​

Cuando el guardado funciona, el siguiente prompt va al proveedor. Si falla, el mensaje indica qué campo corregir:

MensajeQué hacer
Model cannot be emptyEscribe un identificador de modelo.
Base URL is invalidComprueba que la URL esté completa.
Use HTTPS, or HTTP for a localhost endpointUsa https://. El HTTP plano solo vale para una dirección local.
Keep credentials out of the Base URL; use the API key environment variableQuita el usuario, la contraseña y cualquier cadena de consulta de la URL.
API key variable must be a valid environment variable nameUsa letras, cifras y guiones bajos, y no empieces por una cifra.
secure API key saving is only available on Windows; use the configured environment variableEn otros sistemas, define la variable en su lugar.
No API key configured. Open /settings and save your provider key.No se encontró clave en ninguno de los cuatro lugares anteriores.

Siguientes pasos​