# Proveedores de modelos y la clave de prueba

Cada código de esta familia: qué significa, su causa más frecuente, qué hacer y quién puede hacerlo.

[Todos los códigos de error](https://www.azothos.ai/es/docs/errors)

### `provider_key_rejected`

- **Qué significa**: El proveedor de modelos rechazó la clave API que introdujiste, así que no se guardó.
- **Causa más frecuente**: Una clave revocada en el proveedor, copiada de forma incompleta o procedente de otra cuenta u otro proyecto.
- **Qué hacer**: El proveedor rechazó esta clave API, así que no se guardó. Cópiala de nuevo desde la consola del proveedor: puede estar revocada o incompleta.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/settings?section=providers)

### `provider_permission_denied`

- **Qué significa**: El proveedor de modelos aceptó la clave API del espacio de trabajo pero rechazó esta llamada (HTTP 403).
- **Causa más frecuente**: La cuenta o el proyecto de la clave no tiene acceso al modelo, el modelo no se ofrece en su región, o a la clave le falta un permiso que la llamada necesita (una clave restringida o de solo lectura).
- **Qué hacer**: El proveedor aceptó la clave pero rechazó esta llamada: su cuenta o proyecto no tiene acceso a este modelo, en esta región, o le falta un permiso. Conceda el acceso en la consola del proveedor o elija otro modelo; cambiar la clave no servirá.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo

### `provider_key_unusable`

- **Qué significa**: El texto introducido no es una clave API que el proveedor acepte para llamar a un modelo, así que no se guardó.
- **Causa más frecuente**: Una clave de administración, o el token de inicio de sesión de una suscripción (una aplicación de chat, una herramienta de código), en lugar de una clave API estándar, o una clave copiada con un espacio, un salto de línea u otro carácter dentro.
- **Qué hacer**: No es una clave API que pueda hacer llamadas a modelos, así que no se guardó: una clave de administración, un token de inicio de sesión o una copia con un espacio, un salto de línea o un carácter extraño dentro. Crea una clave API estándar en la consola del proveedor y pégala sola.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/settings?section=providers)

### `provider_key_storage_unavailable`

- **Qué significa**: Azoth no pudo cifrar la clave, así que no la guardó: este despliegue no puede almacenar claves de proveedor en este momento.
- **Causa más frecuente**: Un problema de configuración del despliegue (falta el ajuste de cifrado de las claves almacenadas o no es válido), no un problema de la clave. Fuera de SaaS, lo corrige el operador del despliegue.
- **Qué hacer**: La clave no se guardó: este despliegue no puede almacenar claves de proveedor en este momento. Tu clave no tiene ningún problema: contacta con soporte para que lo corrijan y vuelve a guardarla.
- **Quién puede hacerlo**: Azoth, o el operador de este despliegue

### `provider_not_connected`

- **Qué significa**: La llamada va a un proveedor para el que el espacio de trabajo no tiene ninguna clave API.
- **Causa más frecuente**: El proveedor nunca se conectó, o se eliminó su clave.
- **Qué hacer**: No hay ninguna clave API de este proveedor conectada al espacio. Añádala en Ajustes › Proveedores y modelos.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/settings?section=providers)

### `provider_model_not_found`

- **Qué significa**: El proveedor no ofrece este modelo, o tu clave no puede usarlo.
- **Causa más frecuente**: Un nombre de modelo mal escrito o retirado, o un modelo al que tu cuenta con el proveedor no tiene acceso.
- **Qué hacer**: El proveedor no ofrece este modelo o su clave no puede usarlo. Compruebe el nombre del modelo o elija otro.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `azure_config_required`

- **Qué significa**: Una llamada a Azure OpenAI no nombra el recurso o el despliegue al que va, así que no puede enviarse.
- **Causa más frecuente**: Falta el campo `azureEndpoint` o `azureDeployment` en la solicitud, o una regla envía la llamada a Azure OpenAI sin que quien llama los haya enviado.
- **Qué hacer**: Una llamada a Azure OpenAI debe nombrar su recurso y su despliegue: envíe azureEndpoint y azureDeployment con ella.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `azure_endpoint_not_allowed`

- **Qué significa**: El `azureEndpoint` de una llamada a Azure OpenAI no es un host de Azure OpenAI, así que no se le envía la clave del espacio de trabajo.
- **Causa más frecuente**: El punto de acceso nombra otro host, un puerto, un nombre de usuario o http simple — o un proxy delante de Azure.
- **Qué hacer**: Azure OpenAI solo se alcanza en sus propios hosts: indique en azureEndpoint https://<recurso>.openai.azure.com (o su host de Azure AI services).
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `invalid_azure_deployment`

- **Qué significa**: El `azureDeployment` de una llamada a Azure OpenAI no es un nombre de despliegue que Azoth pueda poner en la solicitud.
- **Causa más frecuente**: El nombre contiene un `/`, un `?`, `..` o un espacio, o supera los 64 caracteres.
- **Qué hacer**: Un nombre de despliegue de Azure solo contiene letras, cifras, puntos, guiones y guiones bajos, 64 como máximo: envíe el nombre del despliegue tal como lo muestra Azure.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `endpoint_url_not_allowed`

- **Qué significa**: Una dirección que Azoth debía llamar — la URL base de Ollama, un destino de exportación de auditoría, un punto de acceso S3 — se rechaza antes de cualquier solicitud: no es una dirección pública.
- **Causa más frecuente**: La dirección está en una red privada, el bucle local o un rango link-local, se resuelve a uno, o usa otro esquema que http(s); el campo `reason` de la respuesta dice cuál.
- **Qué hacer**: Azoth no llama a esta dirección: indique una dirección https pública — sin red privada, bucle local ni host link-local, sin nombre de usuario. El campo reason de la respuesta dice qué se rechazó.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `ollama_endpoint_missing`

- **Qué significa**: Esta llamada se bloqueó: este espacio no tiene dirección de Ollama.
- **Causa más frecuente**: La pasarela solo llama a Ollama en la dirección que el espacio guardó en Ajustes › Proveedores y modelos, y no hay ninguna guardada.
- **Qué hacer**: Pida a un propietario o a un administrador que guarde la dirección de su servidor Ollama en Ajustes › Proveedores y modelos y envíe la llamada de nuevo.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/settings?section=providers)

### `ollama_endpoint_not_declared`

- **Qué significa**: Esta llamada se bloqueó: indica una dirección de Ollama que este espacio no guardó.
- **Causa más frecuente**: La pasarela solo llama a Ollama en la dirección guardada en Ajustes › Proveedores y modelos; el ollamaBaseUrl de la llamada es otra.
- **Qué hacer**: Quite ollamaBaseUrl de la llamada, o envíe exactamente la dirección guardada. Para otro servidor, un propietario o un administrador guarda allí su dirección.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada · [Abrir la pantalla](https://www.azothos.ai/dashboard/settings?section=providers)

### `provider_rate_limited`

- **Qué significa**: El proveedor rechazó la llamada por un límite de frecuencia o un límite de crédito de tu cuenta con él.
- **Causa más frecuente**: Demasiadas llamadas en poco tiempo, o no queda crédito con el proveedor.
- **Qué hacer**: El proveedor rechazó la llamada: se alcanzó el límite de uso o no queda crédito en su cuenta. Revise su plan y facturación con el proveedor y vuelva a intentarlo.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo

### `provider_payment_required`

- **Qué significa**: El proveedor de modelos rechazó la llamada por un motivo de facturación (HTTP 402, o un rechazo que su error designa como tal).
- **Causa más frecuente**: La cuenta del proveedor asociada a la clave API del espacio de trabajo no tiene crédito, su método de pago falló o caducó, alcanzó un límite de gasto, o su plan se canceló.
- **Qué hacer**: El proveedor rechazó la llamada por un motivo de facturación: su cuenta asociada a la clave de este espacio de trabajo no tiene crédito o no tiene un método de pago válido, o alcanzó un límite de gasto. Añada crédito, regularice la facturación o aumente el límite en la consola del proveedor y vuelva a enviar la llamada.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo

### `provider_request_too_large`

- **Qué significa**: El proveedor de modelos rechazó la llamada porque la solicitud es más grande de lo que acepta para el modelo (HTTP 413).
- **Causa más frecuente**: Demasiados mensajes o mensajes demasiado largos, o un adjunto grande, en una sola llamada.
- **Qué hacer**: El proveedor rechazó la llamada: la solicitud es más grande de lo que acepta para este modelo. Envíe menos mensajes o adjuntos, o mensajes más cortos, y vuelva a enviar la llamada.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `provider_request_rejected`

- **Qué significa**: El proveedor de modelos rechazó la llamada sin atenderla (HTTP 400, 422 u otro 4xx), por un motivo que un nuevo intento no corrige.
- **Causa más frecuente**: Lo más habitual, una cuenta del proveedor sin crédito (algunos proveedores rechazan entonces cada llamada con un 400); si no, un parámetro que el modelo no acepta: una opción, un formato de mensaje o mensajes más largos que el contexto del modelo.
- **Qué hacer**: El proveedor rechazó la llamada y volver a intentarlo no servirá hasta corregir la causa. Revise primero el crédito y la facturación de su cuenta asociada a la clave de este espacio de trabajo, en la consola del proveedor (algunos proveedores rechazan así cada llamada cuando la cuenta se queda sin crédito), y después los parámetros de la llamada: las opciones del modelo, el formato y la longitud de los mensajes.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo

### `provider_not_supported`

- **Qué significa**: Esta llamada fue bloqueada: una regla la envía a un proveedor que este punto de acceso no puede alcanzar.
- **Causa más frecuente**: Una regla de su espacio de trabajo redirige esta llamada a ‹proveedor›, que este punto de acceso no admite.
- **Qué hacer**: Use el punto de acceso /api/v1/chat, o pida al propietario de la regla que cambie su redirección.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/regles?tab=rules)

### `provider_failure`

- **Qué significa**: El proveedor no respondió.
- **Causa más frecuente**: El proveedor del modelo devolvió un error. Azoth no facturó nada.
- **Qué hacer**: Inténtelo de nuevo, o elija otro modelo.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `onboarding_no_provider`

- **Qué significa**: Esta primera llamada no se envió: no hay ningún proveedor de modelos conectado al espacio de trabajo.
- **Causa más frecuente**: La primera llamada va a su propio proveedor, con su propia clave: Azoth no envía ninguna llamada sin ella.
- **Qué hacer**: Conecte un proveedor en Ajustes › Proveedores y modelos (o en el formulario de esta página) y vuelva a enviarla.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_exhausted`

- **Qué significa**: La clave de prueba de Azoth ya no responde a las llamadas de este espacio de trabajo.
- **Causa más frecuente**: Sus llamadas de prueba se agotaron: la clave de prueba sirve para un primer ensayo, no para un uso habitual.
- **Qué hacer**: Conecte su propia clave de proveedor en Ajustes › Proveedores y modelos: sus llamadas pasan luego por Azoth exactamente como antes.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_unavailable`

- **Qué significa**: La clave de prueba de Azoth no puede responder a esta llamada.
- **Causa más frecuente**: La clave de prueba solo atiende espacios de trabajo en Free o en prueba, dentro de un límite diario compartido por todos, y solo mientras la IA propia de Azoth funciona.
- **Qué hacer**: Conecte su propia clave de proveedor en Ajustes › Proveedores y modelos, o vuelva a intentarlo más tarde.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_limits_exceeded`

- **Qué significa**: Esta llamada queda fuera de lo que responde la clave de prueba de Azoth.
- **Causa más frecuente**: La clave de prueba solo responde a llamadas cortas, sin streaming, a su único modelo.
- **Qué hacer**: Envíe una llamada más corta, sin streaming, al modelo de la prueba, o conecte su propia clave de proveedor en Ajustes › Proveedores y modelos.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada · [Abrir la pantalla](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_not_eligible`

- **Qué significa**: La clave de prueba de Azoth solo se ofrece a los espacios de trabajo en Free o en su periodo de prueba.
- **Causa más frecuente**: El espacio de trabajo tiene un plan de pago.
- **Qué hacer**: La clave de prueba de Azoth es para espacios de trabajo en Free o en prueba.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_already_used`

- **Qué significa**: La clave de prueba de Azoth se ofrece una sola vez por persona.
- **Causa más frecuente**: Ya la activaste en otro espacio de trabajo.
- **Qué hacer**: Ya usó una clave de prueba de Azoth en otro espacio de trabajo. Conecte su propia clave de proveedor en Ajustes › Proveedores y modelos.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/settings?section=providers)

### `egress_blocked`

- **Qué significa**: Esta llamada fue bloqueada: este despliegue no puede alcanzar ‹proveedor›.
- **Causa más frecuente**: Este Azoth funciona sin acceso a Internet y solo alcanza los hosts que su operador autorizó; ‹proveedor› no es uno de ellos.
- **Qué hacer**: Use un modelo alojado internamente por el despliegue, o pregunte al operador si ‹proveedor› debe autorizarse. Este ajuste pertenece al despliegue, no a una regla.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `secnumcloud_blocked`

- **Qué significa**: Esta llamada fue bloqueada: el proveedor no tiene la certificación SecNumCloud.
- **Causa más frecuente**: Este despliegue solo permite proveedores certificados SecNumCloud, y ‹proveedor› no es uno de ellos.
- **Qué hacer**: Use un proveedor certificado propuesto abajo. Este ajuste pertenece al despliegue, no a una regla.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada
