> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Acceso a modelos para claves de API

El acceso a modelos controla qué modelos puede llamar una clave de API individual. No cambia el rango de modelos habilitados de tu equipo: solo reduce, dentro de ese rango, el conjunto de modelos que una clave determinada puede llamar. Las llamadas a modelos fuera del rango de acceso de una clave se rechazan.

<Info>
  Esta capacidad cubre los modelos de la línea de productos LLM. Las capacidades multimodales independientes de imagen y video no forman parte de la configuración de acceso a modelos por ahora.
</Info>

Casos de uso comunes:

* **Aislar claves por propósito**: permite que las claves de producción accedan solo a modelos estables y que las claves experimentales accedan solo a modelos de bajo costo.
* **Contener riesgos rápidamente**: cuando una clave desencadena llamadas inesperadas a modelos de alto costo, restríngela a unos pocos modelos seguros.
* **Colaboración externa**: para claves compartidas con contratistas o socios, expón solo los modelos acordados.

## Modos de acceso

Cada clave de API tiene uno de dos modos de acceso:

| Modo de acceso                | Significado                                                                                                                                                                                                                                                                            |
| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Todos los modelos habilitados | Modo predeterminado. La clave puede acceder a todos los modelos que tu equipo tiene habilitados actualmente, además de los modelos habilitados en el futuro, y puedes excluir modelos específicos. Los modelos habilitados en el futuro permanecen accesibles a menos que se excluyan. |
| Solo modelos seleccionados    | La clave solo puede acceder a los modelos que selecciones. Los modelos que tu equipo habilite más adelante no se agregan automáticamente; debes agregarlos tú mismo.                                                                                                                   |

En ambos modos, los modelos accesibles nunca superan el rango de modelos habilitados de tu equipo y nunca incluyen modelos que se hayan desconectado.

* Todos los modelos habilitados: modelos accesibles = modelos habilitados del equipo (incluidos los futuros) − modelos excluidos.
* Solo modelos seleccionados: modelos accesibles = modelos seleccionados (intersecados con los modelos habilitados del equipo).

## Configurar el acceso a modelos

<Note>
  Solo los administradores del equipo pueden configurar el acceso a modelos para una clave de API. Los miembros Developer y Basic ven un resumen de solo lectura para las claves a las que pueden acceder, pero no pueden editarlo; los miembros Billing no ven el acceso a modelos en absoluto.
</Note>

<Steps>
  <Step title="Abrir Key Management">
    Ve a [Key Management](https://novita.ai/settings/key-management) y busca la clave de API que quieres configurar.
  </Step>

  <Step title="Abrir la configuración de acceso a modelos">
    Al crear o editar la clave, abre la sección **Model Access**.
  </Step>

  <Step title="Elegir un modo de acceso">
    Selecciona **All enabled models** o **Selected models only**:

    * Para **All enabled models**, agrega los modelos que quieras bloquear en **Excluded models**.
    * Para **Selected models only**, agrega al menos un modelo en **Accessible models**.
  </Step>

  <Step title="Guardar">
    Después de guardar, la nueva configuración de acceso a modelos puede tardar un tiempo en surtir efecto.
  </Step>
</Steps>

<Tip>
  Al crear una clave nueva o editar una existente, puedes reutilizar la configuración de otra clave dentro del mismo equipo con **Copy config** y **Paste config**. Después de pegarla, puedes guardar directamente o ajustarla primero.
</Tip>

## Cuando un modelo se desconecta

Si la plataforma desconecta un modelo, este sale del conjunto de modelos disponibles:

* Todas las llamadas a ese modelo devuelven inmediatamente una respuesta de "model unavailable".
* Si la configuración guardada de una clave todavía contiene el modelo desconectado, permanece visible pero atenuado. Debes quitarlo antes de guardar; de lo contrario, la configuración no se podrá guardar.

## Cuando se rechaza una llamada

Cuando una clave de API llama a un modelo fuera de su rango de acceso, la llamada devuelve HTTP 403 con el código de error `model_access_denied`, lo que indica que la clave no puede acceder a ese modelo. Contacta con el administrador de tu equipo para ajustar el acceso a modelos de la clave. Consulta también [Códigos de error comunes](/docs/es/guides/error).

Para gestionar el acceso a modelos de una clave mediante programación, consulta [Obtener la política de acceso a modelos de la clave de API](/docs/es/api-reference/key-get-model-access-policy).