Link to this sectionClaves API#

Las claves API de Ultralytics Platform permiten un acceso programático seguro para el entrenamiento remoto, la inferencia y la automatización. Crea claves con nombre utilizando cifrado AES-256-GCM para diferentes casos de uso.

Link to this sectionCrear clave de API#

Crea una nueva clave API:

1. Ve a Settings > API Keys
2. Haz clic en Create Key
3. Introduce un nombre para la clave (por ejemplo, "Training Server")
4. Haz clic en Create Key

Link to this sectionNombre de la clave#

Dale a tu clave un nombre descriptivo:

• training-server - Para máquinas de entrenamiento remoto
• ci-pipeline - Para integración CI/CD
• local-dev - Para desarrollo local

Link to this sectionVisualización de la clave#

Tras su creación, la clave se muestra una única vez:

Link to this sectionFormato de la clave#

Las claves API siguen este formato:

• Prefijo: ul_ identifica las claves de Ultralytics
• Cuerpo: 40 caracteres hexadecimales aleatorios
• Total: 43 caracteres

Link to this sectionSeguridad de la clave#

• Las claves se almacenan con cifrado AES-256-GCM
• La autenticación utiliza un hash SHA-256 para una búsqueda indexada rápida
• Los valores completos de las claves nunca se almacenan en texto plano

Link to this sectionUso de claves API#

Link to this sectionVariable de entorno#

Define tu clave como una variable de entorno:

export ULTRALYTICS_API_KEY="YOUR_API_KEY"

Link to this sectionYOLO CLI#

Configura la clave utilizando el YOLO CLI:

yolo settings api_key="YOUR_API_KEY"

Link to this sectionEn el código#

Utiliza la clave en tus scripts de Python:

import os

# From environment (recommended)
api_key = os.environ.get("ULTRALYTICS_API_KEY")

# Or directly (not recommended for production)
api_key = "YOUR_API_KEY"

Link to this sectionCabeceras HTTP#

Incluye la clave en las solicitudes API:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://platform.ultralytics.com/api/...

Consulta la referencia de la REST API para ver todos los puntos de conexión disponibles.

Link to this sectionEntrenamiento remoto#

Habilita la transmisión de métricas con tu clave.

pip install "ultralytics>=8.4.60"

export ULTRALYTICS_API_KEY="YOUR_API_KEY"
yolo train model=yolo26n.pt data=coco.yaml project=username/project name=exp1

Consulta Cloud Training para obtener la guía completa de entrenamiento remoto.

Link to this sectionGestionar claves#

Link to this sectionVer claves#

Todas las claves aparecen en la pestaña Settings > API Keys:

Cada tarjeta de clave muestra el nombre de la clave, el valor completo descifrado (copiable), la fecha de creación relativa y un botón para revocar.

Link to this sectionRevocar clave#

Revoca una clave si está comprometida o ya no es necesaria:

1. Busca la clave en la sección de claves API
2. Haz clic en el botón Revocar (papelera)
3. Confirma la revocación

Link to this sectionRegenerar clave#

Si una clave está comprometida:

1. Crea una nueva clave con el mismo nombre
2. Actualiza tus aplicaciones
3. Revoca la clave antigua

Link to this sectionClaves API del espacio de trabajo#

Las claves API están limitadas al espacio de trabajo activo actualmente:

• Espacio de trabajo personal: Las claves se autentican como tu cuenta personal
• Espacio de trabajo de equipo: Las claves se autentican dentro del contexto del equipo

Al cambiar de espacio de trabajo en la barra lateral, la sección de claves API muestra las claves para ese espacio de trabajo. Se requiere un rol de Editor o superior para gestionar las claves API del espacio de trabajo. Consulta Teams para obtener detalles sobre los roles.

Link to this sectionBuenas prácticas de seguridad#

Link to this sectionHaz lo siguiente#

• Almacena las claves en variables de entorno
• Utiliza claves separadas para diferentes entornos
• Revoca las claves no utilizadas rápidamente
• Rota las claves periódicamente
• Utiliza nombres descriptivos para identificar el propósito de cada clave

Link to this sectionNo hagas lo siguiente#

• Confirma las claves en el control de versiones
• Comparte claves entre aplicaciones
• Registra las claves en la salida de la aplicación
• Inserta claves en código del lado del cliente

Link to this sectionRotación de claves#

Rota las claves periódicamente por seguridad:

1. Crea una nueva clave con el mismo nombre
2. Actualiza las aplicaciones para usar la nueva clave
3. Verifica que las aplicaciones funcionen correctamente
4. Revoca la clave antigua

Link to this sectionSolución de problemas#

Link to this sectionError de clave no válida#

Soluciones:

1. Verifica que la clave se haya copiado correctamente (incluyendo el prefijo ul_)
2. Comprueba que la clave no haya sido revocada
3. Confirma que la variable de entorno esté definida
4. Asegúrate de estar utilizando ultralytics>=8.4.60

Link to this sectionPermiso denegado#

Soluciones:

1. Verifica que eres el propietario del recurso o que tienes el acceso apropiado al espacio de trabajo
2. Comprueba que la clave pertenezca al espacio de trabajo correcto
3. Crea una nueva clave si es necesario

Link to this sectionLímite de frecuencia superado (Rate Limited)#

Soluciones:

1. Reduce la frecuencia de las solicitudes; consulta la tabla de límites de frecuencia para ver los límites por punto de conexión
2. Implementa un retroceso exponencial utilizando la cabecera Retry-After
3. Utiliza un punto de conexión dedicado para un rendimiento de inferencia ilimitado

Link to this sectionFAQ#

Link to this section¿Cuántas claves puedo crear?#

No existe un límite estricto para las claves API. Crea tantas como necesites para diferentes aplicaciones y entornos.

Link to this section¿Caducan las claves?#

Las claves no caducan automáticamente. Permanecen válidas hasta que se revocan. Considera implementar la rotación por seguridad.

Link to this section¿Puedo ver mi clave después de crearla?#

Sí, los valores completos de las claves son visibles en la lista de claves en Settings > API Keys. La plataforma descifra y muestra tus claves para que puedas copiarlas en cualquier momento.

Link to this section¿Las claves son específicas de una región?#

Las claves funcionan en todas las regiones, pero solo acceden a los datos de la región de tu cuenta.

Link to this section¿Puedo compartir las claves con los miembros del equipo?#

Mejor práctica: haz que cada miembro del equipo cree su propia clave. Para los espacios de trabajo de equipo, cada miembro con rol de Editor o superior puede crear claves limitadas a ese espacio de trabajo.