Link to this sectionPuntos de conexión dedicados#

Ultralytics Platform permite el despliegue de modelos YOLO en endpoints dedicados en 43 regiones globales. Cada endpoint es un servicio de inquilino único con comportamiento de escalado a cero, una URL de endpoint única y supervisión independiente.

Link to this sectionCrear endpoint#

Link to this sectionDesde la pestaña de despliegue#

Despliega un modelo desde su pestaña Deploy:

1. Navega hasta tu modelo
2. Haz clic en la pestaña Deploy
3. Selecciona una región en el mapa interactivo del mundo; las regiones están codificadas por colores según la latencia desde tu ubicación en un degradado de verde a rojo (las regiones más rápidas son más verdes, las regiones más lentas son más rojas)
4. Haz clic en Deploy en la fila de la región

El nombre del despliegue se genera automáticamente a partir del nombre del modelo y la ciudad de la región (p. ej., yolo26n-iowa).

Link to this sectionDesde la página de despliegues#

Crea un despliegue desde la página global Deploy en la barra lateral:

1. Haz clic en New Deployment
2. Selecciona un modelo desde el selector de modelos
3. Selecciona una región desde el mapa o la tabla
4. Revisa el nombre del despliegue generado automáticamente (editable) y los recursos predeterminados
5. Haz clic en Deploy Model

Link to this sectionCiclo de vida del despliegue#

stateDiagram-v2
    [*] --> Creating: Deploy
    Creating --> Deploying: Container starting
    Deploying --> Ready: Health check passed
    Ready --> Stopping: Stop
    Stopping --> Stopped: Stopped
    Stopped --> Ready: Start
    Ready --> [*]: Delete
    Stopped --> [*]: Delete
    Creating --> Failed: Error
    Deploying --> Failed: Error
    Failed --> [*]: Delete

Link to this sectionSelección de región#

Elige entre 43 regiones en todo el mundo. El mapa interactivo de regiones y la tabla muestran:

• Marcadores de región: Codificados por colores según la latencia en un degradado de verde a rojo (las regiones más rápidas son más verdes, las más lentas son más rojas)
• Regiones desplegadas: Resaltadas con una insignia de "Deployed"
• Regiones en despliegue: Indicador de pulso animado
• Resaltado bidireccional: Pasar el cursor sobre el mapa resalta la fila de la tabla y viceversa

La tabla de regiones en la pestaña Deploy del modelo incluye:

Link to this sectionRegiones disponibles#

Link to this sectionConfiguración del Endpoint#

Link to this sectionDiálogo de nuevo despliegue#

El cuadro de diálogo New Deployment ofrece:

Las implementaciones utilizan valores predeterminados fijos de 1 CPU, 2 GiB de memoria, minInstances = 0 y maxInstances = 1. Se reducen a cero cuando están inactivas, por lo que solo pagas por el tiempo de inferencia activo.

Link to this sectionPestaña Deploy (Implementación rápida)#

Al implementar desde la pestaña Deploy del modelo, los endpoints se crean con recursos predeterminados (1 CPU, 2 GB de memoria) con la función de escala a cero activada. El nombre de la implementación se genera automáticamente.

Link to this sectionGestionar endpoints#

Link to this sectionModos de visualización#

La lista de implementaciones admite tres modos de visualización:

Link to this sectionTarjeta de implementación (Vista de tarjetas)#

Cada tarjeta de implementación en la vista de tarjetas muestra:

• Encabezado: Nombre, bandera de la región, distintivo de estado, botones de iniciar/detener/eliminar
• URL del endpoint: URL que se puede copiar con enlace a la documentación de la API
• Métricas: Número de solicitudes (24h), latencia P95, tasa de errores
• Verificación de estado: Indicador de estado en tiempo real con latencia y actualización manual
• Pestañas: Logs, Code y Predict

La pestaña Logs muestra las entradas de registro recientes con filtrado por gravedad (Todos / Errores). La pestaña Code muestra ejemplos de código listos para usar en Python, JavaScript y cURL con tu URL de endpoint real y tu clave de API. La pestaña Predict proporciona un panel de predicción integrado para realizar pruebas directamente en la implementación.

Link to this sectionEstados de implementación#

Link to this sectionURL del endpoint#

Cada endpoint tiene una URL única, por ejemplo:

Haz clic en el botón de copiar para copiar la URL. Haz clic en el icono de documentación para ver la documentación de la API generada automáticamente para el endpoint.

Link to this sectionGestión del ciclo de vida#

Controla el estado de tu endpoint:

graph LR
    R[Ready] -->|Stop| S[Stopped]
    S -->|Start| R
    R -->|Delete| D[Deleted]
    S -->|Delete| D

    style R fill:#4CAF50,color:#fff
    style S fill:#9E9E9E,color:#fff
    style D fill:#F44336,color:#fff

Link to this sectionDetener endpoint#

Detén un endpoint para pausar la facturación:

1. Haz clic en el icono de pausa en la tarjeta de implementación
2. El estado del endpoint cambia a "Deteniendo" y luego a "Detenido"

Endpoints detenidos:

• No aceptan solicitudes
• No generan cargos
• Se pueden reiniciar en cualquier momento

Link to this sectionEliminar endpoint#

Elimina permanentemente un endpoint:

1. Haz clic en el icono de eliminar (papelera) en la tarjeta de implementación
2. Confirma la eliminación en el cuadro de diálogo

Link to this sectionUso de endpoints#

Link to this sectionAutenticación#

Cada implementación se crea con una clave de API de tu cuenta. Inclúyela en las solicitudes:

Authorization: Bearer YOUR_API_KEY

El prefijo de la clave de API se muestra en el pie de página de la tarjeta de implementación para su identificación. Genera claves desde API Keys.

Link to this sectionSin límites de velocidad#

Las solicitudes enviadas directamente a la URL de tu endpoint dedicado no están sujetas a los límites de velocidad de la Platform API; el rendimiento está limitado únicamente por la configuración de CPU, memoria y escalado de tu endpoint. (Las solicitudes enviadas a través de la Platform API, como el probador en el navegador, siguen utilizando el límite estándar de 20 solicitudes/min para predicciones). Esta es una ventaja clave frente a la shared inference, que tiene un límite de velocidad de 20 solicitudes/min por cada clave de API.

Link to this sectionEjemplo de solicitud#

import requests

# Deployment endpoint
url = "https://predict-abc123.run.app/predict"

# Headers with your deployment API key
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# Inference parameters
data = {"conf": 0.25, "iou": 0.7, "imgsz": 640}

# Send image for inference
with open("image.jpg", "rb") as f:
    response = requests.post(url, headers=headers, data=data, files={"file": f})

print(response.json())

Link to this sectionParámetros de petición#

Link to this sectionFormato de respuesta#

Igual que en la inferencia compartida con campos específicos de la tarea.

Link to this sectionPrecios#

Los endpoints dedicados básicos son gratuitos en todos los planes. Las configuraciones de mayores recursos (más vCPUs, más memoria, arranque en caliente) ofrecerán precios basados en el uso en el futuro.

Link to this sectionFAQ#

Link to this section¿Cuántos endpoints puedo crear?#

Los límites de los endpoints dependen del plan:

• Free: Hasta 3 despliegues
• Pro: Hasta 10 despliegues
• Enterprise: Despliegues ilimitados

Cada modelo puede seguir desplegándose en múltiples regiones dentro de la cuota de tu plan.

Link to this section¿Puedo cambiar la región después del despliegue?#

No, las regiones son fijas. Para cambiar de región:

1. Elimina el endpoint existente
2. Crea un nuevo endpoint en la región deseada

Link to this section¿Cómo gestiono el despliegue en varias regiones?#

Para una cobertura global:

1. Despliega en múltiples regiones
2. Utiliza un balanceador de carga o enrutamiento DNS
3. Dirige a los usuarios al endpoint más cercano

Link to this section¿Cuál es el tiempo de arranque en frío?#

El tiempo de arranque en frío depende del tamaño del modelo y de si el contenedor ya está almacenado en caché en la región. Rangos típicos:

La comprobación de estado utiliza un tiempo de espera de 55 segundos para adaptarse a los peores casos de arranque en frío.

Link to this section¿Puedo utilizar dominios personalizados?#

Los dominios personalizados estarán disponibles próximamente. Actualmente, los endpoints utilizan URLs generadas por la plataforma.