Endpoints Dedicados

Ultralytics permite a implementação de YOLO em terminais dedicados em 43 regiões globais. Cada terminal é um serviço de locatário único com autoescala, um URL de terminal exclusivo e monitoramento independente.

Criar Endpoint

Na guia Implantação

Implemente um modelo a partir do seu Deploy tab:

1. Navegue até o seu modelo
2. Clique na aba Implantar
3. Selecione uma região na tabela de regiões (classificadas por latência a partir da sua localização)
4. Clique em Implementar 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, yolo11n-iowa).

Na página Implantações

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

1. Clique em Nova implementação
2. Selecione um modelo no seletor de modelos
3. Selecione uma região no mapa ou na tabela
4. Opcionalmente, personalize o nome da implementação e os recursos
5. Clique em Implantar modelo

Ciclo de vida da 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 interativo da região e a tabela mostram:

• Region pins: Color-coded by latency (green < 100ms, yellow < 200ms, red > 200ms)
• Regiões implementadas: destacadas com um selo «Implementado»
• Regiões de implantação: Indicador de pulso animado
• Destaque bidirecional: passar o cursor sobre o mapa destaca a linha da tabela e vice-versa.

A tabela de regiões no modelo Deploy A guia inclui:

Regiões Disponíveis

Configuração do Endpoint

Caixa de diálogo Nova implementação

O New Deployment O diálogo fornece:

As definições de recursos estão disponíveis na secção Recursos, que pode ser recolhida. As implementações utilizam a escala para zero por predefinição (instâncias mínimas = 0, instâncias máximas = 1) — só paga pelo tempo de inferência ativo.

Guia Implantação (Implantação rápida)

Ao implementar a partir do modelo Deploy Na guia, os pontos finais são criados com recursos padrão (1 CPU, 2 GB de memória) com a escala para zero ativada. O nome da implementação é gerado automaticamente.

Gerenciar Endpoints

Modos de visualização

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

Cartão de implementação (visualização de cartões)

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

• Cabeçalho: Nome, bandeira da região, emblema de estado, botões iniciar/parar/eliminar
• URL do ponto final: URL copiável com link para a documentação da API
• Métricas: Número de solicitações (24 horas), latência P95, taxa de erros
• Verificação de saúde: Indicador de saúde em tempo real com latência e atualização manual
• Abas: Logs, Code, e Predict

O Logs A guia exibe entradas recentes do registo com filtragem por gravidade (Todas / Erros). A Code A guia mostra exemplos de código prontos para uso em Python, JavaScript e cURL com o URL do seu endpoint real e a chave da API. O Predict A guia fornece um painel de previsão embutido para testes diretamente na implementação.

Estados de implementação

URL do Endpoint

Cada ponto final tem um URL exclusivo, por exemplo:

https://predict-abc123.run.app

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

Gerenciamento do 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 implementação
2. O estado do terminal muda para «A parar» e, em seguida, para «Parado».

Endpoints parados:

• Não aceitam requisições
• Não geram cobranças
• Pode ser reiniciado a qualquer momento

Excluir Endpoint

Remover permanentemente um endpoint:

1. Clique no ícone de eliminação (lixo) no cartão de implementação.
2. Confirme a eliminação na caixa de diálogo

Utilizando Endpoints

Autenticação

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

Authorization: Bearer YOUR_API_KEY

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

Sem limites de taxa

Os pontos finais dedicados não estão sujeitos aos limites de taxa da API da plataforma. As solicitações vão diretamente para o seu serviço dedicado, portanto, a taxa de transferência é limitada apenas pela CPU, memória e configuração de dimensionamento do seu ponto final. Essa é uma vantagem importante em relação à inferência partilhada, que tem uma taxa limitada a 20 solicitações/minuto por chave 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())

// Build form data with image and parameters
const formData = new FormData();
formData.append("file", fileInput.files[0]);
formData.append("conf", "0.25");
formData.append("iou", "0.7");
formData.append("imgsz", "640");

// Send image for inference
const response = await fetch(
  "https://predict-abc123.run.app/predict",
  {
    method: "POST",
    headers: { Authorization: "Bearer YOUR_API_KEY" },
    body: formData,
  }
);

const result = await response.json();
console.log(result);

curl -X POST \
  "https://predict-abc123.run.app/predict" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@image.jpg" \
  -F "conf=0.25" \
  -F "iou=0.7" \
  -F "imgsz=640"

Parâmetros da solicitação

Formato da Resposta

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

Preços

Endpoints dedicados são cobrados com base em:

FAQ

Quantos endpoints posso criar?

Os limites dos terminais dependem do plano:

• Gratuito: até 3 implementações
• Prós: Até 10 implementações
• Empresa: Implementações ilimitadas

Cada modelo ainda pode ser implementado em várias regiões dentro da sua quota do plano.

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

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

1. Exclua o endpoint existente
2. Crie um novo endpoint na região desejada

Como gerencio a implantação multi-região?

Para cobertura global:

1. Implante em várias regiões
2. Use um balanceador de carga ou roteamento DNS
3. Encaminhe os usuários para o endpoint mais próximo

Qual é o tempo de inicialização a frio?

O tempo de inicialização a frio depende do tamanho do modelo e se o contentor já está armazenado em cache na região. Intervalos típicos:

A verificação de integridade usa um tempo limite de 55 segundos para acomodar as piores situações de inicialização a frio.

Posso usar domínios personalizados?

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

📅 Criado há 1 mês ✏️ Atualizado há 4 dias

Comentários