Como posso otimizar manualmente os modelos de IA do ZED SDK?

Last updated: October 22, 2026

O ZED SDK fornece modelos de IA para estimativa de profundidade (modos de profundidade NEURAL LIGHT, NEURAL e NEURAL PLUS), Detecção e Rastreamento de Objetos e Detecção e Rastreamento do Corpo Humano (rastreamento do esqueleto).

Os modelos de IA não estão incluídos no instalador do ZED SDK devido ao seu tamanho, mas podem ser baixados de nossos servidores durante a instalação e otimizados para a GPU disponível no dispositivo host.

Se você decidir não baixar e otimizar os modelos de IA durante a instalação do ZED SDK, o processo será realizado automaticamente pelo ZED SDK na primeira vez que o modelo de IA necessário for usado.

Há situações em que os modelos de IA precisam ser limpos e otimizados manualmente:

a GPU do dispositivo host foi substituída;
o ZED SDK foi atualizado para uma nova versão;
o processo de download falhou por motivos inesperados (por exemplo, queda de energia, interrupção da conexão com a internet etc.);
o processo de otimização foi interrompido por motivos inesperados;
comportamento inesperado do processamento do ZED SDK (por exemplo, mapa de profundidade incorreto nos modos de profundidade NEURAL, detecções de objetos incorretas, detecção incorreta do esqueleto etc.).

Observação: todas as operações descritas abaixo também podem ser realizadas pela interface gráfica da ferramenta ZED Diagnostics, clicando no botão AI MODELS, disponível após a conclusão de um teste de diagnóstico. Consulte a Documentação do ZED Diagnostics. Em dispositivos sem monitor (por exemplo, NVIDIA® Jetson™ sem uma tela), adicione a opção -c para executar a ferramenta no modo de linha de comando.

Como executar os comandos

Abra um console de shell e execute a ferramenta com a opção descrita na tabela abaixo.

Linux / NVIDIA® Jetson™ (a pasta atual não é relevante):
```
ZED_Diagnostic <option>
```
Windows (Prompt de Comando ou PowerShell):
```
cd "C:\Program Files (x86)\ZED SDK\tools"
& ".\ZED Diagnostic.exe" <option>
```
No Prompt de Comando (cmd.exe), omita o & inicial: "ZED Diagnostic.exe" <option>

Substitua <option> por uma das seguintes opções:

Opção	Operação
`-aic`	Limpar (remover) todos os modelos de IA baixados e otimizados; útil para liberar espaço em disco ou redefinir as otimizações caso algo não esteja funcionando corretamente
`-nrlo_light`	Baixar e otimizar o modelo de profundidade NEURAL LIGHT
`-nrlo`	Baixar e otimizar o modelo de profundidade NEURAL
`-nrlo_plus`	Baixar e otimizar o modelo de profundidade NEURAL PLUS
`-nrlo_all`	Baixar e otimizar todos os modelos de profundidade baseados em IA
`-ais X`	Baixar e otimizar um único modelo de IA (consulte a lista abaixo)
`-aid`	Baixar todos os modelos de IA sem otimizá-los (útil para preparar uma implantação offline; a otimização é realizada posteriormente no dispositivo de destino)
`-aio`	Baixar e otimizar todos os modelos de IA em uma única etapa (isso pode levar algum tempo)

Baixar e otimizar um único modelo de IA

Com a opção -ais X, substitua "X" por um número inteiro de acordo com o enum sl::AI_MODELS:

0 - MULTI_CLASS_DETECTION: relacionado a sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_FAST
1 - MULTI_CLASS_MEDIUM_DETECTION: relacionado a sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_MEDIUM
2 - MULTI_CLASS_ACCURATE_DETECTION: relacionado a sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_ACCURATE
3 - HUMAN_BODY_FAST_DETECTION: relacionado a sl::BODY_TRACKING_MODEL::HUMAN_BODY_FAST
4 - HUMAN_BODY_MEDIUM_DETECTION: relacionado a sl::BODY_TRACKING_MODEL::HUMAN_BODY_MEDIUM
5 - HUMAN_BODY_ACCURATE_DETECTION: relacionado a sl::BODY_TRACKING_MODEL::HUMAN_BODY_ACCURATE
6 - HUMAN_BODY_38_FAST_DETECTION: relacionado a sl::BODY_TRACKING_MODEL::HUMAN_BODY_FAST com sl::BODY_FORMAT::BODY_38
7 - HUMAN_BODY_38_MEDIUM_DETECTION: relacionado a sl::BODY_TRACKING_MODEL::HUMAN_BODY_MEDIUM com sl::BODY_FORMAT::BODY_38
8 - HUMAN_BODY_38_ACCURATE_DETECTION: relacionado a sl::BODY_TRACKING_MODEL::HUMAN_BODY_ACCURATE com sl::BODY_FORMAT::BODY_38
9 - PERSON_HEAD_DETECTION: relacionado a sl::OBJECT_DETECTION_MODEL::PERSON_HEAD_BOX_FAST
10 - PERSON_HEAD_ACCURATE_DETECTION: relacionado a sl::OBJECT_DETECTION_MODEL::PERSON_HEAD_BOX_ACCURATE
11 - REID_ASSOCIATION: relacionado a sl::BatchParameters::enable
12 - NEURAL_LIGHT_DEPTH: relacionado a sl::DEPTH_MODE::NEURAL_LIGHT
13 - NEURAL_DEPTH: relacionado a sl::DEPTH_MODE::NEURAL
14 - NEURAL_PLUS_DEPTH: relacionado a sl::DEPTH_MODE::NEURAL_PLUS

Observação: os IDs numéricos seguem a ordem do enum sl::AI_MODELS e podem mudar entre versões principais do ZED SDK. Sempre verifique a lista correspondente à versão instalada do ZED SDK executando a ferramenta com a flag -h.

Para obter mais informações sobre todos os comandos disponíveis do ZED Diagnostics, use a flag -h ou consulte a Documentação do ZED Diagnostics.