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.
- 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:
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
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.
1
Abrir Key Management
Ve a Key Management y busca la clave de API que quieres configurar.
2
Abrir la configuración de acceso a modelos
Al crear o editar la clave, abre la sección Model Access.
3
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.
4
Guardar
Después de guardar, la nueva configuración de acceso a modelos puede tardar un tiempo en surtir efecto.
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 errormodel_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.
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.