Link to this sectionEndpoint dedicati#

Ultralytics Platform ti consente di distribuire modelli YOLO su endpoint dedicati in 43 regioni globali. Ogni endpoint è un servizio a tenant singolo con comportamento di scale-to-zero, un URL univoco e monitoraggio indipendente.

Link to this sectionCrea Endpoint#

Link to this sectionDalla scheda Deploy#

Distribuisci un modello dalla sua scheda Deploy:

1. Vai al tuo modello
2. Fai clic sulla scheda Deploy
3. Seleziona una regione dalla mappa interattiva del mondo: le regioni sono codificate a colori in base alla latenza dalla tua posizione su un gradiente da verde a rosso (le regioni più veloci sono più verdi, quelle più lente sono più rosse)
4. Fai clic su Deploy nella riga della regione

Il nome della distribuzione viene generato automaticamente dal nome del modello e dalla città della regione (ad esempio, yolo26n-iowa).

Link to this sectionDalla pagina Deployments#

Crea una distribuzione dalla pagina globale Deploy nella barra laterale:

1. Fai clic su New Deployment
2. Seleziona un modello dal selettore di modelli
3. Seleziona una regione dalla mappa o dalla tabella
4. Rivedi il nome della distribuzione generato automaticamente (modificabile) e le risorse predefinite
5. Fai clic su Deploy Model

Link to this sectionCiclo di vita della distribuzione#

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 sectionSelezione Regione#

Scegli tra 43 regioni in tutto il mondo. La mappa interattiva delle regioni e la tabella mostrano:

• Pin delle regioni: codificati a colori per latenza su un gradiente da verde a rosso (le regioni più veloci sono più verdi, quelle più lente sono più rosse)
• Regioni distribuite: evidenziate con un badge "Deployed"
• Regioni in fase di distribuzione: indicatore pulsante animato
• Evidenziazione bidirezionale: passando il mouse sulla mappa viene evidenziata la riga della tabella e viceversa

La tabella delle regioni nella scheda Deploy del modello include:

Link to this sectionRegioni disponibili#

Link to this sectionConfigurazione endpoint#

Link to this sectionFinestra di dialogo New Deployment#

La finestra di dialogo New Deployment fornisce:

Le distribuzioni utilizzano impostazioni predefinite fisse di 1 CPU, 2 GiB di memoria, minInstances = 0 e maxInstances = 1. Si ridimensionano a zero quando sono inattive, quindi paghi solo per il tempo di inferenza attivo.

Link to this sectionScheda Distribuisci (Distribuzione rapida)#

Quando effettui la distribuzione dalla scheda Deploy del modello, gli endpoint vengono creati con risorse predefinite (1 CPU, 2 GB di memoria) con il ridimensionamento a zero abilitato. Il nome della distribuzione viene generato automaticamente.

Link to this sectionGestisci endpoint#

Link to this sectionModalità di visualizzazione#

L'elenco delle distribuzioni supporta tre modalità di visualizzazione:

Link to this sectionScheda distribuzione (Vista schede)#

Ogni scheda di distribuzione nella vista a schede mostra:

• Intestazione: Nome, bandiera della regione, badge di stato, pulsanti di avvio/arresto/eliminazione
• URL endpoint: URL copiabile con link alla documentazione dell'API
• Metriche: Conteggio richieste (24 ore), latenza P95, tasso di errore
• Controllo integrità: Indicatore di stato live con latenza e aggiornamento manuale
• Schede: Logs, Code e Predict

La scheda Logs mostra le voci di log recenti con filtro di gravità (Tutti / Errori). La scheda Code mostra esempi di codice pronti all'uso in Python, JavaScript e cURL con il tuo URL dell'endpoint effettivo e la chiave API. La scheda Predict fornisce un pannello di predizione integrato per i test direttamente sulla distribuzione.

Link to this sectionStati della distribuzione#

Link to this sectionURL endpoint#

Ogni endpoint ha un URL univoco, ad esempio:

Fai clic sul pulsante di copia per copiare l'URL. Fai clic sull'icona della documentazione per visualizzare la documentazione API generata automaticamente per l'endpoint.

Link to this sectionGestione del ciclo di vita#

Controlla lo stato del tuo 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 sectionArresta endpoint#

Arresta un endpoint per sospendere la fatturazione:

1. Fai clic sull'icona di pausa sulla scheda di distribuzione
2. Lo stato dell'endpoint cambia in "Arresto in corso" e poi in "Arrestato"

Endpoint arrestati:

• Non accettano richieste
• Non comportano costi
• Possono essere riavviati in qualsiasi momento

Link to this sectionElimina endpoint#

Rimuovi permanentemente un endpoint:

1. Fai clic sull'icona di eliminazione (cestino) sulla scheda di distribuzione
2. Conferma l'eliminazione nella finestra di dialogo

Link to this sectionUtilizzo degli endpoint#

Link to this sectionAutenticazione#

Ogni distribuzione viene creata con una chiave API dal tuo account. Includila nelle richieste:

Authorization: Bearer YOUR_API_KEY

Il prefisso della chiave API viene visualizzato nel piè di pagina della scheda di distribuzione per l'identificazione. Genera le chiavi da API Keys.

Link to this sectionNessun limite di frequenza#

Le richieste inviate direttamente all'URL del tuo endpoint dedicato non sono soggette ai limiti di velocità della Platform API: il throughput è limitato solo dalla configurazione di CPU, memoria e scalabilità del tuo endpoint. (Le richieste inoltrate tramite la Platform API, come quelle del tester nel browser, utilizzano comunque il limite standard di 20 richieste/min per la predizione). Questo è un vantaggio chiave rispetto all'inferenza condivisa, che è limitata a 20 richieste/min per chiave API.

Link to this sectionEsempio di richiesta#

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 sectionParametri della richiesta#

Link to this sectionFormato risposta#

Uguale all'inferenza condivisa con campi specifici per il task.

Link to this sectionPrezzi#

Gli endpoint dedicati di base sono gratuiti su tutti i piani. Le configurazioni con risorse superiori (più vCPU, più memoria, avvio a caldo) offriranno in futuro prezzi basati sull'utilizzo.

Link to this sectionFAQ#

Link to this sectionQuanti endpoint posso creare?#

I limiti degli endpoint dipendono dal piano:

• Free: Fino a 3 deployment
• Pro: Fino a 10 deployment
• Enterprise: Deployment illimitati

Ogni modello può comunque essere distribuito in più regioni entro la quota del tuo piano.

Link to this sectionPosso cambiare regione dopo il deployment?#

No, le regioni sono fisse. Per cambiare regione:

1. Elimina l'endpoint esistente
2. Crea un nuovo endpoint nella regione desiderata

Link to this sectionCome gestisco il deployment multi-regione?#

Per una copertura globale:

1. Esegui il deployment in più regioni
2. Usa un bilanciatore di carico o il routing DNS
3. Indirizza gli utenti verso l'endpoint più vicino

Link to this sectionQual è il tempo di cold start?#

Il tempo di cold start dipende dalle dimensioni del modello e dal fatto che il container sia già memorizzato nella cache della regione. Intervalli tipici:

Il controllo dello stato utilizza un timeout di 55 secondi per gestire i casi peggiori di cold start.

Link to this sectionPosso usare domini personalizzati?#

I domini personalizzati arriveranno presto. Attualmente, gli endpoint utilizzano URL generati dalla piattaforma.