Link to this sectionChaves de API#

As chaves de API da Ultralytics Platform permitem acesso programático seguro para treinamento remoto, inferência e automação. Crie chaves nomeadas com criptografia AES-256-GCM para diferentes casos de uso.

Link to this sectionCriar chave de API#

Crie uma nova chave de API:

1. Vá para Settings > API Keys
2. Clique em Create Key
3. Insira um nome para a chave (por exemplo, "Servidor de Treinamento")
4. Clique em Create Key

Link to this sectionNome da Chave#

Dê à sua chave um nome descritivo:

• training-server - Para máquinas de treinamento remoto
• ci-pipeline - Para integração CI/CD
• local-dev - Para desenvolvimento local

Link to this sectionExibição da Chave#

Após a criação, a chave é exibida apenas uma vez:

Link to this sectionFormato da Chave#

As chaves de API seguem este formato:

• Prefixo: ul_ identifica chaves da Ultralytics
• Corpo: 40 caracteres hexadecimais aleatórios
• Total: 43 caracteres

Link to this sectionSegurança da Chave#

• As chaves são armazenadas com criptografia AES-256-GCM
• A autenticação usa hash SHA-256 para busca rápida de prefixo e comparação de hash
• Valores de chave completos nunca são armazenados em texto simples

Link to this sectionUsando Chaves de API#

Link to this sectionVariável de Ambiente#

Defina sua chave como uma variável de ambiente:

export ULTRALYTICS_API_KEY="YOUR_API_KEY"

Link to this sectionYOLO CLI#

Defina a chave usando a YOLO CLI:

yolo settings api_key="YOUR_API_KEY"

Link to this sectionNo Código#

Use a chave em seus scripts 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 sectionCabeçalhos HTTP#

Inclua a chave nas requisições da API:

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

Veja a REST API Reference para todos os endpoints disponíveis.

Link to this sectionTreinamento Remoto#

Habilite o streaming de métricas com sua chave.

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

Veja Cloud Training para o guia completo de treinamento remoto.

Link to this sectionGerenciar Chaves#

Link to this sectionVisualizar Chaves#

Todas as chaves estão listadas na aba Settings > API Keys:

Cada cartão de chave mostra o nome da chave, o valor da chave descriptografado completo (copiável), o tempo relativo de criação e um botão de revogação.

Link to this sectionRevogar Chave#

Revogue uma chave que esteja comprometida ou que não seja mais necessária:

1. Encontre a chave na seção API Keys
2. Clique no botão Revoke (lixeira)
3. Confirme a revogação

Link to this sectionRegenerar Chave#

Se uma chave estiver comprometida:

1. Crie uma nova chave com o mesmo nome
2. Atualize suas aplicações
3. Revogue a chave antiga

Link to this sectionChaves de API do Workspace#

As chaves de API são delimitadas ao workspace ativo no momento:

• Workspace pessoal: As chaves autenticam como sua conta pessoal
• Workspace de equipe: As chaves autenticam dentro do contexto da equipe

Ao trocar de workspace na barra lateral, a seção API Keys mostra as chaves daquele workspace. É necessária a função de Editor ou superior para gerenciar chaves de API do workspace. Veja Teams para detalhes sobre funções.

Link to this sectionMelhores Práticas de Segurança#

Link to this sectionO que fazer#

• Armazene chaves em variáveis de ambiente
• Use chaves separadas para ambientes diferentes
• Revogue chaves não utilizadas prontamente
• Rotacione chaves periodicamente
• Use nomes descritivos para identificar os propósitos das chaves

Link to this sectionO que não fazer#

• Não envie chaves para controle de versão
• Não compartilhe chaves entre aplicações
• Não registre chaves na saída da aplicação
• Não incorpore chaves no código do lado do cliente

Link to this sectionRotação de Chaves#

Rotacione as chaves periodicamente por segurança:

1. Crie uma nova chave com o mesmo nome
2. Atualize as aplicações para usar a nova chave
3. Verifique se as aplicações funcionam corretamente
4. Revogue a chave antiga

Link to this sectionSolução de problemas#

Link to this sectionErro de Chave Inválida#

Soluções:

1. Verifique se a chave foi copiada corretamente (incluindo o prefixo ul_)
2. Verifique se a chave não foi revogada
3. Confirme se a variável de ambiente está definida
4. Garanta que você está usando ultralytics>=8.4.60

Link to this sectionPermissão Negada#

Soluções:

1. Verifique se você é o proprietário do recurso ou se possui acesso apropriado ao workspace
2. Verifique se a chave pertence ao workspace correto
3. Crie uma nova chave se necessário

Link to this sectionLimite de Taxa#

Soluções:

1. Reduza a frequência de requisições — veja a rate limit table para limites por endpoint
2. Implemente backoff exponencial usando o cabeçalho Retry-After
3. Use um dedicated endpoint para throughput de inferência ilimitado

Link to this sectionFAQ#

Link to this sectionQuantas chaves posso criar?#

Não há um limite rígido para chaves de API. Crie quantas forem necessárias para diferentes aplicações e ambientes.

Link to this sectionAs chaves expiram?#

As chaves não expiram automaticamente. Elas permanecem válidas até serem revogadas. Considera implementar uma rotação por motivos de segurança.

Link to this sectionPosso ver a minha chave após a criação?#

Sim, os valores completos das chaves são visíveis na lista de chaves em Settings > API Keys. A plataforma desencripta e exibe as tuas chaves para que as possas copiar a qualquer momento.

Link to this sectionAs chaves são específicas por região?#

As chaves funcionam em todas as regiões, mas apenas acedem aos dados da região da tua conta.

Link to this sectionPosso partilhar chaves com membros da equipa?#

Melhor prática: Faz com que cada membro da equipa crie a sua própria chave. Para espaços de trabalho de equipa, cada membro com a função de Editor ou superior pode criar chaves limitadas a esse espaço de trabalho.