Endpoints Dedicados

A Ultralytics Platform permite a implementação de modelos YOLO em endpoints dedicados em 43 regiões globais. Cada endpoint é um serviço de locatário único com comportamento de escala para zero, um URL de endpoint exclusivo e monitoramento independente.

Criar Endpoint

A partir da Guia de Implementação

Implemente um modelo a partir da sua guia Deploy:

1. Navega para o teu modelo
2. Clique na guia Deploy
3. Selecione uma região no mapa-múndi interativo — as regiões são codificadas por cores de acordo com a latência a partir da sua localização (verde < 100ms, amarelo < 200ms, vermelho > 200ms)
4. Clique em Deploy na linha da região

O nome da implementação é gerado automaticamente a partir do nome do modelo e da cidade da região (por exemplo, yolo26n-iowa).

A partir da Página de Implementações

Crie uma implementação a partir da página global Deploy na barra lateral:

1. Clique em New Deployment
2. Selecione um modelo no seletor de modelos
3. Selecione uma região no mapa ou na tabela
4. Revise o nome da implementação gerado automaticamente (editável) e os recursos padrão
5. Clique em Deploy Model

Ciclo de Vida de Implementação

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

Seleção de Região

Escolha entre 43 regiões em todo o mundo. O mapa e a tabela de regiões interativos mostram:

• Pinos de região: Codificados por cores por latência (verde < 100ms, amarelo < 200ms, vermelho > 200ms)
• Regiões implementadas: Destacadas com um emblema "Deployed"
• Regiões em implementação: Indicador de pulsação animado
• Destaque bidirecional: Passar o mouse sobre o mapa destaca a linha da tabela, e vice-versa

A tabela de regiões na guia Deploy do modelo inclui:

Regiões Disponíveis

Configuração de Endpoint

Caixa de Diálogo de Nova Implementação

A caixa de diálogo New Deployment fornece:

As implantações usam padrões fixos de 1 CPU, 2 GiB de memória, minInstances = 0 e maxInstances = 1. Elas reduzem a escala para zero quando inativas, para que você pague apenas pelo tempo de inferência ativo.

Aba Implantação (Implantação Rápida)

Ao implantar a partir da aba Deploy do modelo, os endpoints são criados com recursos padrão (1 CPU, 2 GB de memória) com a redução de escala para zero ativada. O nome da implantação é gerado automaticamente.

Gerenciar Endpoints

Modos de visualização

A lista de implantações suporta três modos de visualização:

Cartão de Implantação (Visualização de Cartões)

Cada cartão de implantação na visualização de cartões mostra:

• Cabeçalho: Nome, bandeira da região, selo de status, botões de iniciar/parar/excluir
• URL do Endpoint: URL copiável com link para a documentação da API
• Métricas: Contagem de solicitações (24h), latência P95, taxa de erro
• Verificação de integridade: Indicador de integridade ao vivo com latência e atualização manual
• Abas: Logs, Code e Predict

A aba Logs mostra entradas de log recentes com filtragem de gravidade (Tudo / Erros). A aba Code mostra exemplos de código prontos para uso em Python, JavaScript e cURL com a sua URL de endpoint e chave de API reais. A aba Predict fornece um painel de predição embutido para testes diretamente na implantação.

Status de Implantação

URL do Endpoint

Cada endpoint possui uma URL exclusiva, por exemplo:

Clique no botão de copiar para copiar a URL. Clique no ícone de documentos para visualizar a documentação da API gerada automaticamente para o endpoint.

Gerenciamento de Ciclo de Vida

Controle o estado do seu 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

Parar Endpoint

Pare um endpoint para pausar a cobrança:

1. Clique no ícone de pausa no cartão de implantação
2. O status do endpoint muda para "Parando" e, em seguida, para "Parado"

Endpoints parados:

• Não aceitam solicitações
• Não geram cobranças
• Podem ser reiniciados a qualquer momento

Excluir Endpoint

Remover permanentemente um endpoint:

1. Clique no ícone de exclusão (lixeira) no cartão de implantação
2. Confirme a exclusão na caixa de diálogo

Usando Endpoints

Autenticação

Cada implantação é criada com uma chave de API da sua conta. Inclua-a nas solicitações:

Authorization: Bearer YOUR_API_KEY

O prefixo da chave de API é exibido no rodapé do cartão de implantação para identificação. Gere chaves a partir de API Keys.

Sem Limites de Taxa

Endpoints dedicados não estão sujeitos aos limites de taxa da API da Platform. As requisições vão diretamente para o teu serviço dedicado, portanto, o throughput é limitado apenas pela CPU, memória e configuração de escalonamento do teu endpoint. Esta é uma vantagem fundamental em relação à inferência compartilhada, que tem uma taxa limitada a 20 requisições/min por chave de API.

Exemplo de Requisição

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())

Parâmetros de Requisição

Formato de Resposta

O mesmo que na inferência compartilhada com campos específicos da tarefa.

Preços

Endpoints dedicados básicos são gratuitos em todos os planos. Configurações de maior recurso (mais vCPUs, mais memória, inicialização a quente) oferecerão preços baseados em uso no futuro.

FAQ

Quantos endpoints posso criar?

Os limites de endpoint dependem do plano:

• Free: Até 3 implantações
• Pro: Até 10 implantações
• Enterprise: Implantações ilimitadas

Cada modelo ainda pode ser implantado em várias regiões dentro da cota do teu plano.

Posso alterar a região após a implantação?

Não, as regiões são fixas. Para alterar regiões:

1. Elimina o endpoint existente
2. Cria um novo endpoint na região desejada

Como lidar com a implantação em várias regiões?

Para cobertura global:

1. Implantar em várias regiões
2. Usar um balanceador de carga ou roteamento DNS
3. Encaminhar utilizadores para o endpoint mais próximo

Qual é o tempo de cold start?

O tempo de cold start depende do tamanho do modelo e se o container já está em cache na região. Intervalos típicos:

A verificação de integridade utiliza um timeout de 55 segundos para acomodar os piores casos de cold start.

Posso usar domínios personalizados?

Domínios personalizados estarão disponíveis em breve. Atualmente, os endpoints usam URLs geradas pela plataforma.