​

Claves de API

Usa API Keys cuando necesites credenciales para llamar a los despliegues de Fetch Hive desde tu propia aplicación o servicio. Esta página gestiona las claves de API del espacio de trabajo, no las claves de proveedores externos para uso personal de modelos.

​

Visión general

La página separa tu Default API Key de cualquier clave adicional que crees para entornos o servicios específicos. Las claves adicionales aparecen en una tabla donde puedes buscar, filtrar, rotar, revocar y revisar la actividad de último uso. Fetch Hive admite claves específicas por entorno, de modo que puedes mantener separado el acceso a Production, Staging y Development.

​

¿Cómo creo una clave de API?

Abre Settings en la barra lateral y luego haz clic en API Keys. Si el espacio de trabajo aún no tiene una clave por defecto, haz clic en Create Default Key. Si quieres una clave adicional, haz clic en Add API Key. Introduce un nombre y elige el entorno. Los propietarios y administradores también pueden marcar Permitir que esta clave apruebe acciones automáticamente. Así, las solicitudes hechas con la clave pueden enviar tool_approval: "auto_approve". Los miembros ven la casilla y no pueden cambiarla. Las acciones destructivas y las reglas de denegación siguen aplicando. Consulta Aprobaciones de acciones del agente. Elige el entorno:

• Production
• Staging
• Development

Guarda la clave. Fetch Hive mostrará entonces Your New API Key. Copia la clave completa de inmediato. El valor completo solo se muestra cuando la clave se crea o rota por primera vez.

​

¿Cómo roto o revoco una clave?

Encuentra la clave que quieres cambiar en Default API Key o en la tabla de claves adicionales. Usa Rotate Key cuando quieras reemplazar el secreto actual por uno nuevo. Usa Revoke cuando quieras deshabilitar una clave y evitar su uso futuro. Fetch Hive te pide confirmar cualquiera de las dos acciones antes de continuar.

​

¿Por qué solo puedo copiar parte de una clave?

Después de que el diálogo de creación o rotación se cierra, la página conserva el prefijo enmascarado de la clave como referencia, pero normalmente ya no tiene disponible el valor completo de la clave para copiar. Por eso debes copiar el secreto completo desde Your New API Key antes de cerrar ese diálogo. La vista enmascarada sigue siendo útil para confirmar qué clave estás revisando y verificar su entorno, estado e información de último uso.

​

¿Cómo limito lo que puede gastar una clave?

Puedes establecer un límite de gasto mensual en cualquier clave de API. Abre Edit en la clave y usa Límite de gasto mensual.

• Avisar en (USD): cuando el gasto de la clave este mes supera este importe, Fetch Hive envía un correo al propietario de la cuenta una sola vez.
• Bloquear en (USD): cuando el gasto de la clave este mes alcanza este importe, las nuevas solicitudes hechas con esa clave se rechazan con un error spend_cap_exceeded. Las demás claves del espacio de trabajo siguen funcionando.

Los límites cuentan el gasto de IA alojada del mes natural (UTC) y se reinician el primer día de cada mes. Una solicitud que ya está en curso cuando se alcanza el límite se completa y se factura; la siguiente se bloquea. También puedes fijar un límite para todo el espacio de trabajo en Workspace Settings. La columna Límite mensual de la página de claves de API muestra el gasto hasta ahora frente al límite de cada clave. Solo los propietarios y administradores de la cuenta pueden cambiar los límites. Consulta Códigos de error para ver la respuesta spend_cap_exceeded.

​

¿En qué se diferencia esto de las credenciales de proveedor?

Las claves de API del espacio de trabajo autentican las solicitudes a los despliegues de Fetch Hive. Son distintas de las credenciales de proveedor que conectas para el tipo de cargo Personal. Para ese flujo, consulta Usa tu propia clave de API y Integraciones.